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.