YouTube Data API - Errors

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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

Errori generali

Le seguenti tabelle identificano i messaggi di errore 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 correttamente.
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 è 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 risolvere 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 dispone di funzionalità 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 parametro hl non specifica un codice lingua valido.
badRequest (400) invalidMine L'utilizzo del parametro mine nella richiesta non è supportato.
badRequest (400) invalidMine Non è possibile utilizzare il parametro mine 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 richiamato.
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 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 degli utenti, ad esempio la valutazione dei video o l'aggiunta di video a una playlist di watch_later. Tuttavia, l'utente deve avere un canale YouTube per poter caricare un video. È probabile che un utente con un account Gmail o un dispositivo Android disponga di un Account Google, ma non abbia già collegato quell'Account Google a un canale YouTube.

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

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

attività

YouTube ha ritirato la funzionalità Bollettino. 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 restituire anche errori elencati nella sezione Errori comuni.

activities.list

Tipo di errore Dettagli errore Descrizione
forbidden (403) homeParameterDeprecated I dati dell'attività sulla home page dell'utente non sono disponibili tramite questa API. Questo errore potrebbe verificarsi se imposti il parametro home su true in una richiesta non autorizzata.
forbidden (403) forbidden La richiesta non è autorizzata correttamente.
notFound (404) channelNotFound Impossibile trovare l'ID canale identificato dal parametro channelId della richiesta.
notFound (404) homeChannelNotFound 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 restituire anche errori elencati nella sezione Errori comuni.

captions.delete

Tipo di errore Dettagli errore Descrizione
forbidden (403) forbidden Le autorizzazioni associate alla richiesta non sono sufficienti per eliminare la traccia di sottotitoli. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) captionNotFound Impossibile trovare la traccia dei sottotitoli. Controlla il valore del parametro id della richiesta per assicurarti che 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. La richiesta potrebbe non essere autorizzata in modo appropriato oppure l'ordine dei video potrebbe non aver attivato i contributi di terze parti per questo sottotitolo codificato.
invalidValue (400) couldNotConvert Non è stato possibile convertire i dati della traccia dei sottotitoli nella lingua e/o nel formato richiesti. Assicurati che i valori tfmt e tlang richiesti siano validi e che il valore snippet.status della traccia di sottotitoli richiesto non sia failed.
notFound (404) captionNotFound Impossibile trovare la traccia dei sottotitoli. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

captions.insert

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

Esistono più modi per risolvere l'errore. Puoi eliminare la traccia esistente e inserire una nuova traccia o modificarne il nome prima di inserirla.
forbidden (403) forbidden Le autorizzazioni associate alla richiesta non sono sufficienti per caricare la traccia di sottotitoli. La richiesta potrebbe non essere autorizzata correttamente.
invalidValue (400) invalidMetadata La richiesta contiene valori di metadati non validi, che impediscono la creazione della traccia. Conferma che la richiesta specifica valori validi per le proprietà snippet.language, snippet.name e snippet.videoId. Può essere inclusa anche la proprietà snippet.isDraft, ma non è obbligatoria.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.

captions.list

Tipo di errore Dettagli errore Descrizione
forbidden (403) forbidden Impossibile recuperare una o più tracce di sottotitoli perché le autorizzazioni associate alla richiesta non sono sufficienti per recuperare le risorse richieste. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) captionNotFound Impossibile trovare una o più tracce di sottotitoli specificate. Questo errore si verifica se il parametro videoId identifica un video reale, ma il parametro id identifica gli ID tracce dei sottotitoli che non esistono o gli ID delle tracce 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. Il contenuto effettivo della traccia è obbligatorio se il parametro sync è impostato su true.
forbidden (403) forbidden Le autorizzazioni associate alla richiesta non sono sufficienti per aggiornare la traccia di sottotitoli. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) captionNotFound Impossibile trovare la traccia di sottotitoli specificata. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

Banner del canale

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

channelBanners.insert

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

Sezioni del canale

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

channelSections.delete

Tipo di errore Dettagli errore Descrizione
badRequest (400) notEditable Impossibile eliminare questa sezione del canale.
forbidden (403) channelSectionForbidden La richiesta non è stata autenticata o non è supportata per questo canale.
invalidValue (400) idInvalid La proprietà id specifica un ID sezione 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 cercando 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 della lingua dell'oggetto localizations non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse 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 dell'elenco targeting.countries non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Uno dei valori dell'elenco targeting.languages non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Uno dei valori dell'elenco targeting.regions non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse 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 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é ha specificato canali duplicati.
invalidValue (400) channelsNeeded Se la proprietà snippet.type ha un valore multipleChannels, è necessario specificare la proprietà contentDetails.channels[] e specificare 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 di 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à 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 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 visualizzata su quel canale.
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é ha specificato 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 non sono previste playlist per questo tipo di sezione di 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 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 di canale non valido.
invalidValue (400) invalidCriteria La richiesta non può essere completata 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 quella risorsa.
badRequest (400) invalidLanguage Una delle chiavi della lingua dell'oggetto localizations non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Impossibile modificare 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 dell'elenco targeting.countries non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Uno dei valori dell'elenco targeting.languages non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Uno dei valori dell'elenco targeting.regions non è riuscito. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse 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 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é ha specificato canali duplicati.
invalidValue (400) channelsNeeded Se la proprietà snippet.type ha un valore multipleChannels, è necessario specificare la proprietà contentDetails.channels[] e specificare 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 di 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 canale non valido.
invalidValue (400) idRequired La proprietà id deve specificare un valore che identifichi la sezione del canale che viene 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 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 visualizzata su quel canale.
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é ha specificato 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 non sono previste playlist per questo tipo di sezione di canale.
invalidValue (400) snippetNeeded Devi specificare un snippet per aggiornare la sezione 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 Impossibile trovare uno o più canali specificati.
notFound (404) channelSectionNotFound Impossibile trovare la sezione del canale che stai cercando di aggiornare.
notFound (404) playlistNotFound Impossibile trovare una o più playlist specificate.

channels

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

channels.list

Tipo di errore Dettagli errore Descrizione
badRequest (400) invalidCriteria È possibile specificare un massimo di uno dei seguenti filtri:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Nel 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 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 nell'oggetto brandingSettings non è stato convalidato. Utilizza il metodo channels.list per recuperare le impostazioni esistenti del canale e aggiornare i valori delle proprietà seguendo le linee guida nella documentazione delle risorse channels.
badRequest (400) channelTitleUpdateForbidden Quando aggiorni il canale di un brandingSettings part, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo attuale 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 aggiornare localizations.
badRequest (400) invalidBrandingOption Una delle impostazioni di branding specificate non esiste. Utilizza il metodo channels.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse channels.
badRequest (400) invalidCustomMessage I metadati della richiesta specificano un messaggio personalizzato non valido. Controlla il valore della proprietà invideoPromotion.items[].customMessage nella risorsa inviata dalla richiesta.
badRequest (400) invalidDuration I metadati della richiesta specificano una durata non valida nella parte invideoPromozione.
badRequest (400) invalidDuration I metadati della richiesta specificano un tipo di posizione non valido per determinare come viene posizionato l'elemento promosso nel video player. Controlla il valore della proprietà invideoPromotion.position.type nella risorsa inviata dalla richiesta.
badRequest (400) invalidRecentlyUploadedBy I metadati della richiesta specificano un ID canale non valido. Controlla il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset temporale non valido nella parte invideoPromozione.
badRequest (400) invalidTimingOffset I metadati della richiesta specificano un offset di tempo non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta.
badRequest (400) invalidTimingType I metadati della richiesta specificano un metodo di tempo non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta.
badRequest (400) localizationValidationError Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione delle risorse dei canali.
badRequest (400) tooManyPromotedItems Il numero di articoli sponsorizzati consentiti è stato superato nella parte invideoPromozione.
forbidden (403) channelForbidden Il canale specificato nel parametro id non supporta la richiesta oppure la richiesta non è autorizzata correttamente.
forbidden (403) promotedVideoNotAllowed Impossibile trovare il canale che la richiesta API sta tentando di aggiornare. Controlla il valore della proprietà id nella risorsa channel che la richiesta ha inviato per assicurarti che l'ID canale sia corretto.
forbidden (403) websiteLinkNotAllowed L'URL del sito web specificato non è consentito.
notFound (404) channelNotFound Impossibile trovare il canale specificato dal parametro id oppure non sono disponibili opzioni di branding.
notFound (404) channelNotFound Impossibile trovare il canale specificato nel parametro id.
notFound (404) unknownChannelId Impossibile trovare l'ID canale specificato.
notFound (404) unknownChannelId Impossibile trovare l'ID canale "Caricato di recente" specificato.
notFound (404) unknownVideoId Impossibile trovare l'ID video specificato come articolo sponsorizzato.
required (400) requiredItemIdType I metadati della richiesta devono specificare un tipo di elemento nella parte invideoPromozione.
required (400) requiredItemId I metadati della richiesta devono specificare un ID elemento nella parte invideoPromozione.
required (400) requiredTimingOffset I metadati della richiesta devono specificare un offset temporale 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 temporale in modo che YouTube possa stabilire quando visualizzare 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 sincronizzazione in modo che YouTube possa stabilire quando visualizzare 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 sincronizzazione in modo che YouTube possa stabilire quando visualizzare 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'elemento promosso.
required (400) requiredWebsiteUrl I metadati della richiesta devono specificare l'URL di un sito web nella parte invideoPromozione. 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 restituire anche errori elencati nella sezione Errori comuni.

commentThreads.list

Tipo di errore Dettagli errore Descrizione
badRequest (400) operationNotSupported Il filtro ID è compatibile solo con i commenti basati su Google+.
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se può trattarsi 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 correttamente.
notFound (404) channelNotFound Impossibile trovare il canale identificato dal parametro channelId o allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Impossibile trovare uno o più thread di commenti specificati. Controlla i valori del parametro id della richiesta per assicurarti che sia corretto.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.

commentThreads.insert

Tipo di errore Dettagli errore Descrizione
badRequest (400) channelOrVideoIdMissing Ogni thread di commenti deve essere collegato a un canale o a un video.
  • Se il commento si applica a un canale, assicurati che la risorsa specificata nel corpo della richiesta fornisca un valore per la proprietà snippet.channelId. Un commento applicabile a un canale viene visualizzato nella scheda Discussione del canale.
  • Se il commento si applica a un video, assicurati che la risorsa specifichi dei valori per entrambe le proprietà snippet.channelId e snippet.videoId. Un commento valido per un video viene mostrato nella relativa pagina di visualizzazione.
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 può trattarsi 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 Impossibile creare il thread di commenti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) ineligibleAccount Per 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.

commenti

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

comments.list

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

comments.setModerationStatus

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

comments.insert

Tipo di errore 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 può 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 in fase di inserimento 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 può trattarsi 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 correttamente.
forbidden (403) ineligibleAccount Per 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.markAsSpam

Tipo di errore Dettagli errore Descrizione
badRequest (400) operationNotSupported I commenti non basati su Google+ non possono essere contrassegnati come spam.
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se può trattarsi di un errore temporaneo, di solito indica che l'input della richiesta non è valido.
forbidden (403) forbidden Impossibile contrassegnare uno o più commenti come spam a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente.
notFound (404) commentNotFound Impossibile trovare uno o più commenti che la richiesta sta tentando di aggiornare. Controlla i valori nel parametro id della richiesta per assicurarti che siano corretti.

comments.delete

Tipo di errore Dettagli errore Descrizione
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se può trattarsi 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 correttamente.
notFound (404) commentNotFound Impossibile trovare il commento specificato. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

comments.update

Tipo di errore Dettagli errore Descrizione
badRequest (400) commentTextTooLong La risorsa comment in fase di aggiornamento contiene troppi caratteri nella proprietà snippet.textOriginal.
badRequest (400) invalidCommentMetadata I metadati della richiesta non sono validi.
badRequest (400) operationNotSupported È possibile aggiornare solo i commenti basati su Google+.
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se può trattarsi 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 correttamente.
forbidden (403) ineligibleAccount L'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente per aggiornare un commento o un thread di commenti.
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 restituire anche errori elencati nella sezione Errori comuni.

members.list

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

Abbonamenti

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

membershipsLevels.list

Tipo di errore Dettagli errore Descrizione
badRequest (400) channelMembershipsNotEnabled Sul canale del creator che autorizza la richiesta non sono abilitati gli abbonamenti al canale.

playlistItem

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

playlistItems.delete

Tipo di errore Dettagli errore Descrizione
forbidden (403) playlistItemsNotAccessible La richiesta non è autorizzata correttamente a eliminare la playlist specificata.
notFound (404) playlistItemNotFound Impossibile trovare la voce della playlist identificata 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 cercando 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 correttamente a inserire la playlist specificata.
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 nella 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 la richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi innanzitutto aggiornare l'opzione Ordinazione della playlist impostandola su Manuale nelle impostazioni della playlist. Puoi modificare queste impostazioni nella Gestione video di YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Il video che stai cercando di aggiungere alla playlist è già 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 correttamente a recuperare la playlist specificata.
notFound (404) playlistNotFound Impossibile trovare la playlist identificata con il parametro playlistId della richiesta.
notFound (404) videoNotFound Impossibile trovare il video identificato con il parametro videoId della richiesta.
required (400) playlistIdRequired La richiesta di iscrizione non specifica un valore per la proprietà 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 in modo corretto ad aggiornare la playlist specificata.
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 nella 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 la richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi innanzitutto aggiornare l'opzione Ordinazione della playlist impostandola su Manuale nelle impostazioni della playlist. Puoi modificare queste impostazioni nella 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 tua playlist Video caricati.
notFound (404) playlistItemNotFound Impossibile trovare la voce della playlist identificata 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 restituire anche errori elencati nella sezione Errori comuni.

playlists.delete

Tipo di errore Dettagli errore Descrizione
forbidden (403) playlistForbidden Questa operazione non è consentita o la richiesta non è stata debitamente 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 di 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 oppure non è stata 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 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 relativa alle risorse delle playlist.
badRequest (400) maxPlaylistExceeded Non è possibile creare la playlist in quanto il canale ha già raggiunto il numero massimo di playlist consentite.
forbidden (403) playlistForbidden Questa operazione non è consentita o la richiesta non è stata debitamente autorizzata.
invalidValue (400) invalidPlaylistSnippet La richiesta fornisce uno snippet di playlist non valido.
required (400) playlistTitleRequired La richiesta deve specificare il titolo di una 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 relativa alle risorse delle playlist.
forbidden (403) playlistForbidden Questa operazione non è consentita o la richiesta non è stata debitamente 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 di video caricata.
notFound (404) playlistNotFound Impossibile trovare la playlist identificata con il parametro id della richiesta.
required (400) playlistTitleRequired La richiesta deve specificare il titolo di una playlist.

subscriptions

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

subscriptions.delete

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

subscriptions.insert

Tipo di errore 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 Troppi abbonamenti recenti. Riprova fra qualche ora.
badRequest (400) subscriptionForbidden L'iscrizione al tuo canale non è supportata.
forbidden (403) subscriptionForbidden La richiesta non è stata autenticata 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 è stata effettuata l'iscrizione.

subscriptions.list

Tipo di errore Dettagli errore Descrizione
forbidden (403) accountClosed Impossibile recuperare gli abbonamenti perché l'account dell'abbonato è chiuso.
forbidden (403) accountSuspended Impossibile 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 restituire anche errori elencati nella sezione Errori comuni.

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 Non è possibile impostare la miniatura per il video specificato. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) forbidden L'utente autenticato non dispone di autorizzazioni per caricare e impostare miniature video personalizzate.
notFound (404) videoNotFound Impossibile trovare il video per cui stai tentando di inserire una miniatura. Controlla il valore del parametro videoId della richiesta per assicurarti che sia corretto.

VideoAbuseReportMotivi

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

videoAbuseReportReasons.list

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

Categorie video

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

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 seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videos. Questi metodi potrebbero restituire anche errori elencati nella sezione Errori comuni.

videos.insert

Tipo di errore Dettagli errore Descrizione
badRequest (400) defaultLanguageNotSet La richiesta cerca di aggiungere dettagli localizzati ai video senza specificare la lingua predefinita.
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 video non valida.
badRequest (400) invalidFilename Il nome file del video specificato nell'intestazione Slug non è valido.
badRequest (400) invalidPublishAt I metadati della richiesta specificano una data/ora di pubblicazione pianificata non valida.
badRequest (400) invalidRecordingDetails L'oggetto recordingDetails nei metadati della richiesta specifica i dettagli della registrazione non validi.
badRequest (400) invalidTags I metadati della richiesta specificano le parole chiave video non valide.
badRequest (400) invalidTitle I metadati della richiesta specificano un titolo video non valido o vuoto.
badRequest (400) invalidVideoGameRating I metadati della richiesta specificano una classificazione di 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 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 caricato.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting La richiesta cerca di impostare una licenza non valida per il video.
forbidden (403) forbiddenPrivacySetting La richiesta cerca di definire 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 ha l'autorizzazione necessaria per accedere al file video o alle informazioni di elaborazione. Tieni presente che 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 cercando di recuperare. Controlla il valore del parametro id della richiesta per assicurarti che 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 correttamente.
notFound (404) videoNotFound Impossibile trovare il video che stai cercando di eliminare. Controlla il valore del parametro id della richiesta per assicurarti che sia corretto.

videos.update

Tipo di errore Dettagli errore Descrizione
badRequest (400) defaultLanguageNotSet La richiesta API sta provando ad aggiungere dettagli a 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 cerca di configurare un'impostazione di privacy non valida per la trasmissione predefinita.
badRequest (400) invalidDescription I metadati della richiesta specificano una descrizione video non valida.
badRequest (400) invalidPublishAt I metadati della richiesta specificano una data/ora di pubblicazione pianificata non valida.
badRequest (400) invalidRecordingDetails L'oggetto recordingDetails nei metadati della richiesta specifica i dettagli della registrazione non validi.
badRequest (400) invalidTags I metadati della richiesta specificano le parole chiave video non valide.
badRequest (400) invalidTitle I metadati della richiesta specificano un titolo video non valido o vuoto.
badRequest (400) invalidVideoMetadata I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video, ma non imposta un valore per le proprietà snippet.title e snippet.categoryId.
forbidden (403) forbidden Accesso vietato. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) forbiddenEmbedSetting La richiesta cerca di definire un'impostazione di incorporamento non valida per il video. Tieni presente che alcuni canali potrebbero non essere autorizzati a offrire player incorporati per i live streaming. Consulta il Centro assistenza YouTube per ulteriori informazioni.
forbidden (403) forbiddenLicenseSetting La richiesta cerca di impostare una licenza non valida per il video.
forbidden (403) forbiddenPrivacySetting La richiesta cerca di definire un'impostazione di privacy non valida per il video.
notFound (404) videoNotFound Impossibile trovare il video che stai tentando di aggiornare. Verifica che il valore del campo id nel corpo della richiesta 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 classificati solo dagli utenti che li hanno noleggiati.
forbidden (403) forbidden Il video che stai cercando di valutare non può essere valutato. La richiesta potrebbe non essere autorizzata correttamente.
forbidden (403) videoRatingDisabled Il proprietario del video che stai cercando di valutare ha disattivato le classificazioni di quel video.
notFound (404) videoNotFound Impossibile trovare il video che stai cercando di valutare. Controlla il valore del parametro id della richiesta per assicurarti che 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 Impossibile trovare il video per cui stai cercando di segnalare un abuso.

filigrane

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

watermarks.set

Tipo di errore Dettagli errore Descrizione
badRequest (400) imageFormatUnsupported L'immagine che hai fornito è in un formato non supportato.
badRequest (400) imageTooTall L'immagine fornita è troppo alta.
badRequest (400) imageTooWide L'immagine fornita è troppo larga.
badRequest (400) mediaBodyRequired La richiesta non include i contenuti dell'immagine.
forbidden (403) forbidden Non è possibile impostare una 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.