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.