Questa pagina è stata tradotta dall'API Cloud Translation.

YouTube Data API - Errors

Questo documento identifica i diversi tipi di errori che possono essere restituiti dalle operazioni di YouTube Data API. Puoi anche trovare un elenco degli errori relativi a un singolo metodo nella documentazione di riferimento del metodo in questione.

Errori generali

Le seguenti tabelle identificano i messaggi di errore dell'API non specifici per un determinato metodo API.

`Core API errors`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato.
`quotaExceeded (403)`	`quotaExceeded`	La richiesta non può essere completata perché hai superato la tua quota.

`Common request errors`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`incompatibleParameters`	La richiesta specifica due o più parametri che non possono essere utilizzati nella stessa richiesta.
`badRequest (400)`	`invalidFilters`	La richiesta specifica un parametro di filtro non valido.
`badRequest (400)`	`invalidPageToken`	La richiesta specifica un token di pagina non valido.
`badRequest (400)`	`missingRequiredParameter`	Nella richiesta manca un parametro obbligatorio.
`badRequest (400)`	`unexpectedParameter`	La richiesta specifica un parametro imprevisto.
`forbidden (403)`	`accountDelegationForbidden`	L'utente autenticato non può agire per conto dell'Account Google specificato.
`forbidden (403)`	`authenticatedUserAccountClosed`	L'account YouTube dell'utente autenticato viene chiuso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo.
`forbidden (403)`	`authenticatedUserAccountSuspended`	L'account YouTube dell'utente autenticato è stato sospeso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo.
`forbidden (403)`	`authenticatedUserNotChannel`	Per questa richiesta, l'utente autenticato deve risolversi in un canale, ma non lo fa. Se la tua richiesta è autenticata e utilizza il parametro di delega `onBehalfOfContentOwner`, devi impostare anche il parametro `onBehalfOfContentOwnerChannel`.
`forbidden (403)`	`channelClosed`	Il canale identificato nella richiesta è stato chiuso.
`forbidden (403)`	`channelNotFound`	Impossibile trovare il canale identificato nella richiesta.
`forbidden (403)`	`channelSuspended`	Il canale identificato nella richiesta è stato sospeso.
`forbidden (403)`	`cmsUserAccountNotFound`	L'utente CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato.
`forbidden (403)`	`insufficientCapabilities`	L'utente CMS non ha capacità sufficienti.
`forbidden (403)`	`insufficientPermissions`	Il token OAuth 2.0 fornito per la richiesta specifica gli ambiti insufficienti per accedere ai dati richiesti.
`notFound (404)`	`contentOwnerAccountNotFound`	Impossibile trovare l'account del proprietario dei contenuti specificato.

`Request context errors`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidLanguage`	Il valore del parametro `hl` non specifica un codice lingua valido.
`badRequest (400)`	`invalidMine`	L'utilizzo del parametro `mine` da parte della richiesta non è supportato.
`badRequest (400)`	`invalidMine`	Il parametro `mine` non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametro `mine`, autenticarti come utente di YouTube rimuovendo il parametro `onBehalfOfContentOwner` o agire come uno dei canali del partner fornendo il parametro `onBehalfOfContentOwnerChannel`, se disponibile per il metodo chiamato.
`badRequest (400)`	`invalidPart`	Il parametro `part` della richiesta specifica alcune parti che non possono essere scritte contemporaneamente.
`badRequest (400)`	`invalidRegionCode`	Il parametro `regionCode` specifica un codice regione non valido.
`badRequest (400)`	`unexpectedPart`	Il parametro `part` della richiesta specifica un valore imprevisto.
`badRequest (400)`	`unknownPart`	Il parametro `part` della richiesta specifica un valore sconosciuto.
`badRequest (400)`	`unsupportedLanguageCode`	Il valore del parametro `hl` non specifica un codice lingua supportato.
`badRequest (400)`	`unsupportedRegionCode`	Il parametro `regionCode` specifica un codice regione non supportato.
`unauthorized (401)`	`authorizationRequired`	La richiesta utilizza il parametro `mine` ma non è autorizzata correttamente.
`unauthorized (401)`	`youtubeSignupRequired`	Questo errore indica che l'utente ha un Account Google scollegato, il che significa che l'utente ha un Account Google, ma non ha un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, come la valutazione dei video o l'aggiunta di video a una playlist di `watch_later`. Tuttavia, ad esempio, l'utente deve avere un canale YouTube per poter caricare un video. Un utente che ha un account Gmail o un dispositivo Android è sicuro di avere un Account Google, ma potrebbe non averlo già collegato a un canale YouTube. Questo errore si verifica di solito se provi a utilizzare il flusso Account di servizio OAuth 2.0. YouTube non supporta gli account di servizio e, se tenti di autenticarti utilizzando un account di servizio, riceverai questo errore. Il post del blog sull'API di YouTube che presenta l'assistenza per gli Account Google illustra in modo più dettagliato l'errore `youtubeSignupRequired`. Anche se il post del blog spiega l'errore della versione 2.1 dell'API, il significato dell'errore è comunque applicabile.

attività

YouTube ha ritirato la funzionalità dei bollettini del canale. Il metodo activities.insert non è più supportato.

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse activities. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`activities.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`homeParameterDeprecated`	I dati relativi alle attività nella home page dell'utente non sono disponibili tramite questa API. Questo errore può verificarsi se imposti il parametro `home` su `true` in una richiesta non autorizzata.
`forbidden (403)`	`forbidden`	La richiesta non è autorizzata in modo adeguato.
`notFound (404)`	`channelNotFound`	Impossibile trovare l'ID canale identificato dal parametro `channelId` della richiesta.
`notFound (404)`	`homeChannelNotFound`	Impossibile trovare un feed della home page di YouTube per l'utente attualmente autenticato.
`unauthorized (401)`	`authorizationRequired`	La richiesta utilizza il parametro `home` ma non è autorizzata correttamente.

captions

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse captions. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`captions.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per eliminare la traccia di sottotitoli codificati. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia dei sottotitoli codificati. Verifica che il valore del parametro `id` della richiesta sia corretto.

`captions.download`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per scaricare la traccia di sottotitoli codificati. La richiesta potrebbe non essere debitamente autorizzata oppure l'ordine dei video potrebbe non aver abilitato i contributi di terze parti per questo sottotitolo codificato.
`invalidValue (400)`	`couldNotConvert`	Non è stato possibile convertire i dati della traccia dei sottotitoli nella lingua e/o nel formato richiesti. Assicurati che i valori `tfmt` e `tlang` richiesti siano validi e che il valore `snippet.status` della traccia di sottotitoli richiesta non sia `failed`.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia dei sottotitoli codificati. Verifica che il valore del parametro `id` della richiesta sia corretto.

`captions.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`contentRequired`	La richiesta non include i contenuti della traccia di sottotitoli codificati.
`conflict (409)`	`captionExists`	Il video specificato ha già una traccia di sottotitoli codificati con i `snippet.language` e i `snippet.name` indicati. Un video può avere più tracce per la stessa lingua, ma ogni traccia deve avere un nome diverso. Esistono diversi modi per risolvere l'errore. Puoi eliminare il canale esistente e quindi inserirne uno nuovo oppure modificare il nome della nuova traccia prima di inserirla.
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per caricare la traccia di sottotitoli codificati. La richiesta potrebbe non essere autorizzata in modo adeguato.
`invalidValue (400)`	`invalidMetadata`	La richiesta contiene valori di metadati non validi, che impediscono la creazione della traccia. Conferma che la richiesta specifichi valori validi per le proprietà `snippet.language`, `snippet.name` e `snippet.videoId`. Anche la proprietà `snippet.isDraft` può essere inclusa, ma non è obbligatoria.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video identificato dal parametro `videoId`.
`invalidValue (400)`	`nameTooLong`	Il valore `snippet.name` specificato nella richiesta è troppo lungo. La lunghezza massima supportata è di 150 caratteri.

`captions.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Impossibile recuperare una o più tracce di sottotitoli codificati perché le autorizzazioni associate alla richiesta non sono sufficienti per recuperare le risorse richieste. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`captionNotFound`	Impossibile trovare una o più tracce di sottotitoli codificati specificate. Questo errore si verifica se il parametro `videoId` identifica un video vero e proprio, ma il parametro `id` identifica ID traccia sottotitoli che non esistono o ID traccia associati ad altri video. Controlla i valori dei parametri `id` e `videoId` della richiesta per assicurarti che siano corretti.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video identificato dal parametro `videoId`.

`captions.update`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`contentRequired`	La richiesta non ha caricato un file di sottotitoli aggiornato. I contenuti effettivi delle tracce sono obbligatori se il parametro `sync` è impostato su `true`.
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per aggiornare la traccia di sottotitoli codificati. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia di sottotitoli specificata. Verifica che il valore del parametro `id` della richiesta sia corretto.

channelBanners

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channelBanners. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`channelBanners.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`bannerAlbumFull`	L'album della grafica del canale YouTube contiene troppe immagini. Vai all'indirizzo http://photos.google.com, vai alla pagina degli album e rimuovi alcune dalle immagini dall'album.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti dell'immagine.

channelSections

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channelSections. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`channelSections.delete`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`notEditable`	Impossibile eliminare la sezione di questo canale.
`forbidden (403)`	`channelSectionForbidden`	La richiesta non è stata autenticata correttamente o non è supportata per questo canale.
`invalidValue (400)`	`idInvalid`	La proprietà `id` specifica un ID sezione del canale non valido.
`invalidValue (400)`	`idRequired`	La proprietà `id` deve specificare un valore che identifichi la sezione del canale che viene eliminata.
`notFound (404)`	`channelNotFound`	Canale non trovato.
`notFound (404)`	`channelSectionNotFound`	Impossibile trovare la sezione del canale che stai tentando di aggiornare.

`channelSections.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSetError`	La proprietà `snippet.defaultLanguage` della risorsa `channelSection` deve essere impostata per inserire o aggiornare correttamente l'oggetto `localizations` per quella risorsa.
`badRequest (400)`	`invalidLanguage`	Una delle chiavi lingua dell'oggetto `localizations` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`notEditable`	Impossibile creare la sezione di questo canale.
`badRequest (400)`	`styleRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	Uno dei valori dell'elenco `targeting.countries` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	Uno dei valori dell'elenco `targeting.languages` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidRegion`	Uno dei valori dell'elenco `targeting.regions` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`typeRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.type`.
`forbidden (403)`	`channelSectionForbidden`	La richiesta non è stata autenticata correttamente o non è supportata per questo canale.
`invalidValue (400)`	`channelNotActive`	Almeno uno dei canali specificati non è attivo.
`invalidValue (400)`	`channelsDuplicated`	La richiesta non è andata a buon fine perché sono stati specificati canali duplicati.
`invalidValue (400)`	`channelsNeeded`	Se la proprietà `snippet.type` ha un valore di `multipleChannels`, è necessario specificare la proprietà `contentDetails.channels[]` e almeno un canale.
`invalidValue (400)`	`channelsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.channels[]`, ma non sono previsti canali per questo tipo di sezione del canale.
`invalidValue (400)`	`contentDetailsNeeded`	La risorsa che stai inserendo deve contenere un oggetto `contentDetails` per questo tipo di sezione di canale.
`invalidValue (400)`	`inValidPosition`	La proprietà `snippet.position` contiene un valore non valido.
`invalidValue (400)`	`maxChannelSectionExceeded`	La richiesta non può essere completata perché il canale ha già raggiunto il numero massimo di sezioni del canale.
`invalidValue (400)`	`maxChannelsExceeded`	La richiesta non è andata a buon fine perché ha tentato di includere troppi canali nella sezione del canale.
`invalidValue (400)`	`maxPlaylistExceeded`	La richiesta non è andata a buon fine perché ha tentato di includere troppe playlist nella sezione del canale.
`invalidValue (400)`	`onePlaylistNeeded`	Se la proprietà `snippet.type` ha un valore di `singlePlaylist`, la proprietà `contentDetails.playlists[]` deve specificare esattamente una playlist.
`invalidValue (400)`	`ownChannelInChannels`	Non puoi includere il tuo canale in una sezione del canale che appare su quel canale.
`invalidValue (400)`	`playlistIsPrivate`	Una o più playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale.
`invalidValue (400)`	`playlistsDuplicated`	La richiesta non è andata a buon fine perché contiene playlist duplicate.
`invalidValue (400)`	`playlistsNeeded`	Se la proprietà `snippet.type` ha un valore di `singlePlaylist` o `multiplePlaylists`, è necessario specificare la proprietà `contentDetails.playlists[]`.
`invalidValue (400)`	`playlistsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.playlists[]`, ma non sono previste playlist per questo tipo di sezione del canale.
`invalidValue (400)`	`snippetNeeded`	Devi specificare un `snippet` per creare la sezione del canale.
`invalidValue (400)`	`titleLengthExceeded`	Il valore della proprietà `snippet.title` è troppo lungo.
`invalidValue (400)`	`titleRequired`	Se la proprietà `snippet.type` ha un valore di `multiplePlaylists` o `multipleChannels`, devi impostare il titolo della sezione specificando un valore per la proprietà `snippet.title`.
`notFound (404)`	`channelNotFound`	Impossibile trovare uno o più canali specificati.
`notFound (404)`	`playlistNotFound`	Impossibile trovare una o più playlist specificate.

`channelSections.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`channelSectionForbidden`	Il richiedente non è autorizzato ad accedere alle sezioni del canale richieste.
`invalidValue (400)`	`idInvalid`	La richiesta specifica un ID sezione del canale non valido.
`invalidValue (400)`	`invalidCriteria`	Impossibile completare la richiesta perché i criteri del filtro non sono validi.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale associato alla richiesta.
`notFound (404)`	`channelSectionNotFound`	Impossibile trovare la sezione del canale associata alla richiesta.

`channelSections.update`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSetError`	La proprietà `snippet.defaultLanguage` della risorsa `channelSection` deve essere impostata per inserire o aggiornare correttamente l'oggetto `localizations` per quella risorsa.
`badRequest (400)`	`invalidLanguage`	Una delle chiavi lingua dell'oggetto `localizations` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`notEditable`	Impossibile modificare la sezione di questo canale.
`badRequest (400)`	`styleRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	Uno dei valori dell'elenco `targeting.countries` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	Uno dei valori dell'elenco `targeting.languages` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidRegion`	Uno dei valori dell'elenco `targeting.regions` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`typeRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.type`.
`forbidden (403)`	`channelSectionForbidden`	La richiesta non è stata autenticata correttamente o non è supportata per questo canale.
`invalidValue (400)`	`channelNotActive`	Almeno uno dei canali specificati non è attivo.
`invalidValue (400)`	`channelsDuplicated`	La richiesta non è andata a buon fine perché sono stati specificati canali duplicati.
`invalidValue (400)`	`channelsNeeded`	Se la proprietà `snippet.type` ha un valore di `multipleChannels`, è necessario specificare la proprietà `contentDetails.channels[]` e almeno un canale.
`invalidValue (400)`	`channelsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.channels[]`, ma non sono previsti canali per questo tipo di sezione del canale.
`invalidValue (400)`	`contentDetailsNeeded`	La risorsa che stai aggiornando deve contenere un oggetto `contentDetails` per questo tipo di sezione di canale.
`invalidValue (400)`	`idInvalid`	La proprietà `id` specifica un ID sezione del canale non valido.
`invalidValue (400)`	`idRequired`	La proprietà `id` deve specificare un valore che identifichi la sezione del canale aggiornata.
`invalidValue (400)`	`inValidPosition`	La proprietà `snippet.position` contiene un valore non valido.
`invalidValue (400)`	`maxChannelsExceeded`	La richiesta non è andata a buon fine perché ha tentato di includere troppi canali nella sezione del canale.
`invalidValue (400)`	`maxPlaylistExceeded`	La richiesta non è andata a buon fine perché ha tentato di includere troppe playlist nella sezione del canale.
`invalidValue (400)`	`onePlaylistNeeded`	Se la proprietà `snippet.type` ha un valore di `singlePlaylist`, la proprietà `contentDetails.playlists[]` deve specificare esattamente una playlist.
`invalidValue (400)`	`ownChannelInChannels`	Non puoi includere il tuo canale in una sezione del canale che appare su quel canale.
`invalidValue (400)`	`playlistIsPrivate`	Una o più playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale.
`invalidValue (400)`	`playlistsDuplicated`	La richiesta non è andata a buon fine perché contiene playlist duplicate.
`invalidValue (400)`	`playlistsNeeded`	Se la proprietà `snippet.type` ha un valore di `singlePlaylist` o `multiplePlaylists`, è necessario specificare la proprietà `contentDetails.playlists[]`.
`invalidValue (400)`	`playlistsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.playlists[]`, ma non sono previste playlist per questo tipo di sezione del canale.
`invalidValue (400)`	`snippetNeeded`	Devi specificare un `snippet` per aggiornare la sezione del canale.
`invalidValue (400)`	`titleLengthExceeded`	Il valore della proprietà `snippet.title` è troppo lungo.
`invalidValue (400)`	`titleRequired`	Se la proprietà `snippet.type` ha un valore di `multiplePlaylists` o `multipleChannels`, devi impostare il titolo della sezione specificando un valore per la proprietà `snippet.title`.
`notFound (404)`	`channelNotFound`	Impossibile trovare uno o più canali specificati.
`notFound (404)`	`channelSectionNotFound`	Impossibile trovare la sezione del canale che stai tentando di aggiornare.
`notFound (404)`	`playlistNotFound`	Impossibile trovare una o più playlist specificate.

canali

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channels. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`channels.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidCriteria`	È possibile specificare un massimo di uno dei seguenti filtri:`id`, `mySubscribers`, `categoryId`, `mine`, `managedByMe`, `forUsername`. In caso di autenticazione come proprietario dei contenuti tramite il parametro `onBehalfOfContentOwner`, è possibile specificare solo `id` o `managedByMe`.
`forbidden (403)`	`channelForbidden`	Il canale specificato dal parametro `id` non supporta la richiesta oppure la richiesta non è autorizzata correttamente.
`notFound (404)`	`categoryNotFound`	Impossibile trovare la categoria identificata dal parametro `categoryId`. Utilizza il metodo guideCategories.list per recuperare un elenco di valori validi.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale specificato nel parametro `id`.

`channels.update`

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`	Il canale specificato dal parametro `id` non è stato trovato o non dispone di opzioni di branding.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale specificato nel parametro `id`.
`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.

commentThreads

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse commentThreads. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`commentThreads.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`operationNotSupported`	Il filtro ID è compatibile solo con i commenti basati su Google+.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa `commentThread` nel corpo della richiesta per assicurarti che sia valida.
`forbidden (403)`	`commentsDisabled`	Il video identificato dal parametro `videoId` ha disattivato i commenti.
`forbidden (403)`	`forbidden`	Impossibile recuperare uno o più thread di commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale identificato dal parametro `channelId` o `allThreadsRelatedToChannelId`.
`notFound (404)`	`commentThreadNotFound`	Impossibile trovare uno o più thread di commenti specificati. Controlla i valori del parametro `id` della richiesta per assicurarti che siano corretti.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video identificato dal parametro `videoId`.

`commentThreads.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`channelOrVideoIdMissing`	Ogni thread di commenti deve essere collegato a un canale o a un video. Se il commento si applica a un canale, assicurati che la risorsa specificata nel corpo della richiesta fornisca un valore per la proprietà `snippet.channelId`. Un commento che si applica a un canale viene visualizzato nella scheda Discussione del canale. Se il commento si applica a un video, assicurati che la risorsa specifichi i valori per entrambe le proprietà `snippet.channelId` e `snippet.videoId`. Nella pagina di visualizzazione di un video in questione è presente un commento pertinente.
`badRequest (400)`	`commentTextRequired`	La risorsa `comment` inserita deve specificare un valore per la proprietà `snippet.topLevelComment.snippet.textOriginal`. I commenti non possono essere vuoti.
`badRequest (400)`	`commentTextTooLong`	La risorsa `comment` che viene inserita contiene troppi caratteri nella proprietà `snippet.topLevelComment.snippet.textOriginal`.
`badRequest (400)`	`invalidCommentThreadMetadata`	I metadati della richiesta non sono validi.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa `commentThread` nel corpo della richiesta per assicurarti che sia valida.
`forbidden (403)`	`forbidden`	Autorizzazioni insufficienti. Impossibile creare il thread dei commenti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`ineligibleAccount`	Per poter inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale specificato. Controlla il valore della proprietà `snippet.channelId` per assicurarti che sia corretto.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video specificato. Controlla il valore della proprietà `snippet.videoId` per assicurarti che sia corretto.

comments

Il metodo comments.markAsSpam non è più supportato.

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse comments. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`comments.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`operationNotSupported`	Il filtro ID è compatibile soltanto con i commenti basati su Google+.
`forbidden (403)`	`forbidden`	Impossibile recuperare uno o più commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`commentNotFound`	Impossibile trovare uno o più commenti specificati. Controlla i valori dei parametri `id` e `parentId` della richiesta per assicurarti che siano corretti.

`comments.setModerationStatus`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`banWithoutReject`	Il parametro `banAuthor` può essere utilizzato solo se il valore del parametro `moderationStatus` è `rejected`.
`badRequest (400)`	`operationNotSupported`	I commenti non basati su Google+ offrono solo funzionalità di moderazione limitate.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido.
`forbidden (403)`	`forbidden`	Impossibile impostare lo stato di moderazione di uno o più commenti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`commentNotFound`	Impossibile trovare uno o più commenti che si sta tentando di aggiornare nella richiesta. Controlla i valori del parametro `id` della richiesta per assicurarti che siano corretti.

`comments.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`commentTextRequired`	La risorsa `comment` inserita deve specificare un valore per la proprietà `snippet.textOriginal`. I commenti non possono essere vuoti.
`badRequest (400)`	`commentTextTooLong`	La risorsa `comment` che viene inserita contiene troppi caratteri nella proprietà `snippet.textOriginal`.
`badRequest (400)`	`invalidCommentMetadata`	I metadati della richiesta non sono validi.
`badRequest (400)`	`operationNotSupported`	L'utente dell'API non è in grado di inserire un commento in risposta al commento di primo livello identificato dalla proprietà `snippet.parentId`. In una risorsa `commentThread`, la proprietà `snippet.canReply` indica se il visualizzatore corrente può rispondere al thread.
`badRequest (400)`	`parentCommentIsPrivate`	Il commento principale specificato è privato. L'API non supporta le risposte ai commenti privati.
`badRequest (400)`	`parentIdMissing`	Il commento che viene inserito deve essere collegato a un commento principale. Tuttavia, la risorsa `comment` nel corpo della richiesta API non ha specificato un valore per la proprietà `snippet.parentId`.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa `comment` nel corpo della richiesta per assicurarti che sia valida.
`forbidden (403)`	`forbidden`	Impossibile creare il commento a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`ineligibleAccount`	Per poter inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente.
`notFound (404)`	`parentCommentNotFound`	Impossibile trovare il commento principale specificato. Controlla il valore della proprietà `snippet.parentId` nel corpo della richiesta per assicurarti che sia corretto.

`comments.delete`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido.
`forbidden (403)`	`forbidden`	Impossibile eliminare il commento a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`commentNotFound`	Impossibile trovare il commento specificato. Verifica che il valore del parametro `id` della richiesta sia corretto.

`comments.update`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`commentTextTooLong`	La risorsa `comment` in fase di aggiornamento contiene troppi caratteri nella proprietà `snippet.textOriginal`.
`badRequest (400)`	`invalidCommentMetadata`	I metadati della richiesta non sono validi.
`badRequest (400)`	`operationNotSupported`	È possibile aggiornare solo i commenti basati su Google+.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa `comment` nel corpo della richiesta per assicurarti che sia valida.
`forbidden (403)`	`forbidden`	Impossibile aggiornare il commento a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`ineligibleAccount`	Per aggiornare un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente.
`notFound (404)`	`commentNotFound`	Impossibile trovare il commento specificato. Controlla il valore della proprietà `id` nel corpo della richiesta per assicurarti che sia corretto.

membri

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse members. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`members.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`channelMembershipsNotEnabled`	Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta.
`badRequest (400)`	`invalidMode`	Il valore del parametro `mode` non è valido. Questo errore può verificarsi se il parametro `pageToken` specifica un token che è stato recuperato utilizzando una modalità diversa da quella specificata.
`badRequest (400)`	`invalidPageToken`	Il valore del parametro `pageToken` non è valido. Questo errore si verifica se il token di pagina utilizzato nella richiesta è scaduto.
`badRequest (400)`	`invalidHasAccessToLevel`	Il valore del parametro `hasAccessToLevel` non è valido. Non esiste alcun livello con il valore `id` specificato.
`badRequest (400)`	`invalidFilterByMemberChannelId`	Il valore del parametro `filterByMemberChannelId` non è valido. Questo errore si verifica se il valore del parametro `filterByMemberChannelId` specifica più di 100 canali.

membershipsLevels

`membershipsLevels.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`channelMembershipsNotEnabled`	Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta.

playlistItems

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse playlistItems. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`playlistItems.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è autorizzata a eliminare l'elemento della playlist specificato.
`notFound (404)`	`playlistItemNotFound`	Impossibile trovare l'elemento della playlist identificato con il parametro `id` della richiesta.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di eliminare video dalla playlist specificata. Ad esempio, non puoi eliminare un video dalla playlist dei video caricati.

`playlistItems.insert`

Tipo di errore	Dettagli errore	Descrizione
`duplicate`	`videoAlreadyInPlaylist`	Il video che stai tentando di aggiungere alla playlist è già presente nella playlist.
`forbidden (403)`	`playlistContainsMaximumNumberOfVideos`	La playlist contiene già il numero massimo consentito di elementi.
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è autorizzata a inserire l'elemento della playlist specificato.
`invalidValue (400)`	`invalidContentDetails`	La proprietà `contentDetails` nella richiesta non è valida. È possibile che il campo `contentDetails.note` contenga più di 280 caratteri.
`invalidValue (400)`	`invalidPlaylistItemPosition`	La richiesta cerca di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà `position` in `snippet` della risorsa.
`invalidValue (400)`	`invalidResourceType`	Il valore `type` specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio `youtube#video`.
`invalidValue (400)`	`manualSortRequired`	La richiesta cerca di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento `snippet.position` dalla risorsa che sta inserendo nella richiesta. Se vuoi che l'elemento della playlist abbia una posizione particolare nell'elenco, devi prima aggiornare l'opzione Ordine della playlist impostandola su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere modificate in Gestione video di YouTube.
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	Il video che stai cercando di aggiungere alla playlist è già presente in un'altra playlist della serie.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di inserire video nella playlist specificata. Ad esempio, non puoi inserire un video nella playlist dei video caricati.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `playlistId` della richiesta.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai cercando di aggiungere alla playlist. Controlla il valore della proprietà `videoId` per assicurarti che sia corretto.
`required (400)`	`channelIdRequired`	La richiesta non specifica un valore per la proprietà `channelId` obbligatoria.
`required (400)`	`playlistIdRequired`	La richiesta non specifica un valore per la proprietà `playlistId` obbligatoria.
`required (400)`	`resourceIdRequired`	La richiesta deve contenere una risorsa in cui l'oggetto `snippet` specifica un `resourceId`.

`playlistItems.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è autorizzata a recuperare la playlist specificata.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `playlistId` della richiesta.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video identificato con il parametro `videoId` della richiesta.
`required (400)`	`playlistIdRequired`	La richiesta di abbonamento non specifica un valore per la proprietà `playlistId` obbligatoria.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di elencare i video nella playlist specificata. Ad esempio, non puoi elencare un video nella playlist Guarda più tardi.

`playlistItems.update`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è autorizzata ad aggiornare l'elemento della playlist specificato.
`invalidValue (400)`	`invalidPlaylistItemPosition`	La richiesta cerca di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà `position` in `snippet` della risorsa.
`invalidValue (400)`	`invalidResourceType`	Il valore `type` specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio `youtube#video`.
`invalidValue (400)`	`invalidSnippet`	La richiesta non specifica una proprietà `snippet` valida.
`invalidValue (400)`	`manualSortRequired`	La richiesta cerca di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento `snippet.position` dalla risorsa che sta inserendo nella richiesta. Se vuoi che l'elemento della playlist abbia una posizione particolare nell'elenco, devi prima aggiornare l'opzione Ordine della playlist impostandola su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere modificate in Gestione video di YouTube.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di aggiornare i video nella playlist specificata. Ad esempio, non puoi aggiornare un video nella playlist dei video caricati.
`notFound (404)`	`playlistItemNotFound`	Impossibile trovare l'elemento della playlist identificato con la proprietà `id` della richiesta.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `playlistId` della richiesta.
`required (400)`	`channelIdRequired`	La richiesta non specifica un valore per la proprietà `channelId` obbligatoria.
`required (400)`	`playlistIdRequired`	La richiesta non specifica un valore per la proprietà `playlistId` obbligatoria.
`required (400)`	`playlistItemIdRequired`	La risorsa dell'elemento della playlist specificata nella richiesta deve utilizzare la proprietà `id` per identificare l'elemento della playlist che viene aggiornato.

playlist

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse playlists. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`playlists.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è autorizzata correttamente.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `id` della richiesta.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di eliminare la playlist specificata. Ad esempio, non puoi eliminare la playlist dei video caricati.

`playlists.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`channelClosed`	Il canale specificato nel parametro `channelId` è stato chiuso.
`forbidden (403)`	`channelSuspended`	Il canale specificato nel parametro `channelId` è stato sospeso.
`forbidden (403)`	`playlistForbidden`	La playlist identificata con il parametro `id` della richiesta non supporta la richiesta oppure quest'ultima non è autorizzata correttamente.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale specificato nel parametro `channelId`.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `id` della richiesta.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di elencare la playlist specificata. Ad esempio, non puoi elencare la playlist Guarda più tardi.

`playlists.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` deve essere impostato per l'aggiornamento di `localizations`.
`badRequest (400)`	`localizationValidationError`	Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo playlists.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse delle playlist.
`badRequest (400)`	`maxPlaylistExceeded`	Impossibile creare la playlist perché il canale ha già raggiunto il numero massimo di playlist consentito.
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è autorizzata correttamente.
`invalidValue (400)`	`invalidPlaylistSnippet`	La richiesta fornisce uno snippet della playlist non valido.
`required (400)`	`playlistTitleRequired`	La richiesta deve specificare un titolo della playlist.

`playlists.update`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` deve essere impostato per l'aggiornamento di `localizations`.
`badRequest (400)`	`localizationValidationError`	Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo playlists.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse delle playlist.
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è autorizzata correttamente.
`invalidValue (400)`	`invalidPlaylistSnippet`	La richiesta fornisce uno snippet della playlist non valido.
`invalidValue (400)`	`playlistOperationUnsupported`	L'API non supporta la possibilità di aggiornare la playlist specificata. Ad esempio, non puoi aggiornare le proprietà della playlist dei video caricati.
`notFound (404)`	`playlistNotFound`	Impossibile trovare la playlist identificata con il parametro `id` della richiesta.
`required (400)`	`playlistTitleRequired`	La richiesta deve specificare un titolo della playlist.

search

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse search. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`search.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidChannelId`	Il parametro `channelId` ha specificato un ID canale non valido.
`badRequest (400)`	`invalidLocation`	Il formato del valore parametro `location` e/o `locationRadius` non è corretto.
`badRequest (400)`	`invalidRelevanceLanguage`	Il formato del valore parametro `relevanceLanguage` non è corretto.
`badRequest (400)`	`invalidSearchFilter`	La richiesta contiene una combinazione non valida di filtri di ricerca e/o limitazioni. Tieni presente che devi impostare il parametro `type` su `video` se imposti un valore per i parametri `eventType`, `videoCaption`, `videoCategoryId`, `videoDefinition`, `videoDimension`, `videoDuration`, `videoEmbeddable`, `videoLicense`, `videoSyndicated` o `videoType`.

abbonamenti

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse subscriptions. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`subscriptions.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`subscriptionForbidden`	La richiesta non è stata autenticata correttamente o non è supportata per questo canale.
`notFound (404)`	`subscriptionNotFound`	Impossibile trovare la sottoscrizione che stai tentando di eliminare. Verifica che il valore del parametro `id` della richiesta sia corretto.

`subscriptions.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`subscriptionDuplicate`	La sottoscrizione che stai cercando di creare esiste già.
`badRequest (400)`	`subscriptionForbidden`	Hai raggiunto il numero massimo di iscrizioni.
`badRequest (400)`	`subscriptionForbidden`	Troppe iscrizioni recenti. Riprova fra qualche ora.
`badRequest (400)`	`subscriptionForbidden`	L'iscrizione al tuo canale non è supportata.
`forbidden (403)`	`subscriptionForbidden`	La richiesta non è stata autenticata correttamente o non è supportata per questo canale.
`notFound (404)`	`publisherNotFound`	Impossibile trovare la risorsa specificata dalla proprietà `snippet.resourceId` della richiesta.
`notFound (404)`	`subscriberNotFound`	Impossibile trovare l'abbonato identificato con la richiesta.
`required (400)`	`publisherRequired`	La risorsa di iscrizione specificata nella richiesta deve utilizzare la proprietà `snippet.resourceId` per identificare il canale a cui è iscritto.

`subscriptions.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`accountClosed`	Impossibile recuperare le iscrizioni perché l'account dell'abbonato è chiuso.
`forbidden (403)`	`accountSuspended`	Impossibile recuperare le iscrizioni perché l'account dell'abbonato è sospeso.
`forbidden (403)`	`subscriptionForbidden`	Il richiedente non è autorizzato ad accedere agli abbonamenti richiesti.
`notFound (404)`	`subscriberNotFound`	Impossibile trovare l'abbonato identificato con la richiesta.

miniature

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse thumbnails. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`thumbnails.set`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidImage`	I contenuti dell'immagine fornita non sono validi.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti dell'immagine.
`forbidden (403)`	`forbidden`	Impossibile impostare la miniatura per il video specificato. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`forbidden`	L'utente autenticato non dispone delle autorizzazioni per caricare e impostare miniature personalizzate dei video.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video per il quale stai tentando di inserire un'immagine in miniatura. Verifica che il valore del parametro `videoId` della richiesta sia corretto.
`tooManyRequests (429)`	`uploadRateLimitExceeded`	Il canale ha caricato troppe miniature di recente. Riprova a inviare la richiesta più tardi.

videoAbuseReportReasons

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videoAbuseReportReasons. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`videoAbuseReportReasons.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato.

videoCategories

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videoCategories. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`videoCategories.list`

Tipo di errore	Dettagli errore	Descrizione
`notFound (404)`	`videoCategoryNotFound`	Impossibile trovare la categoria del video identificata dal parametro `id`. Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi.

video

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videos. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`videos.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSet`	La richiesta sta tentando di aggiungere dettagli localizzati del video senza specificare la lingua predefinita dei dettagli.
`badRequest (400)`	`invalidCategoryId`	La proprietà `snippet.categoryId` specifica un ID categoria non valido. Utilizza il metodo `videoCategories.list` per recuperare le categorie supportate.
`badRequest (400)`	`invalidDescription`	I metadati della richiesta specificano una descrizione del video non valida.
`badRequest (400)`	`invalidFilename`	Il nome file video specificato nell'intestazione `Slug` non è valido.
`badRequest (400)`	`invalidPublishAt`	I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida.
`badRequest (400)`	`invalidRecordingDetails`	L'oggetto `recordingDetails` nei metadati della richiesta specifica dettagli della registrazione non validi.
`badRequest (400)`	`invalidTags`	I metadati della richiesta specificano parole chiave del video non valide.
`badRequest (400)`	`invalidTitle`	I metadati della richiesta specificano un titolo del video non valido o vuoto.
`badRequest (400)`	`invalidVideoGameRating`	I metadati della richiesta specificano una classificazione del videogioco non valida.
`badRequest (400)`	`invalidVideoMetadata`	I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte `snippet` di una risorsa `video`, ma non imposta un valore per entrambe le proprietà `snippet.title` e `snippet.categoryId`.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti video.
`badRequest (400)`	`uploadLimitExceeded`	L'utente ha superato il numero di video che può caricare.
`forbidden (403)`	`forbidden`
`forbidden (403)`	`forbiddenLicenseSetting`	La richiesta tenta di impostare una licenza non valida per il video.
`forbidden (403)`	`forbiddenPrivacySetting`	La richiesta tenta di configurare un'impostazione di privacy non valida per il video.

`videos.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`videoChartNotFound`	Il grafico video richiesto non è supportato o non è disponibile.
`forbidden (403)`	`forbidden`	La richiesta non dispone dell'autorizzazione necessaria per accedere al file video o alle informazioni relative all'elaborazione. Tieni presente che le parti `fileDetails`, `processingDetails` e `suggestions` sono disponibili solo per il proprietario di quel video.
`forbidden (403)`	`forbidden`	La richiesta non può accedere alle informazioni sulla valutazione degli utenti. Questo errore può verificarsi perché la richiesta non è autorizzata a utilizzare il parametro `myRating`.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai tentando di recuperare. Verifica che il valore del parametro `id` della richiesta sia corretto.

`videos.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Il video che stai tentando di eliminare non può essere eliminato. La richiesta potrebbe non essere autorizzata in modo adeguato.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai tentando di eliminare. Verifica che il valore del parametro `id` della richiesta sia corretto.

`videos.update`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSet`	La richiesta API sta tentando di aggiungere dettagli localizzati del video senza specificare la lingua predefinita dei dettagli del video.
`badRequest (400)`	`invalidCategoryId`	La proprietà `snippet.categoryId` specifica un ID categoria non valido. Utilizza il metodo `videoCategories.list` per recuperare le categorie supportate.
`badRequest (400)`	`invalidDefaultBroadcastPrivacySetting`	La richiesta tenta di configurare un'impostazione di privacy non valida per la trasmissione predefinita.
`badRequest (400)`	`invalidDescription`	I metadati della richiesta specificano una descrizione del video non valida.
`badRequest (400)`	`invalidPublishAt`	I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida.
`badRequest (400)`	`invalidRecordingDetails`	L'oggetto `recordingDetails` nei metadati della richiesta specifica dettagli della registrazione non validi.
`badRequest (400)`	`invalidTags`	I metadati della richiesta specificano parole chiave del video non valide.
`badRequest (400)`	`invalidTitle`	I metadati della richiesta specificano un titolo del video non valido o vuoto.
`badRequest (400)`	`invalidVideoMetadata`	I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte `snippet` di una risorsa `video`, ma non imposta un valore per entrambe le proprietà `snippet.title` e `snippet.categoryId`.
`forbidden (403)`	`forbidden`	Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`forbiddenEmbedSetting`	La richiesta tenta di configurare un'impostazione di incorporamento non valida per il video. Tieni presente che alcuni canali potrebbero non disporre dell'autorizzazione per offrire player incorporati per i live streaming. Consulta il Centro assistenza YouTube per ulteriori informazioni.
`forbidden (403)`	`forbiddenLicenseSetting`	La richiesta tenta di impostare una licenza non valida per il video.
`forbidden (403)`	`forbiddenPrivacySetting`	La richiesta tenta di configurare un'impostazione di privacy non valida per il video.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai tentando di aggiornare. Controlla il valore del campo `id` nel corpo della richiesta per assicurarti che sia corretto.

`videos.rate`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`emailNotVerified`	L'utente deve verificare il proprio indirizzo email prima della valutazione.
`badRequest (400)`	`invalidRating`	La richiesta conteneva un valore imprevisto per il parametro `rating`.
`badRequest (400)`	`videoPurchaseRequired`	I video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati.
`forbidden (403)`	`forbidden`	Il video che stai cercando di valutare non può essere valutato. La richiesta potrebbe non essere autorizzata in modo adeguato.
`forbidden (403)`	`videoRatingDisabled`	Il proprietario del video che stai tentando di valutare ha disattivato le valutazioni del video in questione.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai cercando di valutare. Verifica che il valore del parametro `id` della richiesta sia corretto.

`videos.reportAbuse`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidAbuseReason`	La richiesta conteneva un valore imprevisto per il campo `reason_id` o una combinazione di campi `reason_id` e `secondary_reason_id`.
`badRequest (400)`	`rateLimitExceeded`	L'utente ha inviato troppe richieste in un determinato periodo di tempo.
`forbidden (403)`	`forbidden`
`notFound (404)`	`videoNotFound`	Impossibile trovare il video per il quale stai cercando di segnalare un abuso.

watermarks

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse watermarks. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni.

`watermarks.set`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`imageFormatUnsupported`	L'immagine che hai fornito è in un formato non supportato.
`badRequest (400)`	`imageTooTall`	L'immagine che hai fornito è troppo alto.
`badRequest (400)`	`imageTooWide`	L'immagine che hai fornito è troppo larga.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti dell'immagine.
`forbidden (403)`	`forbidden`	Non è possibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente oppure il parametro `channelId` è impostato su un valore non valido.

`watermarks.unset`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Non è possibile annullare l'impostazione della filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente oppure il parametro `channelId` è impostato su un valore non valido.