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.

Errori generali

Le tabelle seguenti identificano i messaggi di errore dell'API che non sono specifici di un particolare metodo API.

Core API errors

Tipo di errore Dettaglio errore Descrizione
forbidden (403) forbidden Accesso vietato. La richiesta potrebbe non essere autorizzata correttamente.
quotaExceeded (403) quotaExceeded La richiesta non può essere completata perché hai superato la quota.

Common request errors

Tipo di errore Dettaglio 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. Nel caso in cui l'utente autenticato agisca per conto di un altro Account Google, questo errore si riferisce a quest'ultimo.
forbidden (403) authenticatedUserAccountSuspended L'account YouTube dell'utente autenticato è sospeso. Nel caso in cui l'utente autenticato agisca 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 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 CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato.
forbidden (403) insufficientCapabilities L'utente 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 proprietario dei contenuti specificato non è stato trovato.

Request context errors

Tipo di errore Dettaglio 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 YouTube. Devi rimuovere il parametro mine, eseguire l'autenticazione come utente 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 non collegato, il che significa che l'utente ha un Account Google, ma non un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, ad esempio valutare i video o aggiungerli a una playlist watch_later. Tuttavia, ad esempio, l'utente avrebbe bisogno di 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 spesso se provi a utilizzare il flusso dell'account di servizio OAuth 2.0. YouTube non supporta i service account e, se tenti di eseguire l'autenticazione utilizzando un service account, riceverai questo errore.

Il post del blog dell'API YouTube che introduce il supporto dell'Account Google descrive 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à

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

activities.list

Tipo di errore Dettaglio errore Descrizione
forbidden (403) homeParameterDeprecated I dati sull'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 è autorizzata correttamente.
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 autenticato.
unauthorized (401) authorizationRequired La richiesta utilizza il parametro home, ma non è autorizzata correttamente.

sottotitoli

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

captions.delete

Tipo di errore Dettaglio 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 autorizzata correttamente.
notFound (404) captionNotFound Impossibile trovare la traccia dei sottotitoli codificati. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

captions.download

Tipo di errore Dettaglio 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 autorizzata correttamente.
invalidValue (400) couldNotConvert I dati della traccia dei sottotitoli codificati non sono stati convertiti 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 dei sottotitoli codificati. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

captions.insert

Tipo di errore Dettaglio 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 dei sottotitoli codificati con i valori snippet.language e 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 la traccia esistente e poi inserirne una nuova o 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 autorizzata correttamente.
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. Puoi includere anche la proprietà snippet.isDraft, ma non è obbligatoria.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.
invalidValue (400) nameTooLong Il snippet.name specificato nella richiesta è troppo lungo. La lunghezza massima supportata è di 150 caratteri.

captions.list

Tipo di errore Dettaglio errore Descrizione
forbidden (403) forbidden Non è stato possibile 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 correttamente.
notFound (404) captionNotFound Impossibile trovare una o più tracce di sottotitoli codificati specificate. Questo errore si verifica se il parametro videoId identifica un video effettivo, ma il parametro id identifica ID traccia dei sottotitoli codificati 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 Dettaglio 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 autorizzata correttamente.
notFound (404) captionNotFound Impossibile trovare la traccia dei sottotitoli codificati specificata. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

channelBanners

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

channelBanners.insert

Tipo di errore Dettaglio errore Descrizione
badRequest (400) bannerAlbumFull L'album Grafica del canale YouTube contiene troppe immagini. Vai alla pagina http://photos.google.com, accedi alla pagina degli album e rimuovi alcune immagini dall'album.
badRequest (400) mediaBodyRequired La richiesta non include i contenuti dell'immagine.

channelSections

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

channelSections.delete

Tipo di errore Dettaglio errore Descrizione
badRequest (400) notEditable Questa sezione del canale non può essere eliminata.
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 Dettaglio 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 di lingua dell'oggetto localizations non è stata convalidata. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida 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 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 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 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é specificava canali duplicati.
invalidValue (400) channelsNeeded Se la proprietà snippet.type ha un valore pari a multipleChannels, la proprietà contentDetails.channels[] deve essere specificata e deve specificare 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 Per questo tipo di sezione del canale, la risorsa che stai inserendo deve contenere un oggetto contentDetails.
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é tentava di includere troppi canali nella sezione dei canali.
invalidValue (400) maxPlaylistExceeded La richiesta non è andata a buon fine perché tentava di includere troppe playlist nella sezione del canale.
invalidValue (400) onePlaylistNeeded Se la proprietà snippet.type ha il 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 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 è riuscita perché specificava playlist duplicate.
invalidValue (400) playlistsNeeded Se la proprietà snippet.type ha un valore di singlePlaylist o multiplePlaylists, deve essere specificata 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 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 Dettaglio 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 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 Dettaglio 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 di lingua dell'oggetto localizations non è stata convalidata. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida 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 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 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 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é specificava canali duplicati.
invalidValue (400) channelsNeeded Se la proprietà snippet.type ha un valore pari a multipleChannels, la proprietà contentDetails.channels[] deve essere specificata e deve specificare 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 in fase di aggiornamento.
invalidValue (400) inValidPosition La proprietà snippet.position contiene un valore non valido.
invalidValue (400) maxChannelsExceeded La richiesta non è andata a buon fine perché tentava di includere troppi canali nella sezione dei canali.
invalidValue (400) maxPlaylistExceeded La richiesta non è andata a buon fine perché tentava di includere troppe playlist nella sezione del canale.
invalidValue (400) onePlaylistNeeded Se la proprietà snippet.type ha il 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 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 è riuscita perché specificava playlist duplicate.
invalidValue (400) playlistsNeeded Se la proprietà snippet.type ha un valore di singlePlaylist o multiplePlaylists, deve essere specificata 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 Per aggiornare la sezione del canale, devi specificare un snippet.
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 restituiti dall'API in risposta alle chiamate relative alle risorse channels. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni delle richieste.

channels.list

Tipo di errore Dettaglio errore Descrizione
badRequest (400) invalidCriteria Può essere specificato un massimo di 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 è autorizzata correttamente.
notFound (404) categoryNotFound Impossibile trovare la categoria identificata dal parametro categoryId.
notFound (404) channelNotFound Impossibile trovare il canale specificato nel parametro id.

channels.update

Tipo di errore Dettaglio errore Descrizione
badRequest (400) brandingValidationError La convalida di uno dei valori nell'oggetto brandingSettings non è riuscita. Utilizza il metodo channels.list per recuperare le impostazioni esistenti per il canale e aggiorna i valori delle proprietà seguendo le linee guida nella documentazione della risorsa channels.
badRequest (400) channelTitleUpdateForbidden Quando aggiorni brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo attuale 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 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 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 posizionamento dell'articolo promozionale nel video player. Controlla 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. Controlla il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset di temporizzazione non valido nella parte invideoPromotion.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset di temporizzazione non valido per determinare quando l'elemento promozionale deve essere visualizzato nel video player. Controlla 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'elemento promozionale deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla 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 nella documentazione della risorsa canali.
badRequest (400) tooManyPromotedItems Il numero di articoli promossi consentiti è stato superato nella parte invideoPromotion.
forbidden (403) channelForbidden Il canale specificato nel parametro id non supporta la richiesta o la richiesta non è autorizzata correttamente.
forbidden (403) promotedVideoNotAllowed Non è possibile 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 promozionale.
required (400) requiredItemIdType I metadati della richiesta devono specificare un tipo di elemento 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 temporale predefinito in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. 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 temporizzazione in modo che YouTube possa determinare quando visualizzare l'elemento promozionale. 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 visualizzare l'elemento promozionale. 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 visualizzare l'elemento promozionale. 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 della parte invideoPromotion.
required (400) requiredVideoId I metadati della richiesta devono specificare un ID video per identificare l'elemento promozionale.
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 seguenti tabelle identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse commentThreads. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni delle richieste.

commentThreads.list

Tipo di errore Dettaglio 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, 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 I commenti sono disattivati per il video identificato dal parametro videoId.
forbidden (403) forbidden Uno o più thread di commenti richiesti non possono essere recuperati a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) channelNotFound Impossibile trovare il canale identificato dal parametro 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 Dettaglio 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 per le proprietà snippet.channelId e snippet.videoId. Un commento su un video viene visualizzato nella pagina di visualizzazione del video.
badRequest (400) commentTextRequired La risorsa comment che viene 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 correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, 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 Impossibile creare il thread di commenti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) ineligibleAccount L'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente per inserire un commento o un thread di commenti.
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

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

comments.list

Tipo di errore Dettaglio 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 Uno o più commenti richiesti non possono essere recuperati a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
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 Dettaglio 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, di solito indica che l'input della richiesta non è valido.
forbidden (403) forbidden Lo stato di moderazione di uno o più commenti non può essere impostato a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) commentNotFound Non è possibile trovare uno o più commenti che la richiesta sta tentando di aggiornare. Controlla i valori del parametro id della richiesta per assicurarti che siano corretti.

comments.insert

Tipo di errore Dettaglio errore Descrizione
badRequest (400) commentTextRequired La risorsa comment che viene 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 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 attuale 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, 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 correttamente.
forbidden (403) ineligibleAccount L'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente per inserire un commento o un thread di commenti.
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 Dettaglio errore Descrizione
badRequest (400) processingFailure Il server API non è riuscito a elaborare correttamente la richiesta. Sebbene possa trattarsi di un errore transitorio, di solito indica che l'input della richiesta non è valido.
forbidden (403) forbidden Il commento non può essere eliminato a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) commentNotFound Impossibile trovare il commento specificato. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

comments.update

Tipo di errore Dettaglio 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, 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 Il commento non è stato aggiornato a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
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 restituiti dall'API in risposta alle chiamate relative alle risorse members. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni delle richieste.

members.list

Tipo di errore Dettaglio 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 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

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

membershipsLevels.list

Tipo di errore Dettaglio errore Descrizione
badRequest (400) channelMembershipsNotEnabled Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale.

playlistItems

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

playlistItems.delete

Tipo di errore Dettaglio errore Descrizione
forbidden (403) playlistItemsNotAccessible La richiesta non è autorizzata correttamente 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 Dettaglio errore Descrizione
duplicate videoAlreadyInPlaylist Il video che stai cercando di aggiungere alla playlist è già presente.
forbidden (403) playlistContainsMaximumNumberOfVideos La playlist contiene già il numero massimo consentito di elementi.
forbidden (403) playlistItemsNotAccessible La richiesta non è autorizzata correttamente 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 contiene più 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 nel 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 che la richiesta sta inserendo. Se vuoi che l'elemento della playlist occupi una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordinamento della playlist 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à contenuto 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 Il video che stai tentando di aggiungere alla playlist non è stato trovato. Controlla il valore della proprietà videoId per assicurarti che sia corretto.
required (400) channelIdRequired La richiesta non specifica un valore per la proprietà obbligatoria channelId.
required (400) playlistIdRequired La richiesta non specifica un valore per la proprietà obbligatoria playlistId.
required (400) resourceIdRequired La richiesta deve contenere una risorsa in cui l'oggetto snippet specifica un resourceId.

playlistItems.list

Tipo di errore Dettaglio errore Descrizione
forbidden (403) playlistItemsNotAccessible La richiesta non è autorizzata correttamente 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à obbligatoria playlistId.
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 Dettaglio errore Descrizione
forbidden (403) playlistItemsNotAccessible La richiesta non è autorizzata correttamente 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 nel 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 che la richiesta sta inserendo. Se vuoi che l'elemento della playlist occupi una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordinamento della playlist 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 dalla 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à obbligatoria channelId.
required (400) playlistIdRequired La richiesta non specifica un valore per la proprietà obbligatoria playlistId.
required (400) playlistItemIdRequired La risorsa 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 restituiti dall'API in risposta alle chiamate relative alle risorse playlists. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni delle richieste.

playlists.delete

Tipo di errore Dettaglio 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 che hai caricato.

playlists.list

Tipo di errore Dettaglio 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 è 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 Dettaglio 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 nella documentazione della risorsa playlist.
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 è autorizzata correttamente.
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 Dettaglio 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 nella documentazione della risorsa playlist.
forbidden (403) playlistForbidden Questa operazione è vietata o la richiesta non è autorizzata correttamente.
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.

abbonamenti

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

subscriptions.delete

Tipo di errore Dettaglio 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. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

subscriptions.insert

Tipo di errore Dettaglio 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'utente iscritto 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 effettuando l'abbonamento.

subscriptions.list

Tipo di errore Dettaglio errore Descrizione
forbidden (403) accountClosed Impossibile recuperare gli abbonamenti perché l'account dell'abbonato è chiuso.
forbidden (403) accountSuspended Non è stato possibile recuperare gli abbonamenti perché l'account dell'abbonato è sospeso.
forbidden (403) subscriptionForbidden Il richiedente non è autorizzato ad accedere agli abbonamenti richiesti.
notFound (404) subscriberNotFound Impossibile trovare l'utente iscritto identificato con la richiesta.

miniature

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

thumbnails.set

Tipo di errore Dettaglio 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 autorizzata correttamente.
forbidden (403) forbidden L'utente autenticato non dispone delle autorizzazioni per caricare e impostare miniature video personalizzate.
notFound (404) videoNotFound Impossibile trovare il video per cui stai tentando di inserire un'immagine in miniatura. Controlla il valore del parametro videoId della richiesta per assicurarti che sia corretto.
tooManyRequests (429) uploadRateLimitExceeded Di recente il canale ha caricato troppe miniature. Riprova a eseguire la richiesta più tardi.

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

Tipo di errore Dettaglio errore Descrizione
notFound (404) videoCategoryNotFound Impossibile trovare la categoria di 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 restituiti dall'API in risposta alle chiamate relative alle risorse videos. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni delle richieste.

videos.insert

Tipo di errore Dettaglio errore Descrizione
badRequest (400) defaultLanguageNotSet La richiesta sta tentando di aggiungere i 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 video specificato nell'intestazione Slug non è valido.
badRequest (400) invalidPublishAt I metadati della richiesta specificano un orario di pubblicazione pianificata non valido.
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 dei videogiochi 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 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 impostare un'impostazione della privacy non valida per il video.

videos.list

Tipo di errore Dettaglio 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 sulla valutazione 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 cercando di recuperare. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

videos.delete

Tipo di errore Dettaglio errore Descrizione
forbidden (403) forbidden Il video che stai tentando di eliminare non può essere eliminato. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) videoNotFound Impossibile trovare il video che stai tentando di eliminare. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

videos.update

Tipo di errore Dettaglio errore Descrizione
badRequest (400) defaultLanguageNotSet La richiesta API sta tentando di aggiungere dettagli video localizzati senza specificare la lingua predefinita dei dettagli 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 orario di pubblicazione pianificata non valido.
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 le proprietà snippet.title e snippet.categoryId.
forbidden (403) forbidden Accesso vietato. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) forbiddenEmbedSetting La richiesta tenta di impostare un'impostazione di incorporamento non valida per il video. Alcuni canali potrebbero non avere l'autorizzazione per offrire player incorporati per i live streaming. Per saperne di più, 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 Dettaglio errore Descrizione
badRequest (400) emailNotVerified L'utente deve verificare il proprio indirizzo email prima di lasciare una 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 correttamente.
forbidden (403) videoRatingDisabled Il proprietario del video che stai cercando di valutare ha disattivato le valutazioni per quel video.
notFound (404) videoNotFound Impossibile trovare il video che stai tentando di valutare. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

videos.reportAbuse

Tipo di errore Dettaglio 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 Impossibile trovare il video per cui stai tentando di segnalare un abuso.

filigrane

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

watermarks.set

Tipo di errore Dettaglio 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 Non è possibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente o il parametro channelId è impostato su un valore non valido.

watermarks.unset

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