updatePlaylistPermission

Met à jour les accès d'une playlist : groupes attachés et utilisateurs en accès direct.

Arguments

Nom	Type	Description
`id*`	`ID!`	Identifiant unique de la playlist.
`addGroupIds`	`[ID!]`	Groupes personnalisés à attacher au contenu. Seuls les groupes `CUSTOM` du compte sont assignables : un groupe `GLOBAL` couvre déjà tout son scope, il n'a rien à attacher. Un identifiant refusé fait refuser l'appel entier — aucun accès n'est modifié : groupe `GLOBAL` : `INPUT_VALIDATION_ERROR`, une entrée de `fieldErrors` par groupe (`addGroupIds.N` / `removeGroupIds.N`) ; identifiant inconnu ou hors compte : `NOT_FOUND`, le message nomme les identifiants fautifs.
`removeGroupIds`	`[ID!]`	Groupes personnalisés à détacher du contenu. Mêmes règles qu'à l'ajout : un groupe `GLOBAL` n'est pas détachable, et un identifiant refusé annule tout l'appel.
`addUserIds`	`[ID!]`	Utilisateurs à qui accorder un accès direct au contenu.
`removeUserIds`	`[ID!]`	Utilisateurs à qui retirer l'accès direct au contenu.

Utilisation

Chargement...

Réponse

Playlist

Nom	Type	Description
`id`	`ID!`	-
`title`	`String!`	-
`myCapability`	`AuthzCapability!`	Ce que l'appelant a le droit de faire sur ce contenu, compte tenu de ses groupes et de ses accès directs : `NONE` (aucun accès), `READ`, `WRITE` ou `DELETE`. Permet de savoir à l'avance si une mutation aboutira, sans avoir à la tenter.
`contentCount`	`Int`	-
`mediaCount`	`Int`	-
`liveCount`	`Int`	-
`hasUniqueChapterFeed`	`Boolean`	-
`waitingThumbKey`	`String`	-
`waitingThumbCdnUrl`	`String`	-
`rollOption`	`PlaylistRollOption`	-
`note`	`String`	-
`publicUrl`	`String`	-
`publicEmbedUrl`	`String`	-
`accessGroups`	`[Group!]!`	-
`directUsers`	`[PublicUser!]!`	-
`description`	`Json`	-
`createdAt`	`DateTime!`	-
`publisher`	`User!`	-
`account`	`Account`	-
`pageSetting`	`BrandSetting`	-
`embedSetting`	`BrandSetting`	-
`relatedTags`	`[Tag]`	-
`relatedCategories`	`[Category]`	-
`playlistContents`	`PlaylistContentConnection`	Contenus de la playlist, dans l'ordre de lecture (`order` croissant), paginés.
`preRoll`	`RollPreset`	-
`postRoll`	`RollPreset`	-
`seo`	`SEO`	-
`smartSections`	`[WebTVSmartSection]`	-
`confidentiality`	`Confidentiality`	-
`privacy`	`Privacy`	Inscription des spectateurs. `null` tant qu'elle n'a jamais été configurée : le contenu est alors public. Se règle avec `updatePlaylistPrivacy`.
`originalPublisher`	`DeletedUser`	-

Erreurs

Erreurs communes

Code	Message	Description
`UNAUTHENTICATED`	`Invalid or expired API key`	Clé API manquante (`API key required`), ou invalide, expirée ou révoquée (`Invalid or expired API key`). La réponse porte un code HTTP 401 ; la requête n'est pas exécutée.
`API_ADDON_REQUIRED`	`This account does not have the API addon`	La clé est valide mais le compte n'a pas l'option API. La réponse porte un code HTTP 403 ; la requête n'est pas exécutée.
`INPUT_VALIDATION_ERROR`	`Validation failed: {field}: {message}`	Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[]. Tout argument texte qui n'est pas de l'Unicode valide — caractère NUL (`\u0000`) ou surrogate UTF-16 isolé (emoji coupé en deux) — est refusé ici, quel que soit le champ, y compris sur les arguments des champs imbriqués (`playlistContents(cursor:)`…).
`GRAPHQL_VALIDATION_FAILED`	`Query depth limit of 10 exceeded, found {depth}.`	Le document ne respecte pas le schéma : champ ou argument inconnu, valeur écrite en dur dans la requête qui n'a pas le type attendu (valeur d'enum inexistante…), ou limite par requête dépassée (profondeur, coût, alias, directives — voir Rate Limiting). La réponse porte un code HTTP 400 ; rien n'est exécuté.
`BAD_USER_INPUT`	`Variable "$name" got invalid value {value}; {reason}`	Une variable (`variables`) n'a pas le type déclaré dans l'opération, par exemple une valeur d'enum inexistante. C'est la même erreur que GRAPHQL_VALIDATION_FAILED, détectée sur une variable plutôt que sur une valeur écrite dans la requête. La réponse porte un code HTTP 400 ; rien n'est exécuté.
`INTERNAL_SERVER_ERROR`	`Internal server error`	Erreur interne du serveur. Le message est volontairement générique : le détail est journalisé côté Streamfizz, jamais renvoyé.

Erreurs spécifiques

Code	Message	Description
`NOT_FOUND`	`Playlist '{id}' has not been found`	La playlist n'existe pas ou n'appartient pas au compte.
`NOT_FOUND`	`Cannot apply permissions — unknown ids: {ids}`	Un des identifiants de `addGroupIds`, `removeGroupIds`, `addUserIds` ou `removeUserIds` est inconnu ou hors compte ; le message les liste tous. Aucun accès n'est modifié.
`INPUT_VALIDATION_ERROR`	`Validation failed: {field}: Each id may appear only once`	Un même identifiant figure deux fois dans une même liste. `extensions.fieldErrors[].field` nomme la liste fautive.
	`Validation failed: remove{Group\|User}Ids: Cannot add and remove the same id: {ids}`	Un même identifiant figure à la fois dans `addGroupIds` et `removeGroupIds`, ou dans `addUserIds` et `removeUserIds`. L'erreur porte sur la liste de retrait.
	`Validation failed: addGroupIds.{N}: Group '{id}' is a system group and cannot be assigned`	Un groupe système (`GLOBAL`) figure dans `addGroupIds` ou `removeGroupIds` : visible en lecture, il n'est jamais assignable. Une entrée de `extensions.fieldErrors` par groupe, `field` vaut `addGroupIds.N` ou `removeGroupIds.N`. Cette erreur l'emporte quand l'appel contient aussi un identifiant inconnu. Aucun accès n'est modifié.

Rate Limiting

60 requêtes par minute par clé API

En cas de dépassement, une erreur 429 Too Many Requests est retournée.

Page précédenteupdatePlaylistConfidentiality

MUTATION

Page suivanteaddContentToPlaylist