YouTube Data API - Errors

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

Errori generali

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

Core API errors

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

Common request errors

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

Request context errors

Tipo di errore Dettagli errore Descrizione
badRequest (400) invalidLanguage Il valore del parametro hl non specifica un codice lingua valido.
badRequest (400) invalidMine L'utilizzo del parametro mine da parte della richiesta non è supportato.
badRequest (400) invalidMine Il parametro mine non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametro mine, autenticarti come utente di YouTube rimuovendo il parametro onBehalfOfContentOwner o agire come uno dei canali del partner fornendo il parametro onBehalfOfContentOwnerChannel, se disponibile per il metodo chiamato.
badRequest (400) invalidPart Il parametro part della richiesta specifica alcune parti che non possono essere scritte contemporaneamente.
badRequest (400) invalidRegionCode Il parametro regionCode specifica un codice regione non valido.
badRequest (400) unexpectedPart Il parametro part della richiesta specifica un valore imprevisto.
badRequest (400) unknownPart Il parametro part della richiesta specifica un valore sconosciuto.
badRequest (400) unsupportedLanguageCode Il valore del parametro hl non specifica un codice lingua supportato.
badRequest (400) unsupportedRegionCode Il parametro regionCode specifica un codice regione non supportato.
unauthorized (401) authorizationRequired La richiesta utilizza il parametro mine ma non è autorizzata correttamente.
unauthorized (401) youtubeSignupRequired Questo errore indica che l'utente ha un Account Google scollegato, il che significa che l'utente ha un Account Google, ma non ha un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, come la valutazione dei video o l'aggiunta di video a una playlist di watch_later. Tuttavia, ad esempio, l'utente deve avere un canale YouTube per poter caricare un video. Un utente che ha un account Gmail o un dispositivo Android è sicuro di avere un Account Google, ma potrebbe non averlo già collegato a un canale YouTube.

Questo errore si verifica di solito se provi a utilizzare il flusso Account di servizio OAuth 2.0. YouTube non supporta gli account di servizio e, se tenti di autenticarti utilizzando un account di servizio, riceverai questo errore.

Il post del blog sull'API di YouTube che presenta l'assistenza per gli Account Google illustra in modo più dettagliato l'errore youtubeSignupRequired. Anche se il post del blog spiega l'errore della versione 2.1 dell'API, il significato dell'errore è comunque applicabile.

attività

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

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

activities.list

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

captions

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

captions.delete

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

captions.download

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

captions.insert

Tipo di errore Dettagli errore Descrizione
badRequest (400) contentRequired La richiesta non include i contenuti della traccia di sottotitoli codificati.
conflict (409) captionExists Il video specificato ha già una traccia di sottotitoli codificati con i snippet.language e i snippet.name indicati. Un video può avere più tracce per la stessa lingua, ma ogni traccia deve avere un nome diverso.

Esistono diversi modi per risolvere l'errore. Puoi eliminare il canale esistente e quindi inserirne uno nuovo oppure modificare il nome della nuova traccia prima di inserirla.
forbidden (403) forbidden Le autorizzazioni associate alla richiesta non sono sufficienti per caricare la traccia di sottotitoli codificati. La richiesta potrebbe non essere autorizzata in modo adeguato.
invalidValue (400) invalidMetadata La richiesta contiene valori di metadati non validi, che impediscono la creazione della traccia. Conferma che la richiesta specifichi valori validi per le proprietà snippet.language, snippet.name e snippet.videoId. Anche la proprietà snippet.isDraft può essere inclusa, ma non è obbligatoria.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.
invalidValue (400) nameTooLong Il valore snippet.name specificato nella richiesta è troppo lungo. La lunghezza massima supportata è di 150 caratteri.

captions.list

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

captions.update

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

channelBanners

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channelBanners. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle 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 dalle immagini dall'album.
badRequest (400) mediaBodyRequired La richiesta non include i contenuti dell'immagine.

channelSections

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

channelSections.delete

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

channelSections.insert

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

channelSections.list

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

channelSections.update

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

canali

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

channels.list

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

channels.update

Tipo di errore Dettagli errore Descrizione
badRequest (400) brandingValidationError Uno dei valori dell'oggetto brandingSettings non ha superato la convalida. Utilizza il metodo channels.list per recuperare le impostazioni esistenti del canale e aggiorna i valori delle proprietà seguendo le linee guida riportate nella documentazione delle risorse di channels.
badRequest (400) channelTitleUpdateForbidden Quando aggiorni il brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo corrente del canale oppure omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà.
badRequest (400) defaultLanguageNotSetError defaultLanguage deve essere impostato per l'aggiornamento di localizations.
badRequest (400) invalidBrandingOption Una delle impostazioni di branding specificate non esiste. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse di channels.
badRequest (400) invalidCustomMessage I metadati della richiesta specificano un messaggio personalizzato non valido. Verifica il valore della proprietà invideoPromotion.items[].customMessage nella risorsa inviata dalla richiesta.
badRequest (400) invalidDuration I metadati della richiesta specificano una durata non valida nella parte invideopromotion.
badRequest (400) invalidDuration I metadati della richiesta specificano un tipo di posizione non valido per determinare il modo in cui l'elemento promosso viene posizionato nel video player. Verifica il valore della proprietà invideoPromotion.position.type nella risorsa inviata dalla richiesta.
badRequest (400) invalidRecentlyUploadedBy I metadati della richiesta specificano un ID canale non valido. Verifica il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingOffset La richiesta metadati specifica un offset di tempo non valido nella parte invideopromotion.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset temporale non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Verifica il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingType I metadati della richiesta specificano un metodo di temporizzazione non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Verifica il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
badRequest (400) localizationValidationError Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo channels.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione delle risorse dei canali.
badRequest (400) tooManyPromotedItems È stato superato il numero di articoli promossi consentiti nella parte invideopromotion.
forbidden (403) channelForbidden Il canale specificato nel parametro id non supporta la richiesta oppure la richiesta non è autorizzata in modo appropriato.
forbidden (403) promotedVideoNotAllowed Impossibile trovare il canale che la richiesta API sta tentando di aggiornare. Controlla il valore della proprietà id nella risorsa channel inviata dalla richiesta per assicurarti che l'ID canale sia corretto.
forbidden (403) websiteLinkNotAllowed L'URL del sito web specificato non è consentito.
notFound (404) channelNotFound Il canale specificato dal parametro id non è stato trovato o non dispone di opzioni di branding.
notFound (404) channelNotFound Impossibile trovare il canale specificato nel parametro id.
notFound (404) unknownChannelId L'ID canale specificato non è stato trovato.
notFound (404) unknownChannelId L'ID canale RecentUploadedBy specificato non è stato trovato.
notFound (404) unknownVideoId Impossibile trovare l'ID video specificato come articolo promosso.
required (400) requiredItemIdType I metadati della richiesta devono specificare un tipo di articolo nella parte invideopromotion.
required (400) requiredItemId I metadati della richiesta devono specificare un elemento nella parte invideopromotion.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset di tempo predefinito in modo che YouTube possa determinare quando visualizzare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.offsetMs nella risorsa inviata dalla richiesta.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset di tempo per consentire a YouTube di determinare quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta.
required (400) requiredTimingType I metadati della richiesta devono specificare un metodo di tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.type nella risorsa inviata dalla richiesta.
required (400) requiredTimingType I metadati della richiesta devono specificare un metodo di tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
required (400) requiredTiming I metadati della richiesta devono specificare una tempistica per ogni elemento nella parte invideoPromotion.
required (400) requiredVideoId I metadati della richiesta devono specificare un ID video per identificare l'articolo promosso.
required (400) requiredWebsiteUrl I metadati della richiesta devono specificare l'URL di un sito web nella parte invideopromotion. Imposta il valore della proprietà invideoPromotion.items[].id.websiteUrl nella risorsa inviata dalla richiesta.

commentThreads

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse commentThreads. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle 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 è riuscito a comprendere la richiesta.
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per assicurarti che sia valida.
forbidden (403) commentsDisabled Il video identificato dal parametro videoId ha disattivato i commenti.
forbidden (403) forbidden Impossibile recuperare uno o più thread di commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
notFound (404) channelNotFound Impossibile trovare il canale identificato dal parametro allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Impossibile trovare uno o più thread di commenti specificati. Controlla i valori del parametro id della richiesta per assicurarti che siano corretti.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.

commentThreads.insert

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

comments

Il metodo comments.markAsSpam non è più supportato.

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse comments. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle 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 è riuscito a comprendere la richiesta.
forbidden (403) forbidden Impossibile recuperare uno o più commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
notFound (404) commentNotFound Impossibile trovare uno o più commenti specificati. Controlla i valori dei parametri id e parentId della richiesta per assicurarti che siano corretti.

comments.setModerationStatus

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

comments.insert

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

comments.delete

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

comments.update

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

membri

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

members.list

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

membershipsLevels

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

membershipsLevels.list

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

playlistItems

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

playlistItems.delete

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

playlistItems.insert

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

playlistItems.list

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

playlistItems.update

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

playlist

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

playlists.delete

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

playlists.list

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

playlists.insert

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

playlists.update

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

abbonamenti

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

subscriptions.delete

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

subscriptions.insert

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

subscriptions.list

Tipo di errore Dettagli errore Descrizione
forbidden (403) accountClosed Impossibile recuperare le iscrizioni perché l'account dell'abbonato è chiuso.
forbidden (403) accountSuspended 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'abbonato identificato con la richiesta.

miniature

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

thumbnails.set

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

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

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

video

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

videos.insert

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

videos.list

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

videos.delete

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

videos.update

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

videos.rate

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

videos.reportAbuse

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

watermarks

Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse watermarks. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle 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 alto.
badRequest (400) imageTooWide L'immagine che hai fornito è troppo larga.
badRequest (400) mediaBodyRequired La richiesta non include i contenuti dell'immagine.
forbidden (403) forbidden Non è possibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente oppure il parametro channelId è impostato su un valore non valido.

watermarks.unset

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