updatePlaylistConfidentiality

Met à jour la confidentialité d'une playlist.

Arguments

Nom	Type	Description
`id*`	`ID!`	Identifiant unique de la playlist.
`type`	`ConfidentialityType`	Type de confidentialité (PUBLIC ou PRIVATE).
`hasPublicPageAvailable`	`Boolean`	Autorise l'accès à la page publique.
`hasRollAvailable`	`Boolean`	Autorise les annonces (rolls) sur le contenu.
`hasEmbedAvailable`	`Boolean`	Autorise l'intégration en iframe (embed).
`embedAllowedDomains`	`[String!]`	Liste des domaines autorisés pour l'intégration embed. Chaque entrée est ramenée à son nom d'hôte avant d'être enregistrée (protocole, `www.`, port et chemin retirés, minuscules) : `https://www.site.com/page` devient `site.com`. Une entrée qui n'est pas un nom d'hôte est refusée.
`isPasswordProtected`	`Boolean`	Active la protection par mot de passe.
`password`	`String`	Mot de passe pour accéder au contenu (requis si isPasswordProtected est true ; un mot de passe fait uniquement d'espaces compte comme absent). Un contenu créé hérite du mot de passe des préférences du compte seulement si ces préférences activent la protection par mot de passe.
`allowPreviewContent`	`Boolean`	Autorise la prévisualisation du contenu avant déverrouillage.
`isIpProtected`	`Boolean`	Active la restriction par adresse IP.
`ips`	`[String!]`	Liste des adresses IP autorisées (requise si isIpProtected est true) : adresses IPv4 ou IPv6 exactes, sans plage CIDR ; les doublons sont ignorés.

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.
`INPUT_VALIDATION_ERROR`	`Validation failed: password: Password is required when isPasswordProtected is true`	La protection par mot de passe serait active sans mot de passe : `isPasswordProtected` passe à `true` sans `password`, ou `password` est vidé (ou ne contient que des espaces) alors que la protection reste active. La règle porte sur l'état résultant, pas sur les seuls arguments reçus.
	`Validation failed: ips: IPs are required when isIpProtected is true`	La protection par IP serait active sans aucune adresse : `isIpProtected` passe à `true` sans `ips`, ou `ips` est vidé alors que la protection reste active.
	`Validation failed: ips.{index}: Invalid IP address: expected an exact IPv4 or IPv6 address`	Une entrée de `ips` n'est pas une adresse IPv4 ou IPv6 exacte (les plages CIDR ne sont pas acceptées). Les doublons, eux, sont simplement ignorés.
	`Validation failed: embedAllowedDomains.{index}: Invalid domain: expected a host name such as example.com`	Une entrée de `embedAllowedDomains` n'est pas un nom d'hôte, même après normalisation (protocole, `www.`, port et chemin retirés, minuscules).

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édenteupdatePlaylistPersonnalisation

MUTATION

Page suivanteupdatePlaylistPermission

MUTATION

Arguments

Nom	Type	Description
`id*`	`ID!`	Identifiant unique de la playlist.
`type`	`ConfidentialityType`	Type de confidentialité (PUBLIC ou PRIVATE).
`hasPublicPageAvailable`	`Boolean`	Autorise l'accès à la page publique.
`hasRollAvailable`	`Boolean`	Autorise les annonces (rolls) sur le contenu.
`hasEmbedAvailable`	`Boolean`	Autorise l'intégration en iframe (embed).
`embedAllowedDomains`	`[String!]`	Liste des domaines autorisés pour l'intégration embed. Chaque entrée est ramenée à son nom d'hôte avant d'être enregistrée (protocole, `www.`, port et chemin retirés, minuscules) : `https://www.site.com/page` devient `site.com`. Une entrée qui n'est pas un nom d'hôte est refusée.
`isPasswordProtected`	`Boolean`	Active la protection par mot de passe.
`password`	`String`	Mot de passe pour accéder au contenu (requis si isPasswordProtected est true ; un mot de passe fait uniquement d'espaces compte comme absent). Un contenu créé hérite du mot de passe des préférences du compte seulement si ces préférences activent la protection par mot de passe.
`allowPreviewContent`	`Boolean`	Autorise la prévisualisation du contenu avant déverrouillage.
`isIpProtected`	`Boolean`	Active la restriction par adresse IP.
`ips`	`[String!]`	Liste des adresses IP autorisées (requise si isIpProtected est true) : adresses IPv4 ou IPv6 exactes, sans plage CIDR ; les doublons sont ignorés.

Réponse

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.
`INPUT_VALIDATION_ERROR`	`Validation failed: password: Password is required when isPasswordProtected is true`	La protection par mot de passe serait active sans mot de passe : `isPasswordProtected` passe à `true` sans `password`, ou `password` est vidé (ou ne contient que des espaces) alors que la protection reste active. La règle porte sur l'état résultant, pas sur les seuls arguments reçus.
	`Validation failed: ips: IPs are required when isIpProtected is true`	La protection par IP serait active sans aucune adresse : `isIpProtected` passe à `true` sans `ips`, ou `ips` est vidé alors que la protection reste active.
	`Validation failed: ips.{index}: Invalid IP address: expected an exact IPv4 or IPv6 address`	Une entrée de `ips` n'est pas une adresse IPv4 ou IPv6 exacte (les plages CIDR ne sont pas acceptées). Les doublons, eux, sont simplement ignorés.
	`Validation failed: embedAllowedDomains.{index}: Invalid domain: expected a host name such as example.com`	Une entrée de `embedAllowedDomains` n'est pas un nom d'hôte, même après normalisation (protocole, `www.`, port et chemin retirés, minuscules).