Channels: update

L'API ora supporta la possibilità di contrassegnare il tuo canale o video come "destinati ai bambini". Inoltre, le risorse channel e video ora contengono anche una proprietà che identifica lo stato "destinato ai bambini" del canale o del video. Anche i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori sono stati aggiornati il 10 gennaio 2020. Per ulteriori informazioni, consulta le cronologie delle revisioni per il servizio API YouTube Data e i Termini di servizio dei servizi API di YouTube.

Aggiorna i metadati di un canale. Tieni presente che questo metodo supporta solo gli aggiornamenti degli oggetti brandingSettings, invideoPromotion e localizations della risorsa channel e delle relative proprietà secondarie.

Impatto sulla quota: una chiamata a questo metodo ha un costo di quota di 50 unità.

Casi d'uso comuni

Richiesta

Richiesta HTTP

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

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti. Per saperne di più sull'autenticazione e sull'autorizzazione, consulta Implementare l'autorizzazione OAuth 2.0.

Ambito
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
part string
Il parametro part ha due scopi in questa operazione. Identifica le proprietà che l'operazione di scrittura imposterà, nonché le proprietà che la risposta dell'API includerà.

L'API consente di impostare il valore del parametro solo su brandingSettings, invideoPromotion o localizations. (Puoi aggiornare solo una di queste parti con una singola richiesta.)

Tieni presente che questo metodo sostituisce i valori esistenti per tutte le proprietà modificabili contenute nella parte specificata dal valore parametro.
Parametri facoltativi
onBehalfOfContentOwner string
Questo parametro può essere utilizzato solo in una richiesta autorizzata correttamente.

Il parametro onBehalfOfContentOwner indica che l'utente autenticato agisce per conto del proprietario dei contenuti specificato nel valore del parametro. Questo parametro è destinato ai partner di contenuti di YouTube che possiedono e gestiscono molti canali YouTube diversi. Consente ai proprietari dei contenuti di eseguire l'autenticazione una sola volta e di accedere a tutti i dati dei video e dei canali, senza dover fornire le credenziali di autenticazione per ogni singolo canale. L'account CMS effettivo con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.

Questo parametro deve essere fornito se la richiesta viene autenticata con le credenziali di un utente proprietario dei contenuti CMS che agisce su un canale gestito. Se omessa, la richiesta viene eseguita nel contesto diretto dell'utente autenticato e restituisce un errore HTTP 403 Forbidden.

Corpo della richiesta

Fornisci una risorsa channel nel corpo della richiesta. Per questa risorsa:

  • Devi specificare un valore per queste proprietà:

    • id

  • Puoi impostare i valori per queste proprietà:

    • 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

    Se invii una richiesta di aggiornamento e la richiesta non specifica un valore per una proprietà che ne ha già uno, il valore esistente della proprietà verrà eliminato.

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa channel nel corpo della risposta.

Errori

La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta API YouTube Data - Errori.

Tipo di errore Dettagli errore Descrizione
badRequest (400) brandingValidationError Uno dei valori nell'oggetto brandingSettings non ha superato la convalida. Utilizza il metodo channels.list per recuperare le impostazioni esistenti per il canale e aggiorna i valori delle proprietà seguendo le linee guida nella documentazione della risorsa channels.
badRequest (400) channelTitleUpdateForbidden Quando aggiorni la brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo attuale del canale o omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà.
badRequest (400) defaultLanguageNotSetError Per aggiornare localizations, devi impostare defaultLanguage.
badRequest (400) invalidBrandingOption Una delle impostazioni relative ai brand specificate non esiste. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione della risorsa channels.
badRequest (400) invalidCustomMessage I metadati della richiesta specificano un messaggio personalizzato non valido. Controlla il valore della proprietà invideoPromotion.items[].customMessage nella risorsa inviata dalla richiesta.
badRequest (400) invalidDuration I metadati della richiesta specificano una durata non valida nella parte invideoPromotion.
badRequest (400) invalidDuration I metadati della richiesta specificano un tipo di posizione non valido per determinare il posizionamento dell'elemento promozionale nel video player. Controlla il valore della proprietà invideoPromotion.position.type nella risorsa inviata dalla richiesta.
badRequest (400) invalidRecentlyUploadedBy I metadati della richiesta specificano un ID canale non valido. Controlla il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset temporale non valido nella parte invideoPromotion.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset temporale non valido per determinare quando l'elemento promozionale deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingType I metadati della richiesta specificano un metodo di temporizzazione non valido per determinare quando l'elemento promozionale deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
badRequest (400) localizationValidationError Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione della risorsa channels.
badRequest (400) tooManyPromotedItems Il numero di elementi promozionali consentiti è stato superato nella parte invideoPromotion.
forbidden (403) channelForbidden Il canale specificato nel parametro id non supporta la richiesta o la richiesta non è autorizzata correttamente.
forbidden (403) promotedVideoNotAllowed Impossibile trovare il canale che la richiesta API sta tentando di aggiornare. Controlla il valore della proprietà id nella risorsa channel inviata dalla richiesta per assicurarti che l'ID canale sia corretto.
forbidden (403) websiteLinkNotAllowed L'URL del sito web specificato non è consentito.
notFound (404) channelNotFound Impossibile trovare il canale specificato nel parametro id.
notFound (404) channelNotFound Impossibile trovare il canale specificato dal parametro id o non ha opzioni di branding.
notFound (404) unknownChannelId Impossibile trovare l'ID canale specificato.
notFound (404) unknownChannelId Impossibile trovare l'ID canale recentlyUploadedBy specificato.
notFound (404) unknownVideoId Impossibile trovare l'ID video specificato come elemento promozionale.
required (400) requiredItemIdType I metadati della richiesta devono specificare un tipo di articolo nella parte invideoPromotion.
required (400) requiredItemId I metadati della richiesta devono specificare un ID articolo nella parte invideoPromotion.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset temporale predefinito in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. Imposta il valore della proprietà invideoPromotion.defaultTiming.offsetMs nella risorsa inviata dalla richiesta.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset temporale in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. Imposta il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta.
required (400) requiredTimingType I metadati della richiesta devono specificare un metodo di temporizzazione in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. Imposta il valore della proprietà invideoPromotion.defaultTiming.type nella risorsa inviata dalla richiesta.
required (400) requiredTimingType I metadati della richiesta devono specificare un metodo di temporizzazione in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. Imposta il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
required (400) requiredTiming I metadati della richiesta devono specificare una temporizzazione per ogni elemento nella parte invideoPromotion.
required (400) requiredVideoId I metadati della richiesta devono specificare un ID video per identificare l'elemento promozionale.
required (400) requiredWebsiteUrl I metadati della richiesta devono specificare un URL del sito web nella parte invideoPromotion. Imposta il valore della proprietà invideoPromotion.items[].id.websiteUrl nella risorsa inviata dalla richiesta.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.