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

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.

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.

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 streaming. 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.