Questa pagina è stata tradotta dall'API Cloud Translation.

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. Il 10 gennaio 2020 sono stati aggiornati anche i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta le cronologie delle revisioni del servizio API YouTube Data e dei Termini di servizio dei servizi API di YouTube.

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

Impatto sulla 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. Per scoprire di più sull'autenticazione e sull'autorizzazione, consulta Implementazione dell'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 verranno impostate dall'operazione di scrittura e quelle che verranno incluse nella risposta dell'API. L'API consente di impostare il valore del parametro solo su `brandingSettings`, `invideoPromotion` o `localizations`. Puoi aggiornare una sola di queste parti con una singola richiesta. Tieni presente che questo metodo sostituisce i valori esistenti per tutte le proprietà mutabili contenute nella parte specificata dal valore del parametro.
Parametri facoltativi
`onBehalfOfContentOwner`	`string` Questo parametro può essere utilizzato solo in una richiesta autorizzata. 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 di contenuti di autenticarsi una volta sola per 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.

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 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 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 seguente tabella identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la pagina API YouTube Data - Errori.

Tipo di errore	Dettaglio 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 del canale e aggiornare i valori delle proprietà seguendo le linee guida riportate nella documentazione della risorsa `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 o omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà.
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` deve essere impostato per aggiornare `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 riportate 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 a cui è stata inviata la 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 la posizione dell'elemento promosso nel video player. Controlla il valore della proprietà `invideoPromotion.position.type` nella risorsa a cui è stata inviata la 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 a cui è stata inviata la richiesta.
`badRequest (400)`	`invalidTimingOffset`	I metadati della richiesta specificano un offset dei tempi non valido nella parte invideoPromotion.
`badRequest (400)`	`invalidTimingOffset`	I metadati della richiesta specificano un offset dei tempi non valido per determinare quando l'elemento in promozione deve essere visualizzato nel video player. Controlla il valore della proprietà `invideoPromotion.timing.offsetMs` nella risorsa a cui è stata inviata la richiesta.
`badRequest (400)`	`invalidTimingType`	I metadati della richiesta specificano un metodo di temporizzazione non valido per determinare quando l'elemento in promozione deve essere visualizzato nel video player. Controlla il valore della proprietà `invideoPromotion.timing.type` nella risorsa a cui è stata inviata la richiesta.
`badRequest (400)`	`localizationValidationError`	Uno dei valori nell'oggetto localizzazioni 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`	Numero di elementi promossi consentiti superato nella parte invideoPromotion.
`forbidden (403)`	`channelForbidden`	Il canale specificato nel parametro `id` non supporta la richiesta o la richiesta non è correttamente autorizzata.
`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 recentlyUploadedBy specificato non è stato trovato.
`notFound (404)`	`unknownVideoId`	Impossibile trovare l'ID video specificato come elemento in evidenza.
`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 dei tempi predefinito in modo che YouTube possa determinare quando mostrare l'elemento 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 dei tempi in modo che YouTube possa determinare quando mostrare l'elemento in promozione. 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 mostrare l'elemento 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 temporizzazione in modo che YouTube possa determinare quando mostrare l'elemento promosso. Imposta il valore della proprietà `invideoPromotion.timing.type` nella risorsa inviata dalla richiesta.
`required (400)`	`requiredTiming`	I metadati della richiesta devono specificare un'ora 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 un URL del 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.