Channels: update

Vous pouvez désormais marquer votre chaîne ou vos vidéos comme étant conçues pour les enfants. De plus, les ressources channel et video contiennent désormais une propriété identifiant la chaîne ou la vidéo comme étant conçue pour les enfants. Les conditions d'utilisation des services d'API YouTube et le règlement pour les développeurs ont également été mis à jour le 10 janvier 2020. Pour en savoir plus, consultez l'historique des révisions du service d'API YouTube Data et les Conditions d'utilisation des services d'API YouTube.

Met à jour les métadonnées d'une chaîne. Notez que cette méthode n'est actuellement compatible qu'avec les mises à jour des objets brandingSettings, invideoPromotion et localizations de la ressource channel et de leurs propriétés enfants.

Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.

Cas d'utilisation courants

Requête

Requête HTTP

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

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

Définition du 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 répertoriés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
part string
Le paramètre part a deux finalités 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.

Actuellement, l'API n'autorise que la valeur du paramètre à définir sur brandingSettings, invideoPromotion ou localizations. (Vous ne pouvez mettre à jour qu'une seule de ces parties avec une seule requête.)

Notez que cette méthode remplace les valeurs existantes pour toutes les propriétés modifiables contenues dans la partie spécifiée par la valeur du paramètre.
Paramètres facultatifs
onBehalfOfContentOwner string
Ce paramètre ne peut être utilisé que dans une demande autorisée correctement. Le paramètre onBehalfOfContentOwner indique que l'utilisateur authentifié agit pour le compte du propriétaire de 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 un grand nombre de chaînes YouTube. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leur 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 de canal dans le corps de la requête. Pour cette ressource:

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

    • id

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

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    Si vous envoyez une demande de mise à jour et qu'elle 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

Lorsque cette méthode fonctionne, elle renvoie une ressource de canal 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 de 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) brandingValidationError Échec de la validation de l'une des valeurs de l'objet brandingSettings. Utilisez la méthode channels.list pour récupérer les paramètres existants du canal et mettez à jour les valeurs de propriété en suivant les instructions de la documentation sur les ressources channels.
badRequest (400) channelTitleUpdateForbidden Lorsque vous mettez à jour le brandingSettings part d'une chaîne, vous devez définir la valeur de la propriété brandingSettings.channel.title sur le titre actuel de la chaîne ou omettre la propriété. L'API renvoie une erreur si vous modifiez la valeur de la propriété.
badRequest (400) defaultLanguageNotSetError defaultLanguage doit être défini pour mettre à jour localizations.
badRequest (400) invalidBrandingOption L'un des paramètres de marque que vous avez spécifié n'existe pas. Utilisez la méthode channels.list pour récupérer les valeurs valides et assurez-vous de les mettre à jour en suivant les instructions fournies dans la documentation des ressources channels.
badRequest (400) invalidCustomMessage Les métadonnées de la requête spécifient un message personnalisé non valide. Vérifiez la valeur de la propriété invideoPromotion.items[].customMessage dans la ressource envoyée par la requête.
badRequest (400) invalidDuration Les métadonnées de la requête spécifient une durée non valide dans la partie invideoPromotion.
badRequest (400) invalidDuration Les métadonnées de la requête spécifient un type de position non valide pour déterminer la position de l'élément promu dans le lecteur vidéo. Vérifiez la valeur de la propriété invideoPromotion.position.type dans la ressource envoyée par la requête.
badRequest (400) invalidRecentlyUploadedBy Les métadonnées de la requête spécifient un ID de chaîne non valide. Vérifiez la valeur de la propriété invideoPromotion.items[].id.recentlyUploadedBy dans la ressource envoyée par la requête.
badRequest (400) invalidTimingOffset Les métadonnées de la requête spécifient un décalage temporel non valide dans la partie invideoPromotion.
badRequest (400) invalidTimingOffset Les métadonnées de la demande spécifient un délai non valide pour déterminer le moment où l'élément promu doit être affiché dans le lecteur vidéo. Vérifiez la valeur de la propriété invideoPromotion.timing.offsetMs dans la ressource envoyée par la requête.
badRequest (400) invalidTimingType Les métadonnées de la demande spécifient une méthode de minutage non valide pour déterminer le moment où l'élément promu doit s'afficher dans le lecteur vidéo. Vérifiez la valeur de la propriété invideoPromotion.timing.type dans la ressource envoyée par la requête.
badRequest (400) localizationValidationError La validation de l'une des valeurs de l'objet "localizations" a échoué. Utilisez la méthode channels.list pour récupérer les valeurs valides et assurez-vous de les mettre à jour en suivant les consignes de la documentation sur les ressources de canaux.
badRequest (400) tooManyPromotedItems Le nombre d'éléments sponsorisés autorisés a été dépassé dans la partie invideoPromotion.
forbidden (403) channelForbidden Le canal spécifié dans le paramètre id n'est pas compatible avec la requête, ou celle-ci n'est pas autorisée correctement.
forbidden (403) promotedVideoNotAllowed Le canal que la requête API tente de mettre à jour est introuvable. Vérifiez la valeur de la propriété id dans la ressource channel envoyée par la requête pour vous assurer que l'ID du canal est correct.
forbidden (403) websiteLinkNotAllowed L'URL de site Web spécifiée n'est pas autorisée.
notFound (404) channelNotFound Impossible de trouver la version spécifiée dans le paramètre id.
notFound (404) channelNotFound La chaîne spécifiée par le paramètre id est introuvable ou ne comporte pas d'options de branding.
notFound (404) unknownChannelId L'ID de chaîne spécifié est introuvable.
notFound (404) unknownChannelId L'ID de chaîne récemmentUploadedBy spécifié est introuvable.
notFound (404) unknownVideoId Impossible de trouver l'ID vidéo spécifié comme élément promu.
required (400) requiredItemIdType Les métadonnées de la requête doivent spécifier un type d'élément dans la partie "invideoPromotion".
required (400) requiredItemId Les métadonnées de la requête doivent spécifier un ID d'article dans la partie invideoPromotion.
required (400) requiredTimingOffset Les métadonnées de la demande doivent spécifier un décalage temporel par défaut pour que YouTube puisse déterminer quand afficher l'élément promu. Définissez la valeur de la propriété invideoPromotion.defaultTiming.offsetMs dans la ressource envoyée par la requête.
required (400) requiredTimingOffset Les métadonnées de la demande doivent indiquer un décalage temporel afin que YouTube puisse déterminer quand afficher l'élément promu. Définissez la valeur de la propriété invideoPromotion.timing.offsetMs dans la ressource envoyée par la requête.
required (400) requiredTimingType Les métadonnées de la demande doivent préciser une méthode de synchronisation afin que YouTube puisse déterminer quand afficher l'élément promu. Définissez la valeur de la propriété invideoPromotion.defaultTiming.type dans la ressource envoyée par la requête.
required (400) requiredTimingType Les métadonnées de la demande doivent préciser une méthode de synchronisation afin que YouTube puisse déterminer quand afficher l'élément promu. Définissez la valeur de la propriété invideoPromotion.timing.type dans la ressource envoyée par la requête.
required (400) requiredTiming Les métadonnées de la requête doivent préciser les codes temporels de chaque élément dans la partie invideoPromotion.
required (400) requiredVideoId Les métadonnées de la demande doivent spécifier un ID vidéo pour identifier l'élément promu.
required (400) requiredWebsiteUrl Les métadonnées de la requête doivent spécifier une URL de site Web dans la partie invideoPromotion. Définissez la valeur de la propriété invideoPromotion.items[].id.websiteUrl dans la ressource envoyée par la requête.

Essayer

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