ChannelSections: insert

Ajoute une section de chaîne à la chaîne de l'utilisateur authentifié. Une chaîne peut créer un maximum de 10 étagères.

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

POST 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 définira, ainsi que celles que la réponse de l'API inclura.

La liste suivante contient les part noms que vous pouvez inclure dans la valeur de 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 exclusivement destiné aux partenaires de contenu YouTube.

Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la requête identifient un utilisateur YouTube CMS 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 de vidéos et de chaînes, 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é.
onBehalfOfContentOwnerChannel string
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Remarque : Ce paramètre est exclusivement destiné aux partenaires de contenu YouTube.

Le paramètre onBehalfOfContentOwnerChannel spécifie l'ID de la chaîne YouTube à laquelle une vidéo est ajoutée. Ce paramètre est obligatoire lorsqu'une requête spécifie une valeur pour le paramètre onBehalfOfContentOwner, et il ne peut être utilisé qu'en association avec ce paramètre. De plus, la requête doit être autorisée à l'aide d'un compte CMS associé au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner. Enfin, la chaîne spécifiée par la valeur du paramètre onBehalfOfContentOwnerChannel doit être associée au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner.

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'effectuer des actions au nom de la chaîne spécifiée dans la valeur de paramètre, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

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[]

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 Impossible de créer cette section de chaîne.
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 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 spécifiait 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 insérez doit contenir un objet contentDetails pour ce type de section de chaîne.
invalidValue (400) inValidPosition La propriété snippet.position contient une valeur non valide.
invalidValue (400) maxChannelSectionExceeded La requête ne peut pas être traitée, car la chaîne a déjà atteint le nombre maximal de sections de chaîne.
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 spécifiait 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 créer 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) 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.