ChannelSections: update

Met à jour une section de chaîne.

Impact sur le quota : un appel à cette méthode coûte 50 unités de quota.

Cas d'utilisation courants

Requête

Requête HTTP

PUT https://www.googleapis.com/youtube/v3/channelSections

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation

Champ d'application
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
part	string Le paramètre part a deux objectifs dans cette opération. Il identifie les propriétés que l'opération d'écriture va définir, ainsi que celles que la réponse de l'API va inclure. La liste suivante contient les part noms que vous pouvez inclure dans la valeur du paramètre : contentDetails id snippet
Paramètres facultatifs
onBehalfOfContentOwner	string Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Remarque : Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube. Le onBehalfOfContentOwner paramètre indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre. Ce paramètre est destiné aux partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes leurs données vidéo et de chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

Corps de la requête

Fournissez une ressource channelSection dans le corps de la requête. Pour cette ressource :

• Vous devez spécifier une valeur pour ces propriétés :

  • snippet.type

• Vous pouvez définir des valeurs pour ces propriétés :

  • snippet.type
  • snippet.title
  • snippet.position
  • contentDetails.playlists[]
  • contentDetails.channels[]

  Si vous envoyez une requête de mise à jour et que votre requête ne spécifie pas de valeur pour une propriété qui en possède déjà une, la valeur existante de la propriété sera supprimée.

Réponse

Si la requête aboutit, cette méthode renvoie une ressource channelSection dans le corps de la réponse.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur	Détails de l'erreur	Description
badRequest (400)	notEditable	Cette section de chaîne ne peut pas être modifiée.
badRequest (400)	typeRequired	La ressource channelSection doit spécifier une valeur pour le champ snippet.type.
forbidden (403)	channelSectionForbidden	La requête n'est pas correctement authentifiée ou n'est pas compatible avec cette chaîne.
invalidValue (400)	channelNotActive	Au moins l'une des chaînes spécifiées n'est pas active.
invalidValue (400)	channelsDuplicated	La requête a échoué, car elle spécifiait des chaînes en double.
invalidValue (400)	channelsNeeded	Si la propriété snippet.type a la valeur multipleChannels, la propriété contentDetails.channels[] doit être spécifiée et doit spécifier au moins une chaîne.
invalidValue (400)	channelsNotExpected	La ressource fournie avec la requête a spécifié une valeur pour la propriété contentDetails.channels[], mais les chaînes ne sont pas attendues pour ce type de section de chaîne.
invalidValue (400)	contentDetailsNeeded	La ressource que vous mettez à jour doit contenir un objet contentDetails pour ce type de section de chaîne.
invalidValue (400)	idInvalid	La propriété id spécifie un ID de section de chaîne non valide.
invalidValue (400)	idRequired	La propriété id doit spécifier une valeur qui identifie la section de chaîne en cours de mise à jour.
invalidValue (400)	inValidPosition	La propriété snippet.position contient une valeur non valide.
invalidValue (400)	maxChannelsExceeded	La requête a échoué, car elle tentait d'inclure trop de chaînes dans la section de chaîne.
invalidValue (400)	maxPlaylistExceeded	La requête a échoué, car elle tentait d'inclure trop de playlists dans la section de chaîne.
invalidValue (400)	onePlaylistNeeded	Si la propriété snippet.type a la valeur singlePlaylist, la propriété contentDetails.playlists[] doit spécifier exactement une playlist.
invalidValue (400)	ownChannelInChannels	Vous ne pouvez pas inclure votre propre chaîne dans une section de chaîne qui apparaît sur cette chaîne.
invalidValue (400)	playlistIsPrivate	Une ou plusieurs des playlists spécifiées sont privées et ne peuvent donc pas être incluses dans la section de chaîne.
invalidValue (400)	playlistsDuplicated	La requête a échoué, car elle spécifiait des playlists en double.
invalidValue (400)	playlistsNeeded	Si la propriété snippet.type a la valeur singlePlaylist ou multiplePlaylists, la propriété contentDetails.playlists[] doit être spécifiée.
invalidValue (400)	playlistsNotExpected	La ressource fournie avec la requête a spécifié une valeur pour la propriété contentDetails.playlists[], mais les playlists ne sont pas attendues pour ce type de section de chaîne.
invalidValue (400)	snippetNeeded	Vous devez spécifier un snippet pour mettre à jour la section de chaîne.
invalidValue (400)	titleLengthExceeded	La valeur de la propriété snippet.title est trop longue.
invalidValue (400)	titleRequired	Si la propriété snippet.type a la valeur multiplePlaylists ou multipleChannels, vous devez définir le titre de la section en spécifiant une valeur pour la propriété snippet.title.
notFound (404)	channelNotFound	Une ou plusieurs des chaînes spécifiées sont introuvables.
notFound (404)	channelSectionNotFound	La section de chaîne que vous essayez de mettre à jour est introuvable.
notFound (404)	playlistNotFound	Une ou plusieurs des playlists spécifiées sont introuvables.

Essayer

Utilisez l'APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.