Channels: update

L'API ora supporta la possibilità di contrassegnare il tuo canale o i tuoi 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 del servizio API di dati di YouTube e i Termini di servizio dei servizi API di YouTube.

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

Impatto della quota: una chiamata a questo metodo ha un costo della 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 (scopri di più su autenticazione e autorizzazione).

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 verranno impostate dall'operazione di scrittura nonché quelle che saranno incluse nella risposta dell'API.

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

Tieni presente che questo metodo sostituisce i valori esistenti di tutte le proprietà modificabili all'interno della 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 parametro. Questo parametro è destinato ai partner per i contenuti di YouTube che possiedono e gestiscono molti canali YouTube diversi. Consente ai proprietari dei contenuti di effettuare l'autenticazione una volta sola e ottenere l'accesso a tutti i dati relativi a video e canali, senza dover fornire 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.

Corpo della richiesta

Fornisci una risorsa del canale nel corpo della richiesta. Per questa risorsa:

  • Devi specificare un valore per queste proprietà:

    • id

  • Puoi impostare i valori per le seguenti 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, che non specifica un valore per una proprietà che ha già un valore, il valore esistente della proprietà verrà eliminato.

Risposta

Se l'esito è positivo, questo metodo restituisce una risorsa del canale 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 ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.

Tipo di errore Dettagli errore Descrizione
badRequest (400) brandingValidationError Uno dei valori dell'oggetto brandingSettings non ha superato la convalida. Utilizza il metodo channels.list per recuperare le impostazioni esistenti del canale e aggiorna i valori delle proprietà seguendo le linee guida riportate nella documentazione delle risorse di channels.
badRequest (400) channelTitleUpdateForbidden Quando aggiorni il brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo corrente del canale oppure omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà.
badRequest (400) defaultLanguageNotSetError defaultLanguage deve essere impostato per l'aggiornamento di localizations.
badRequest (400) invalidBrandingOption Una delle impostazioni di branding specificate non esiste. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse di channels.
badRequest (400) invalidCustomMessage I metadati della richiesta specificano un messaggio personalizzato non valido. Verifica 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 modo in cui l'elemento promosso viene posizionato nel video player. Verifica 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. Verifica il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingOffset La richiesta metadati specifica un offset di tempo non valido nella parte invideopromotion.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset temporale non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Verifica 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'articolo promosso deve essere visualizzato nel video player. Verifica 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 valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione delle risorse dei canali.
badRequest (400) tooManyPromotedItems È stato superato il numero di articoli promossi consentiti nella parte invideopromotion.
forbidden (403) channelForbidden Il canale specificato nel parametro id non supporta la richiesta oppure la richiesta non è autorizzata in modo appropriato.
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 Il canale specificato dal parametro id non è stato trovato o non dispone di opzioni di branding.
notFound (404) unknownChannelId L'ID canale specificato non è stato trovato.
notFound (404) unknownChannelId L'ID canale RecentUploadedBy specificato non è stato trovato.
notFound (404) unknownVideoId Impossibile trovare l'ID video specificato come articolo promosso.
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 di tempo predefinito in modo che YouTube possa determinare quando visualizzare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.offsetMs nella risorsa inviata dalla richiesta.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset di tempo per consentire a YouTube di determinare quando mostrare l'articolo promosso. 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 tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. 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 tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
required (400) requiredTiming I metadati della richiesta devono specificare una tempistica per ogni elemento nella parte invideoPromotion.
required (400) requiredVideoId I metadati della richiesta devono specificare un ID video per identificare l'articolo promosso.
required (400) requiredWebsiteUrl I metadati della richiesta devono specificare l'URL di un sito web nella parte invideopromotion. Imposta il valore della proprietà invideoPromotion.items[].id.websiteUrl nella risorsa inviata dalla richiesta.

Prova.

Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.