YouTube Data API - Errors

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

Errori generali

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

`Core API errors`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Accesso vietato. La richiesta potrebbe non essere correttamente autorizzata.
`quotaExceeded (403)`	`quotaExceeded`	La richiesta non può essere completata perché hai superato la 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 è 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 è 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 risolvere in un canale, ma non lo fa. Se la 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 del CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato.
`forbidden (403)`	`insufficientCapabilities`	L'utente del CMS non dispone di funzionalità sufficienti.
`forbidden (403)`	`insufficientPermissions`	Il token OAuth 2.0 fornito per la richiesta specifica ambiti insufficienti per accedere ai dati richiesti.
`notFound (404)`	`contentOwnerAccountNotFound`	L'account del proprietario dei contenuti specificato non è stato trovato.

`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` nella 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 è correttamente autorizzata.
`unauthorized (401)`	`youtubeSignupRequired`	Questo errore indica che l'utente ha un Account Google scollegato, ovvero un Account Google, ma non ha un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, ad esempio la classificazione dei video o l'aggiunta di video a una playlist `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 ha sicuramente un Account Google, ma potrebbe non averlo ancora collegato a un canale YouTube. Questo errore si verifica di solito se provi a utilizzare il flusso dell'account di servizio OAuth 2.0. YouTube non supporta gli account di servizio e, se provi ad autenticarti utilizzando un account di servizio, riceverai questo errore. Il post del blog sull'API YouTube che introduce il supporto dell'Account Google illustra anche l'errore `youtubeSignupRequired` in modo più dettagliato. Sebbene il post del blog spieghi l'errore per la versione 2.1 dell'API, il significato dell'errore è ancora applicabile.

attività

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

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse activities. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`activities.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`homeParameterDeprecated`	I dati sulle attività della 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 è correttamente autorizzata.
`notFound (404)`	`channelNotFound`	Impossibile trovare l'ID canale identificato dal parametro `channelId` della richiesta.
`notFound (404)`	`homeChannelNotFound`	Non è possibile trovare un feed della home page di YouTube per l'utente attualmente autenticato.
`unauthorized (401)`	`authorizationRequired`	La richiesta utilizza il parametro `home`, ma non è correttamente autorizzata.

sottotitoli

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse captions. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`captions.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per eliminare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia 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 dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata.
`invalidValue (400)`	`couldNotConvert`	Non è stato possibile convertire i dati della traccia dei sottotitoli codificati nella lingua e/o nel formato richiesti. Assicurati che i valori `tfmt` e `tlang` richiesti siano validi e che il `snippet.status` della traccia dei sottotitoli codificati richiesta non sia `failed`.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia 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 contiene i contenuti della traccia dei sottotitoli codificati.
`conflict (409)`	`captionExists`	Il video specificato ha già una traccia di sottotitoli codificati con `snippet.language` e `snippet.name`. 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 la traccia esistente e inserirne una nuova 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 dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata.
`invalidValue (400)`	`invalidMetadata`	La richiesta contiene valori dei metadati non validi, che impediscono la creazione della traccia. Verifica che la richiesta specifichi valori validi per le proprietà `snippet.language`, `snippet.name` e `snippet.videoId`. È possibile includere anche la proprietà `snippet.isDraft`, 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`	Non è stato possibile recuperare uno o più canali di sottotitoli codificati perché le autorizzazioni associate alla richiesta non sono sufficienti per recuperare le risorse richieste. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`captionNotFound`	Impossibile trovare uno o più canali di sottotitoli codificati specificati. Questo errore si verifica se il parametro `videoId` identifica un video reale, ma il parametro `id` identifica ID traccia dei sottotitoli codificati che non esistono o ID traccia associati ad altri video. Verifica che i valori dei parametri `id` e `videoId` della richiesta 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 codificati aggiornato. I contenuti effettivi della traccia sono obbligatori se il parametro `sync` è impostato su `true`.
`forbidden (403)`	`forbidden`	Le autorizzazioni associate alla richiesta non sono sufficienti per aggiornare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`captionNotFound`	Impossibile trovare la traccia sottotitoli codificati specificata. Verifica che il valore del parametro `id` della richiesta sia corretto.

channelBanners

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channelBanners. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`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 immagini dall'album.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti dell'immagine.

channelSections

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channelSections. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`channelSections.delete`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`notEditable`	Impossibile eliminare questa sezione del canale.
`forbidden (403)`	`channelSectionForbidden`	La richiesta non è 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 da eliminare.
`notFound (404)`	`channelNotFound`	Il canale non è stato 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 la risorsa.
`badRequest (400)`	`invalidLanguage`	La convalida di una delle chiavi di lingua dell'oggetto `localizations` non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`notEditable`	Impossibile creare questa sezione del canale.
`badRequest (400)`	`styleRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	Uno dei valori nell'elenco `targeting.countries` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	Uno dei valori nell'elenco `targeting.languages` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidRegion`	Uno dei valori nell'elenco `targeting.regions` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `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 è 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 `multipleChannels`, deve essere specificata la proprietà `contentDetails.channels[]` e deve essere specificato almeno un canale.
`invalidValue (400)`	`channelsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.channels[]`, ma i canali non sono previsti 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 del 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à il numero massimo di sezioni.
`invalidValue (400)`	`maxChannelsExceeded`	La richiesta non è andata a buon fine perché è stato tentato di includere troppi canali nella sezione dei canali.
`invalidValue (400)`	`maxPlaylistExceeded`	La richiesta non è andata a buon fine perché è stato tentato di includere troppe playlist nella sezione del canale.
`invalidValue (400)`	`onePlaylistNeeded`	Se la proprietà `snippet.type` ha un valore `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 viene visualizzata sul canale in questione.
`invalidValue (400)`	`playlistIsPrivate`	Una o più delle 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é sono state specificate playlist duplicate.
`invalidValue (400)`	`playlistsNeeded`	Se la proprietà `snippet.type` ha un valore `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 le playlist non sono previste 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 `multiplePlaylists` o `multipleChannels`, devi impostare il titolo della sezione specificando un valore per la proprietà `snippet.title`.
`notFound (404)`	`channelNotFound`	Non è possibile trovare uno o più dei canali specificati.
`notFound (404)`	`playlistNotFound`	Non è possibile trovare una o più delle playlist specificate.

`channelSections.list`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`channelSectionForbidden`	L'utente che ha effettuato la richiesta 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 di 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 la risorsa.
`badRequest (400)`	`invalidLanguage`	La convalida di una delle chiavi di lingua dell'oggetto `localizations` non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`notEditable`	Questa sezione del canale non può essere modificata.
`badRequest (400)`	`styleRequired`	La risorsa `channelSection` deve specificare un valore per il campo `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	Uno dei valori nell'elenco `targeting.countries` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	Uno dei valori nell'elenco `targeting.languages` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `a href="/youtube/v3/docs/channelSections#resource">channelSections`.
`badRequest (400)`	`targetInvalidRegion`	Uno dei valori nell'elenco `targeting.regions` non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa `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 è 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 `multipleChannels`, deve essere specificata la proprietà `contentDetails.channels[]` e deve essere specificato almeno un canale.
`invalidValue (400)`	`channelsNotExpected`	La risorsa fornita con la richiesta ha specificato un valore per la proprietà `contentDetails.channels[]`, ma i canali non sono previsti 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 del 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 da aggiornare.
`invalidValue (400)`	`inValidPosition`	La proprietà `snippet.position` contiene un valore non valido.
`invalidValue (400)`	`maxChannelsExceeded`	La richiesta non è andata a buon fine perché è stato tentato di includere troppi canali nella sezione dei canali.
`invalidValue (400)`	`maxPlaylistExceeded`	La richiesta non è andata a buon fine perché è stato tentato di includere troppe playlist nella sezione del canale.
`invalidValue (400)`	`onePlaylistNeeded`	Se la proprietà `snippet.type` ha un valore `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 viene visualizzata sul canale in questione.
`invalidValue (400)`	`playlistIsPrivate`	Una o più delle 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é sono state specificate playlist duplicate.
`invalidValue (400)`	`playlistsNeeded`	Se la proprietà `snippet.type` ha un valore `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 le playlist non sono previste 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 `multiplePlaylists` o `multipleChannels`, devi impostare il titolo della sezione specificando un valore per la proprietà `snippet.title`.
`notFound (404)`	`channelNotFound`	Non è possibile trovare uno o più dei canali specificati.
`notFound (404)`	`channelSectionNotFound`	Impossibile trovare la sezione del canale che stai tentando di aggiornare.
`notFound (404)`	`playlistNotFound`	Non è possibile trovare una o più delle playlist specificate.

canali

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channels. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`channels.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidCriteria`	È possibile specificare al massimo uno dei seguenti filtri:`id`, `mySubscribers`, `categoryId`, `mine`, `managedByMe`, `forUsername`. In caso di autenticazione del 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 o la richiesta non è correttamente autorizzata.
`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`	La convalida di uno dei valori dell'oggetto `brandingSettings` non è riuscita. 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 i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa 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`	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 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 elemento 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.

commentThreads

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse commentThreads. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`commentThreads.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`operationNotSupported`	La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è in grado di comprendere la richiesta.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere 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`	I commenti sono disattivati per il video identificato dal parametro `videoId`.
`forbidden (403)`	`forbidden`	Non è possibile recuperare uno o più thread di commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`channelNotFound`	Impossibile trovare il canale identificato dal parametro `allThreadsRelatedToChannelId`.
`notFound (404)`	`commentThreadNotFound`	Non è possibile trovare uno o più thread di commenti specificati. Verifica 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. Assicurati che la risorsa specifichi i valori sia per le proprietà `snippet.channelId` che per `snippet.videoId`. Un commento su un video viene visualizzato nella pagina di visualizzazione del video.
`badRequest (400)`	`commentTextRequired`	La risorsa `comment` da inserire 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 correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere 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`	Il thread dei commenti potrebbe essere stato creato a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere correttamente autorizzata.
`forbidden (403)`	`ineligibleAccount`	Per inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta dell'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.

commenti

Il metodo comments.markAsSpam non è più supportato.

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse comments. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`comments.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`operationNotSupported`	La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è in grado di comprendere la richiesta.
`forbidden (403)`	`forbidden`	Non è possibile recuperare uno o più dei commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`commentNotFound`	Non è possibile trovare uno o più dei commenti specificati. Verifica che i valori dei parametri `id` e `parentId` della richiesta 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`	La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è in grado di comprendere la richiesta.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere indica che l'input della richiesta non è valido.
`forbidden (403)`	`forbidden`	Non è possibile impostare lo stato di moderazione di uno o più commenti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere correttamente autorizzata.
`notFound (404)`	`commentNotFound`	Non è possibile trovare uno o più commenti che la richiesta sta tentando di aggiornare. Verifica che i valori del parametro `id` della richiesta siano corretti.

`comments.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`commentTextRequired`	La risorsa `comment` da inserire 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 lo spettatore 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 correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere 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 correttamente autorizzata.
`forbidden (403)`	`ineligibleAccount`	Per inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta dell'API deve essere unito all'Account Google dell'utente.
`notFound (404)`	`parentCommentNotFound`	Impossibile trovare il commento principale specificato. Verifica che il valore della proprietà `snippet.parentId` nel corpo della richiesta sia corretto.

`comments.delete`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere 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 correttamente autorizzata.
`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`	La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è in grado di comprendere la richiesta.
`badRequest (400)`	`processingFailure`	Il server API non è riuscito a elaborare correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, in genere 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 correttamente autorizzata.
`forbidden (403)`	`ineligibleAccount`	Per aggiornare un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta dell'API deve essere unito all'Account Google dell'utente.
`notFound (404)`	`commentNotFound`	Impossibile trovare il commento specificato. Verifica che il valore della proprietà `id` nel corpo della richiesta sia corretto.

membri

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse members. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`members.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`channelMembershipsNotEnabled`	Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale.
`badRequest (400)`	`invalidMode`	Il valore del parametro `mode` non è valido. Questo errore potrebbe verificarsi se il parametro `pageToken` specifica un token 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 pagina utilizzato nella richiesta è scaduto.
`badRequest (400)`	`invalidHasAccessToLevel`	Il valore del parametro `hasAccessToLevel` non è valido. Non esiste un 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`	Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale.

playlistItems

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse playlistItems. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`playlistItems.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è autorizzata correttamente per 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 i 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 cercando di aggiungere alla playlist è già presente al suo interno.
`forbidden (403)`	`playlistContainsMaximumNumberOfVideos`	La playlist contiene già il numero massimo di elementi consentito.
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è correttamente autorizzata a inserire l'elemento della playlist specificato.
`invalidValue (400)`	`invalidContentDetails`	La proprietà `contentDetails` nella richiesta non è valida. Un possibile motivo è che il campo `contentDetails.note` è più lungo di 280 caratteri.
`invalidValue (400)`	`invalidPlaylistItemPosition`	La richiesta tenta 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 tenta 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 inserita dalla richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordine della playlist su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere regolate 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 tentando 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 è correttamente 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 iscrizione 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 inserire un video nella playlist Guarda più tardi.

`playlistItems.update`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistItemsNotAccessible`	La richiesta non è correttamente autorizzata ad aggiornare l'elemento della playlist specificato.
`invalidValue (400)`	`invalidPlaylistItemPosition`	La richiesta tenta 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 tenta 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 inserita dalla richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordine della playlist su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere regolate 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 elemento della playlist specificata nella richiesta deve utilizzare la proprietà `id` per identificare l'elemento della playlist in fase di aggiornamento.

playlist

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse playlists. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`playlists.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è correttamente autorizzata.
`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 che hai caricato.

`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 o la richiesta non è correttamente autorizzata.
`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 tua playlist Guarda più tardi.

`playlists.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` deve essere impostato per aggiornare `localizations`.
`badRequest (400)`	`localizationValidationError`	Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo playlists.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa Playlists.
`badRequest (400)`	`maxPlaylistExceeded`	La playlist non può essere creata perché il canale ha già raggiunto il numero massimo di playlist consentite.
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è correttamente autorizzata.
`invalidValue (400)`	`invalidPlaylistSnippet`	La richiesta fornisce uno snippet di 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 aggiornare `localizations`.
`badRequest (400)`	`localizationValidationError`	Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo playlists.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa Playlists.
`forbidden (403)`	`playlistForbidden`	Questa operazione è vietata o la richiesta non è correttamente autorizzata.
`invalidValue (400)`	`invalidPlaylistSnippet`	La richiesta fornisce uno snippet di 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 tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse search. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`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 valore del parametro `location` e/o `locationRadius` non è formattato correttamente.
`badRequest (400)`	`invalidRelevanceLanguage`	Il formato del valore del parametro `relevanceLanguage` è errato.
`badRequest (400)`	`invalidSearchFilter`	La richiesta contiene una combinazione non valida di filtri di ricerca e/o limitazioni. 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 tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse subscriptions. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`subscriptions.delete`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`subscriptionForbidden`	La richiesta non è autenticata correttamente o non è supportata per questo canale.
`notFound (404)`	`subscriptionNotFound`	Impossibile trovare l'abbonamento 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`	L'abbonamento che stai cercando di creare esiste già.
`badRequest (400)`	`subscriptionForbidden`	Hai raggiunto il numero massimo di abbonamenti.
`badRequest (400)`	`subscriptionForbidden`	Troppe iscrizioni recenti. Riprova tra qualche ora.
`badRequest (400)`	`subscriptionForbidden`	L'iscrizione al tuo canale non è supportata.
`forbidden (403)`	`subscriptionForbidden`	La richiesta non è 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 abbonamento specificata nella richiesta deve utilizzare la proprietà `snippet.resourceId` per identificare il canale a cui si sta sottoscrivendo l'abbonamento.

`subscriptions.list`

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

miniature

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse thumbnails. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`thumbnails.set`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`invalidImage`	I contenuti dell'immagine forniti 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 correttamente autorizzata.
`forbidden (403)`	`forbidden`	L'utente autenticato non dispone delle autorizzazioni per caricare e impostare miniature dei video personalizzate.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video per cui 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 in un secondo momento.

videoAbuseReportReasons

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videoAbuseReportReasons. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`videoAbuseReportReasons.list`

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

videoCategories

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videoCategories. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`videoCategories.list`

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

video

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videos. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`videos.insert`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`defaultLanguageNotSet`	La richiesta tenta di aggiungere dettagli del video localizzati 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)`	`invalidDescription`	I metadati della richiesta specificano una descrizione del video non valida.
`badRequest (400)`	`invalidFilename`	Il nome del file del 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 di registrazione non validi.
`badRequest (400)`	`invalidTags`	I metadati della richiesta specificano parole chiave 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 sia per le proprietà `snippet.title` sia per `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 impostare un'impostazione della privacy non valida per il video.

`videos.list`

Tipo di errore	Dettagli errore	Descrizione
`badRequest (400)`	`videoChartNotFound`	La classifica video richiesta non è supportata o non è disponibile.
`forbidden (403)`	`forbidden`	La richiesta non è autorizzata correttamente ad accedere al file video o alle informazioni di elaborazione. Le parti `fileDetails`, `processingDetails` e `suggestions` sono disponibili solo per il proprietario del video.
`forbidden (403)`	`forbidden`	La richiesta non può accedere alle informazioni sulle valutazioni degli utenti. Questo errore può verificarsi perché la richiesta non è autorizzata correttamente 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 correttamente autorizzata.
`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 del video localizzati 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 impostare un'impostazione della 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 di registrazione non validi.
`badRequest (400)`	`invalidTags`	I metadati della richiesta specificano parole chiave 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 correttamente autorizzata.
`forbidden (403)`	`forbiddenEmbedSetting`	La richiesta tenta di impostare un'impostazione di incorporamento non valida per il video. Alcuni canali potrebbero non avere l'autorizzazione a offrire player incorporati per i live . Per ulteriori informazioni, consulta il Centro assistenza YouTube.
`forbidden (403)`	`forbiddenLicenseSetting`	La richiesta tenta di impostare una licenza non valida per il video.
`forbidden (403)`	`forbiddenPrivacySetting`	La richiesta tenta di impostare un'impostazione della 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 di poter valutare.
`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 tentando di valutare non può essere valutato. La richiesta potrebbe non essere correttamente autorizzata.
`forbidden (403)`	`videoRatingDisabled`	Il proprietario del video che stai tentando di valutare ha disattivato le valutazioni per quel video.
`notFound (404)`	`videoNotFound`	Impossibile trovare il video che stai tentando 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 dei 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`	Non è possibile trovare il video per cui stai tentando di segnalare un abuso.

filigrane

Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse watermarks. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.

`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 alta.
`badRequest (400)`	`imageTooWide`	L'immagine che hai fornito è troppo larga.
`badRequest (400)`	`mediaBodyRequired`	La richiesta non include i contenuti dell'immagine.
`forbidden (403)`	`forbidden`	Impossibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere correttamente autorizzata o il parametro `channelId` potrebbe essere impostato su un valore non valido.

`watermarks.unset`

Tipo di errore	Dettagli errore	Descrizione
`forbidden (403)`	`forbidden`	La filigrana non può essere deselezionata per il canale specificato. La richiesta potrebbe non essere correttamente autorizzata o il parametro `channelId` potrebbe essere impostato su un valore non valido.

YouTube Data API - ErrorsMantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Errori generali

Core API errors

Common request errors

Request context errors

attività

activities.list

sottotitoli

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

canali

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

commenti

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update