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 per ogni singolo metodo nella documentazione di riferimento del metodo.
Errori generali
Le tabelle seguenti identificano i messaggi di errore dell'API non specifici per un determinato metodo dell'API.
Core API errors
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere correttamente autorizzata. |
quotaExceeded (403) |
quotaExceeded |
La richiesta non può essere completata perché hai superato la quota. |
Common request errors
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
incompatibleParameters |
La richiesta specifica due o più parametri che non possono essere utilizzati nella stessa richiesta. |
badRequest (400) |
invalidFilters |
La richiesta specifica un parametro di filtro non valido. |
badRequest (400) |
invalidPageToken |
La richiesta specifica un token di pagina non valido. |
badRequest (400) |
missingRequiredParameter |
Nella richiesta manca un parametro obbligatorio. |
badRequest (400) |
unexpectedParameter |
La richiesta specifica un parametro imprevisto. |
forbidden (403) |
accountDelegationForbidden |
L'utente autenticato non può agire per conto dell'Account Google specificato. |
forbidden (403) |
authenticatedUserAccountClosed |
L'account YouTube dell'utente autenticato è chiuso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo. |
forbidden (403) |
authenticatedUserAccountSuspended |
L'account YouTube dell'utente autenticato è sospeso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo. |
forbidden (403) |
authenticatedUserNotChannel |
Per questa richiesta, l'utente autenticato deve risolvere in un canale, ma non lo fa. Se la richiesta è autenticata e utilizza il parametro di delega onBehalfOfContentOwner , devi impostare anche il parametro onBehalfOfContentOwnerChannel . |
forbidden (403) |
channelClosed |
Il canale identificato nella richiesta è stato chiuso. |
forbidden (403) |
channelNotFound |
Impossibile trovare il canale identificato nella richiesta. |
forbidden (403) |
channelSuspended |
Il canale identificato nella richiesta è stato sospeso. |
forbidden (403) |
cmsUserAccountNotFound |
L'utente del CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato. |
forbidden (403) |
insufficientCapabilities |
L'utente del CMS non dispone di funzionalità sufficienti. |
forbidden (403) |
insufficientPermissions |
Il token OAuth 2.0 fornito per la richiesta specifica ambiti insufficienti per accedere ai dati richiesti. |
notFound (404) |
contentOwnerAccountNotFound |
L'account del proprietario dei contenuti specificato non è stato trovato. |
Request context errors
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
invalidLanguage |
Il valore del parametro hl non specifica un codice lingua valido. |
badRequest (400) |
invalidMine |
L'utilizzo del parametro mine nella richiesta non è supportato. |
badRequest (400) |
invalidMine |
Il parametro mine non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametro mine , autenticarti come utente di YouTube rimuovendo il parametro onBehalfOfContentOwner o agire come uno dei canali del partner fornendo il parametro onBehalfOfContentOwnerChannel , se disponibile per il metodo chiamato. |
badRequest (400) |
invalidPart |
Il parametro part della richiesta specifica alcune parti che non possono essere scritte contemporaneamente. |
badRequest (400) |
invalidRegionCode |
Il parametro regionCode specifica un codice regione non valido. |
badRequest (400) |
unexpectedPart |
Il parametro part della richiesta specifica un valore imprevisto. |
badRequest (400) |
unknownPart |
Il parametro part della richiesta specifica un valore sconosciuto. |
badRequest (400) |
unsupportedLanguageCode |
Il valore del parametro hl non specifica un codice lingua supportato. |
badRequest (400) |
unsupportedRegionCode |
Il parametro regionCode specifica un codice regione non supportato. |
unauthorized (401) |
authorizationRequired |
La richiesta utilizza il parametro mine , ma non è correttamente autorizzata. |
unauthorized (401) |
youtubeSignupRequired |
Questo errore indica che l'utente ha un Account Google scollegato, ovvero un Account Google, ma non ha un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, ad esempio la classificazione dei video o l'aggiunta di video a una playlist watch_later . Tuttavia, ad esempio, l'utente deve avere un canale YouTube per poter caricare un video. Un utente che ha un account Gmail o un dispositivo Android ha sicuramente un Account Google, ma potrebbe non averlo ancora collegato a un canale YouTube.
Questo errore si verifica di solito se provi a utilizzare il flusso dell'account di servizio OAuth 2.0. YouTube non supporta gli account di servizio e, se provi ad autenticarti utilizzando un account di servizio, riceverai questo errore.
Il post del blog sull'API YouTube che introduce il supporto dell'Account Google illustra anche l'errore youtubeSignupRequired in modo più dettagliato. Sebbene il post del blog spieghi l'errore per la versione 2.1 dell'API, il significato dell'errore è ancora applicabile. |
attività
YouTube ha ritirato la funzionalità di bollettino del canale. Il metodo
activities.insert
non è più supportato.
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse activities
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
activities.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
homeParameterDeprecated |
I dati sulle attività della home page dell'utente non sono disponibili tramite questa API. Questo errore può verificarsi se imposti il parametro home su true in una richiesta non autorizzata. |
forbidden (403) |
forbidden |
La richiesta non è correttamente autorizzata. |
notFound (404) |
channelNotFound |
Impossibile trovare l'ID canale identificato dal parametro channelId della richiesta. |
notFound (404) |
homeChannelNotFound |
Non è possibile trovare un feed della home page di YouTube per l'utente attualmente autenticato. |
unauthorized (401) |
authorizationRequired |
La richiesta utilizza il parametro home , ma non è correttamente autorizzata. |
sottotitoli
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse captions
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
captions.delete
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Le autorizzazioni associate alla richiesta non sono sufficienti per eliminare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata. |
notFound (404) |
captionNotFound |
Impossibile trovare la traccia sottotitoli codificati. Verifica che il valore del parametro id della richiesta sia corretto. |
captions.download
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Le autorizzazioni associate alla richiesta non sono sufficienti per scaricare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata. |
invalidValue (400) |
couldNotConvert |
Non è stato possibile convertire i dati della traccia dei sottotitoli codificati nella lingua e/o nel formato richiesti. Assicurati che i valori tfmt e tlang richiesti siano validi e che il snippet.status della traccia dei sottotitoli codificati richiesta non sia failed . |
notFound (404) |
captionNotFound |
Impossibile trovare la traccia sottotitoli codificati. Verifica che il valore del parametro id della richiesta sia corretto. |
captions.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
contentRequired |
La richiesta non contiene i contenuti della traccia dei sottotitoli codificati. |
conflict (409) |
captionExists |
Il video specificato ha già una traccia di sottotitoli codificati con snippet.language e snippet.name . Un video può avere più tracce per la stessa lingua, ma ogni traccia deve avere un nome diverso.
Esistono diversi modi per risolvere l'errore. Puoi eliminare la traccia esistente e inserirne una nuova oppure modificare il nome della nuova traccia prima di inserirla. |
forbidden (403) |
forbidden |
Le autorizzazioni associate alla richiesta non sono sufficienti per caricare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata. |
invalidValue (400) |
invalidMetadata |
La richiesta contiene valori dei metadati non validi, che impediscono la creazione della traccia. Verifica che la richiesta specifichi valori validi per le proprietà snippet.language , snippet.name e snippet.videoId . È possibile includere anche la proprietà snippet.isDraft , ma non è obbligatoria. |
notFound (404) |
videoNotFound |
Impossibile trovare il video identificato dal parametro videoId . |
invalidValue (400) |
nameTooLong |
Il valore snippet.name specificato nella richiesta è troppo lungo. La lunghezza massima supportata è di 150 caratteri. |
captions.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Non è stato possibile recuperare uno o più canali di sottotitoli codificati perché le autorizzazioni associate alla richiesta non sono sufficienti per recuperare le risorse richieste. La richiesta potrebbe non essere correttamente autorizzata. |
notFound (404) |
captionNotFound |
Impossibile trovare uno o più canali di sottotitoli codificati specificati. Questo errore si verifica se il parametro videoId identifica un video reale, ma il parametro id identifica ID traccia dei sottotitoli codificati che non esistono o ID traccia associati ad altri video. Verifica che i valori dei parametri id e videoId della richiesta siano corretti. |
notFound (404) |
videoNotFound |
Impossibile trovare il video identificato dal parametro videoId . |
captions.update
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
contentRequired |
La richiesta non ha caricato un file di sottotitoli codificati aggiornato. I contenuti effettivi della traccia sono obbligatori se il parametro sync è impostato su true . |
forbidden (403) |
forbidden |
Le autorizzazioni associate alla richiesta non sono sufficienti per aggiornare la traccia dei sottotitoli codificati. La richiesta potrebbe non essere correttamente autorizzata. |
notFound (404) |
captionNotFound |
Impossibile trovare la traccia sottotitoli codificati specificata. Verifica che il valore del parametro id della richiesta sia corretto. |
channelBanners
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channelBanners
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
channelBanners.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
bannerAlbumFull |
L'album della grafica del canale YouTube contiene troppe immagini. Vai all'indirizzo http://photos.google.com, vai alla pagina degli album e rimuovi alcune immagini dall'album. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
channelSections
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channelSections
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
channelSections.delete
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
notEditable |
Impossibile eliminare questa sezione del canale. |
forbidden (403) |
channelSectionForbidden |
La richiesta non è autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
idInvalid |
La proprietà id specifica un ID sezione del canale non valido. |
invalidValue (400) |
idRequired |
La proprietà id deve specificare un valore che identifichi la sezione del canale da eliminare. |
notFound (404) |
channelNotFound |
Il canale non è stato trovato. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale che stai tentando di aggiornare. |
channelSections.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSetError |
La proprietà snippet.defaultLanguage della risorsa channelSection deve essere impostata per inserire o aggiornare correttamente l'oggetto localizations per la risorsa. |
badRequest (400) |
invalidLanguage |
La convalida di una delle chiavi di lingua dell'oggetto localizations non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Impossibile creare questa sezione del canale. |
badRequest (400) |
styleRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno dei valori nell'elenco targeting.countries non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno dei valori nell'elenco targeting.languages non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno dei valori nell'elenco targeting.regions non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La richiesta non è autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
channelNotActive |
Almeno uno dei canali specificati non è attivo. |
invalidValue (400) |
channelsDuplicated |
La richiesta non è andata a buon fine perché sono stati specificati canali duplicati. |
invalidValue (400) |
channelsNeeded |
Se la proprietà snippet.type ha un valore multipleChannels , deve essere specificata la proprietà contentDetails.channels[] e deve essere specificato almeno un canale. |
invalidValue (400) |
channelsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.channels[] , ma i canali non sono previsti per questo tipo di sezione del canale. |
invalidValue (400) |
contentDetailsNeeded |
La risorsa che stai inserendo deve contenere un oggetto contentDetails per questo tipo di sezione del canale. |
invalidValue (400) |
inValidPosition |
La proprietà snippet.position contiene un valore non valido. |
invalidValue (400) |
maxChannelSectionExceeded |
La richiesta non può essere completata perché il canale ha già il numero massimo di sezioni. |
invalidValue (400) |
maxChannelsExceeded |
La richiesta non è andata a buon fine perché è stato tentato di includere troppi canali nella sezione dei canali. |
invalidValue (400) |
maxPlaylistExceeded |
La richiesta non è andata a buon fine perché è stato tentato di includere troppe playlist nella sezione del canale. |
invalidValue (400) |
onePlaylistNeeded |
Se la proprietà snippet.type ha un valore singlePlaylist , la proprietà contentDetails.playlists[] deve specificare esattamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
Non puoi includere il tuo canale in una sezione del canale che viene visualizzata sul canale in questione. |
invalidValue (400) |
playlistIsPrivate |
Una o più delle playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale. |
invalidValue (400) |
playlistsDuplicated |
La richiesta non è andata a buon fine perché sono state specificate playlist duplicate. |
invalidValue (400) |
playlistsNeeded |
Se la proprietà snippet.type ha un valore singlePlaylist o multiplePlaylists , è necessario specificare la proprietà contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.playlists[] , ma le playlist non sono previste per questo tipo di sezione del canale. |
invalidValue (400) |
snippetNeeded |
Devi specificare un snippet per creare la sezione del canale. |
invalidValue (400) |
titleLengthExceeded |
Il valore della proprietà snippet.title è troppo lungo. |
invalidValue (400) |
titleRequired |
Se la proprietà snippet.type ha un valore multiplePlaylists o multipleChannels , devi impostare il titolo della sezione specificando un valore per la proprietà snippet.title . |
notFound (404) |
channelNotFound |
Non è possibile trovare uno o più dei canali specificati. |
notFound (404) |
playlistNotFound |
Non è possibile trovare una o più delle playlist specificate. |
channelSections.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
channelSectionForbidden |
L'utente che ha effettuato la richiesta non è autorizzato ad accedere alle sezioni del canale richieste. |
invalidValue (400) |
idInvalid |
La richiesta specifica un ID sezione del canale non valido. |
invalidValue (400) |
invalidCriteria |
Impossibile completare la richiesta perché i criteri di filtro non sono validi. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale associato alla richiesta. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale associata alla richiesta. |
channelSections.update
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSetError |
La proprietà snippet.defaultLanguage della risorsa channelSection deve essere impostata per inserire o aggiornare correttamente l'oggetto localizations per la risorsa. |
badRequest (400) |
invalidLanguage |
La convalida di una delle chiavi di lingua dell'oggetto localizations non è riuscita. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Questa sezione del canale non può essere modificata. |
badRequest (400) |
styleRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno dei valori nell'elenco targeting.countries non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno dei valori nell'elenco targeting.languages non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno dei valori nell'elenco targeting.regions non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida riportate nella documentazione della risorsa a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La richiesta non è autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
channelNotActive |
Almeno uno dei canali specificati non è attivo. |
invalidValue (400) |
channelsDuplicated |
La richiesta non è andata a buon fine perché sono stati specificati canali duplicati. |
invalidValue (400) |
channelsNeeded |
Se la proprietà snippet.type ha un valore multipleChannels , deve essere specificata la proprietà contentDetails.channels[] e deve essere specificato almeno un canale. |
invalidValue (400) |
channelsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.channels[] , ma i canali non sono previsti per questo tipo di sezione del canale. |
invalidValue (400) |
contentDetailsNeeded |
La risorsa che stai aggiornando deve contenere un oggetto contentDetails per questo tipo di sezione del canale. |
invalidValue (400) |
idInvalid |
La proprietà id specifica un ID sezione del canale non valido. |
invalidValue (400) |
idRequired |
La proprietà id deve specificare un valore che identifichi la sezione del canale da aggiornare. |
invalidValue (400) |
inValidPosition |
La proprietà snippet.position contiene un valore non valido. |
invalidValue (400) |
maxChannelsExceeded |
La richiesta non è andata a buon fine perché è stato tentato di includere troppi canali nella sezione dei canali. |
invalidValue (400) |
maxPlaylistExceeded |
La richiesta non è andata a buon fine perché è stato tentato di includere troppe playlist nella sezione del canale. |
invalidValue (400) |
onePlaylistNeeded |
Se la proprietà snippet.type ha un valore singlePlaylist , la proprietà contentDetails.playlists[] deve specificare esattamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
Non puoi includere il tuo canale in una sezione del canale che viene visualizzata sul canale in questione. |
invalidValue (400) |
playlistIsPrivate |
Una o più delle playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale. |
invalidValue (400) |
playlistsDuplicated |
La richiesta non è andata a buon fine perché sono state specificate playlist duplicate. |
invalidValue (400) |
playlistsNeeded |
Se la proprietà snippet.type ha un valore singlePlaylist o multiplePlaylists , è necessario specificare la proprietà contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.playlists[] , ma le playlist non sono previste per questo tipo di sezione del canale. |
invalidValue (400) |
snippetNeeded |
Devi specificare un snippet per aggiornare la sezione del canale. |
invalidValue (400) |
titleLengthExceeded |
Il valore della proprietà snippet.title è troppo lungo. |
invalidValue (400) |
titleRequired |
Se la proprietà snippet.type ha un valore multiplePlaylists o multipleChannels , devi impostare il titolo della sezione specificando un valore per la proprietà snippet.title . |
notFound (404) |
channelNotFound |
Non è possibile trovare uno o più dei canali specificati. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale che stai tentando di aggiornare. |
notFound (404) |
playlistNotFound |
Non è possibile trovare una o più delle playlist specificate. |
canali
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse channels
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
channels.list
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
invalidCriteria |
È possibile specificare al massimo uno dei seguenti filtri:id , mySubscribers , categoryId , mine , managedByMe , forUsername . In caso di autenticazione del proprietario dei contenuti tramite il parametro onBehalfOfContentOwner , è possibile specificare solo id o managedByMe . |
forbidden (403) |
channelForbidden |
Il canale specificato dal parametro id non supporta la richiesta o la richiesta non è correttamente autorizzata. |
notFound (404) |
categoryNotFound |
Impossibile trovare la categoria identificata dal parametro categoryId . Utilizza il metodo guideCategories.list per recuperare un elenco di valori validi. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro id . |
channels.update
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
brandingValidationError |
La convalida di uno dei valori dell'oggetto brandingSettings non è riuscita. Utilizza il metodo channels.list per recuperare le impostazioni esistenti del canale e aggiornare i valori delle proprietà seguendo le linee guida riportate nella documentazione della risorsa channels . |
badRequest (400) |
channelTitleUpdateForbidden |
Quando aggiorni il brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo corrente del canale o omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà. |
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per aggiornare localizations . |
badRequest (400) |
invalidBrandingOption |
Una delle impostazioni di branding specificate non esiste. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa channels . |
badRequest (400) |
invalidCustomMessage |
I metadati della richiesta specificano un messaggio personalizzato non valido. Controlla il valore della proprietà invideoPromotion.items[].customMessage nella risorsa a cui è stata inviata la richiesta. |
badRequest (400) |
invalidDuration |
I metadati della richiesta specificano una durata non valida nella parte invideoPromotion. |
badRequest (400) |
invalidDuration |
I metadati della richiesta specificano un tipo di posizione non valido per determinare la posizione dell'elemento promosso nel video player. Controlla il valore della proprietà invideoPromotion.position.type nella risorsa a cui è stata inviata la richiesta. |
badRequest (400) |
invalidRecentlyUploadedBy |
I metadati della richiesta specificano un ID canale non valido. Controlla il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa a cui è stata inviata la richiesta. |
badRequest (400) |
invalidTimingOffset |
I metadati della richiesta specificano un offset dei tempi non valido nella parte invideoPromotion. |
badRequest (400) |
invalidTimingOffset |
I metadati della richiesta specificano un offset dei tempi non valido per determinare quando l'elemento in promozione deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa a cui è stata inviata la richiesta. |
badRequest (400) |
invalidTimingType |
I metadati della richiesta specificano un metodo di temporizzazione non valido per determinare quando l'elemento in promozione deve essere visualizzato nel video player. Controlla il valore della proprietà invideoPromotion.timing.type nella risorsa a cui è stata inviata la richiesta. |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa canali. |
badRequest (400) |
tooManyPromotedItems |
Numero di elementi promossi consentiti superato nella parte invideoPromotion. |
forbidden (403) |
channelForbidden |
Il canale specificato nel parametro id non supporta la richiesta o la richiesta non è correttamente autorizzata. |
forbidden (403) |
promotedVideoNotAllowed |
Impossibile trovare il canale che la richiesta API sta tentando di aggiornare. Controlla il valore della proprietà id nella risorsa channel inviata dalla richiesta per assicurarti che l'ID canale sia corretto. |
forbidden (403) |
websiteLinkNotAllowed |
L'URL del sito web specificato non è consentito. |
notFound (404) |
channelNotFound |
Il canale specificato dal parametro id non è stato trovato o non dispone di opzioni di branding. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro id . |
notFound (404) |
unknownChannelId |
L'ID canale specificato non è stato trovato. |
notFound (404) |
unknownChannelId |
L'ID canale recentlyUploadedBy specificato non è stato trovato. |
notFound (404) |
unknownVideoId |
Impossibile trovare l'ID video specificato come elemento in evidenza. |
required (400) |
requiredItemIdType |
I metadati della richiesta devono specificare un tipo di articolo nella parte invideoPromotion. |
required (400) |
requiredItemId |
I metadati della richiesta devono specificare un elemento nella parte invideoPromotion. |
required (400) |
requiredTimingOffset |
I metadati della richiesta devono specificare un offset dei tempi predefinito in modo che YouTube possa determinare quando mostrare l'elemento promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.offsetMs nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingOffset |
I metadati della richiesta devono specificare un offset dei tempi in modo che YouTube possa determinare quando mostrare l'elemento in promozione. Imposta il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingType |
I metadati della richiesta devono specificare un metodo di temporizzazione in modo che YouTube possa determinare quando mostrare l'elemento promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.type nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingType |
I metadati della richiesta devono specificare un metodo di temporizzazione in modo che YouTube possa determinare quando mostrare l'elemento promosso. Imposta il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta. |
required (400) |
requiredTiming |
I metadati della richiesta devono specificare un'ora per ogni elemento nella parte invideoPromotion . |
required (400) |
requiredVideoId |
I metadati della richiesta devono specificare un ID video per identificare l'articolo promosso. |
required (400) |
requiredWebsiteUrl |
I metadati della richiesta devono specificare un URL del sito web nella parte invideoPromotion. Imposta il valore della proprietà invideoPromotion.items[].id.websiteUrl nella risorsa inviata dalla richiesta. |
membri
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse members
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
members.list
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
channelMembershipsNotEnabled |
Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale. |
badRequest (400) |
invalidMode |
Il valore del parametro mode non è valido.
Questo errore potrebbe verificarsi se il parametro pageToken
specifica un token recuperato utilizzando una modalità diversa da quella specificata. |
badRequest (400) |
invalidPageToken |
Il valore del parametro pageToken non è valido. Questo errore si verifica se il token pagina utilizzato nella richiesta è scaduto. |
badRequest (400) |
invalidHasAccessToLevel |
Il valore del parametro hasAccessToLevel
non è valido. Non esiste un livello con il valore id specificato. |
badRequest (400) |
invalidFilterByMemberChannelId |
Il valore del parametro filterByMemberChannelId
non è valido. Questo errore si verifica se il
valore del parametro filterByMemberChannelId
specifica più di 100 canali. |
membershipsLevels
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse members
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
membershipsLevels.list
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
channelMembershipsNotEnabled |
Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale. |
playlistItems
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse playlistItems
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
playlistItems.delete
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è autorizzata correttamente per eliminare l'elemento della playlist specificato. |
notFound (404) |
playlistItemNotFound |
Impossibile trovare l'elemento della playlist identificato con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di eliminare i video dalla playlist specificata. Ad esempio, non puoi eliminare un video dalla playlist dei video caricati. |
playlistItems.insert
Tipo di errore |
Dettagli errore |
Descrizione |
duplicate |
videoAlreadyInPlaylist |
Il video che stai cercando di aggiungere alla playlist è già presente al suo interno. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
La playlist contiene già il numero massimo di elementi consentito. |
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è correttamente autorizzata a inserire l'elemento della playlist specificato. |
invalidValue (400) |
invalidContentDetails |
La proprietà contentDetails nella richiesta non è valida. Un possibile motivo è che il campo contentDetails.note è più lungo di 280 caratteri. |
invalidValue (400) |
invalidPlaylistItemPosition |
La richiesta tenta di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà position in snippet della risorsa. |
invalidValue (400) |
invalidResourceType |
Il valore type specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio youtube#video . |
invalidValue (400) |
manualSortRequired |
La richiesta tenta di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento snippet.position dalla risorsa inserita dalla richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordine della playlist su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere regolate in Gestione video di YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Il video che stai cercando di aggiungere alla playlist è già presente in un'altra playlist della serie. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di inserire video nella playlist specificata. Ad esempio, non puoi inserire un video nella playlist dei video caricati. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di aggiungere alla playlist. Controlla il valore della proprietà videoId per assicurarti che sia corretto. |
required (400) |
channelIdRequired |
La richiesta non specifica un valore per la proprietà channelId obbligatoria. |
required (400) |
playlistIdRequired |
La richiesta non specifica un valore per la proprietà playlistId obbligatoria. |
required (400) |
resourceIdRequired |
La richiesta deve contenere una risorsa in cui l'oggetto snippet specifica un resourceId . |
playlistItems.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è correttamente autorizzata a recuperare la playlist specificata. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
notFound (404) |
videoNotFound |
Impossibile trovare il video identificato con il parametro videoId della richiesta. |
required (400) |
playlistIdRequired |
La richiesta di iscrizione non specifica un valore per la proprietà playlistId obbligatoria. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di elencare i video nella playlist specificata. Ad esempio, non puoi inserire un video nella playlist Guarda più tardi. |
playlistItems.update
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è correttamente autorizzata ad aggiornare l'elemento della playlist specificato. |
invalidValue (400) |
invalidPlaylistItemPosition |
La richiesta tenta di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà position in snippet della risorsa. |
invalidValue (400) |
invalidResourceType |
Il valore type specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio youtube#video . |
invalidValue (400) |
invalidSnippet |
La richiesta non specifica una proprietà snippet valida. |
invalidValue (400) |
manualSortRequired |
La richiesta tenta di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento snippet.position dalla risorsa inserita dalla richiesta. Se vuoi che l'elemento della playlist abbia una posizione specifica nell'elenco, devi prima aggiornare l'opzione Ordine della playlist su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere regolate in Gestione video di YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di aggiornare i video nella playlist specificata. Ad esempio, non puoi aggiornare un video nella playlist dei video caricati. |
notFound (404) |
playlistItemNotFound |
Impossibile trovare l'elemento della playlist identificato con la proprietà id della richiesta. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
required (400) |
channelIdRequired |
La richiesta non specifica un valore per la proprietà channelId obbligatoria. |
required (400) |
playlistIdRequired |
La richiesta non specifica un valore per la proprietà playlistId obbligatoria. |
required (400) |
playlistItemIdRequired |
La risorsa elemento della playlist specificata nella richiesta deve utilizzare la proprietà id per identificare l'elemento della playlist in fase di aggiornamento. |
playlist
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse playlists
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
playlists.delete
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è correttamente autorizzata. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di eliminare la playlist specificata. Ad esempio, non puoi eliminare la playlist dei video che hai caricato. |
playlists.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
channelClosed |
Il canale specificato nel parametro channelId è stato chiuso. |
forbidden (403) |
channelSuspended |
Il canale specificato nel parametro channelId è stato sospeso. |
forbidden (403) |
playlistForbidden |
La playlist identificata con il parametro id della richiesta non supporta la richiesta o la richiesta non è correttamente autorizzata. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro channelId . |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di elencare la playlist specificata. Ad esempio, non puoi elencare la tua playlist Guarda più tardi. |
playlists.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per aggiornare localizations . |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo playlists.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa Playlists. |
badRequest (400) |
maxPlaylistExceeded |
La playlist non può essere creata perché il canale ha già raggiunto il numero massimo di playlist consentite. |
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è correttamente autorizzata. |
invalidValue (400) |
invalidPlaylistSnippet |
La richiesta fornisce uno snippet di playlist non valido. |
required (400) |
playlistTitleRequired |
La richiesta deve specificare un titolo della playlist. |
playlists.update
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per aggiornare localizations . |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizzazioni non ha superato la convalida. Utilizza il metodo playlists.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione della risorsa Playlists. |
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è correttamente autorizzata. |
invalidValue (400) |
invalidPlaylistSnippet |
La richiesta fornisce uno snippet di playlist non valido. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di aggiornare la playlist specificata. Ad esempio, non puoi aggiornare le proprietà della playlist dei video caricati. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
required (400) |
playlistTitleRequired |
La richiesta deve specificare un titolo della playlist. |
search
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse search
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
search.list
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
invalidChannelId |
Il parametro channelId ha specificato un ID canale non valido. |
badRequest (400) |
invalidLocation |
Il valore del parametro location e/o locationRadius non è formattato correttamente. |
badRequest (400) |
invalidRelevanceLanguage |
Il formato del valore del parametro relevanceLanguage è errato. |
badRequest (400) |
invalidSearchFilter |
La richiesta contiene una combinazione non valida di filtri di ricerca e/o limitazioni. Devi impostare il parametro type su video se imposti un valore per i parametri eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated o videoType . |
abbonamenti
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse subscriptions
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
subscriptions.delete
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
subscriptionForbidden |
La richiesta non è autenticata correttamente o non è supportata per questo canale. |
notFound (404) |
subscriptionNotFound |
Impossibile trovare l'abbonamento che stai tentando di eliminare. Verifica che il valore del parametro id della richiesta sia corretto. |
subscriptions.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
subscriptionDuplicate |
L'abbonamento che stai cercando di creare esiste già. |
badRequest (400) |
subscriptionForbidden |
Hai raggiunto il numero massimo di abbonamenti. |
badRequest (400) |
subscriptionForbidden |
Troppe iscrizioni recenti. Riprova tra qualche ora. |
badRequest (400) |
subscriptionForbidden |
L'iscrizione al tuo canale non è supportata. |
forbidden (403) |
subscriptionForbidden |
La richiesta non è autenticata correttamente o non è supportata per questo canale. |
notFound (404) |
publisherNotFound |
Impossibile trovare la risorsa specificata dalla proprietà snippet.resourceId della richiesta. |
notFound (404) |
subscriberNotFound |
Impossibile trovare l'abbonato identificato con la richiesta. |
required (400) |
publisherRequired |
La risorsa di abbonamento specificata nella richiesta deve utilizzare la proprietà snippet.resourceId per identificare il canale a cui si sta sottoscrivendo l'abbonamento. |
subscriptions.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
accountClosed |
Non è stato possibile recuperare le iscrizioni perché l'account dell'abbonato è chiuso. |
forbidden (403) |
accountSuspended |
Non è stato possibile recuperare le iscrizioni perché l'account dell'abbonato è sospeso. |
forbidden (403) |
subscriptionForbidden |
L'utente che ha effettuato la richiesta non è autorizzato ad accedere agli abbonamenti richiesti. |
notFound (404) |
subscriberNotFound |
Impossibile trovare l'abbonato identificato con la richiesta. |
miniature
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse thumbnails
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
thumbnails.set
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
invalidImage |
I contenuti dell'immagine forniti non sono validi. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
forbidden (403) |
forbidden |
Impossibile impostare la miniatura per il video specificato. La richiesta potrebbe non essere correttamente autorizzata. |
forbidden (403) |
forbidden |
L'utente autenticato non dispone delle autorizzazioni per caricare e impostare miniature dei video personalizzate. |
notFound (404) |
videoNotFound |
Impossibile trovare il video per cui stai tentando di inserire un'immagine in miniatura. Verifica che il valore del parametro videoId della richiesta sia corretto. |
tooManyRequests (429) |
uploadRateLimitExceeded |
Il canale ha caricato troppe miniature di recente. Riprova a inviare la richiesta in un secondo momento. |
videoAbuseReportReasons
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videoAbuseReportReasons
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
videoAbuseReportReasons.list
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere correttamente autorizzata. |
videoCategories
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videoCategories
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
videoCategories.list
Tipo di errore |
Dettagli errore |
Descrizione |
notFound (404) |
videoCategoryNotFound |
Impossibile trovare la categoria video identificata dal parametro id . Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi. |
video
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse videos
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
videos.insert
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSet |
La richiesta tenta di aggiungere dettagli del video localizzati senza specificare la lingua predefinita dei dettagli del video. |
badRequest (400) |
invalidCategoryId |
La proprietà snippet.categoryId specifica un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate. |
badRequest (400) |
invalidDescription |
I metadati della richiesta specificano una descrizione del video non valida. |
badRequest (400) |
invalidFilename |
Il nome del file del video specificato nell'intestazione Slug non è valido. |
badRequest (400) |
invalidPublishAt |
I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida. |
badRequest (400) |
invalidRecordingDetails |
L'oggetto recordingDetails nei metadati della richiesta specifica dettagli di registrazione non validi. |
badRequest (400) |
invalidTags |
I metadati della richiesta specificano parole chiave video non valide. |
badRequest (400) |
invalidTitle |
I metadati della richiesta specificano un titolo del video non valido o vuoto. |
badRequest (400) |
invalidVideoGameRating |
I metadati della richiesta specificano una classificazione del videogioco non valida. |
badRequest (400) |
invalidVideoMetadata |
I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video , ma non imposta un valore sia per le proprietà snippet.title sia per snippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti video. |
badRequest (400) |
uploadLimitExceeded |
L'utente ha superato il numero di video che può caricare. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
La richiesta tenta di impostare una licenza non valida per il video. |
forbidden (403) |
forbiddenPrivacySetting |
La richiesta tenta di impostare un'impostazione della privacy non valida per il video. |
videos.list
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
videoChartNotFound |
La classifica video richiesta non è supportata o non è disponibile. |
forbidden (403) |
forbidden |
La richiesta non è autorizzata correttamente ad accedere al file video o alle informazioni di elaborazione. Le parti fileDetails , processingDetails e suggestions sono disponibili solo per il proprietario del video. |
forbidden (403) |
forbidden |
La richiesta non può accedere alle informazioni sulle valutazioni degli utenti. Questo errore può verificarsi perché la richiesta non è autorizzata correttamente a utilizzare il parametro myRating . |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di recuperare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.delete
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
Il video che stai tentando di eliminare non può essere eliminato. La richiesta potrebbe non essere correttamente autorizzata. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di eliminare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.update
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
defaultLanguageNotSet |
La richiesta API sta tentando di aggiungere dettagli del video localizzati senza specificare la lingua predefinita dei dettagli del video. |
badRequest (400) |
invalidCategoryId |
La proprietà snippet.categoryId specifica un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
La richiesta tenta di impostare un'impostazione della privacy non valida per la trasmissione predefinita. |
badRequest (400) |
invalidDescription |
I metadati della richiesta specificano una descrizione del video non valida. |
badRequest (400) |
invalidPublishAt |
I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida. |
badRequest (400) |
invalidRecordingDetails |
L'oggetto recordingDetails nei metadati della richiesta specifica dettagli di registrazione non validi. |
badRequest (400) |
invalidTags |
I metadati della richiesta specificano parole chiave video non valide. |
badRequest (400) |
invalidTitle |
I metadati della richiesta specificano un titolo del video non valido o vuoto. |
badRequest (400) |
invalidVideoMetadata |
I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video , ma non imposta un valore per entrambe le proprietà snippet.title e snippet.categoryId . |
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere correttamente autorizzata. |
forbidden (403) |
forbiddenEmbedSetting |
La richiesta tenta di impostare un'impostazione di incorporamento non valida per il video. Alcuni canali potrebbero non avere l'autorizzazione a offrire player incorporati per i live streaming. Per ulteriori informazioni, consulta il Centro assistenza YouTube. |
forbidden (403) |
forbiddenLicenseSetting |
La richiesta tenta di impostare una licenza non valida per il video. |
forbidden (403) |
forbiddenPrivacySetting |
La richiesta tenta di impostare un'impostazione della privacy non valida per il video. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di aggiornare. Controlla il valore del campo id nel corpo della richiesta per assicurarti che sia corretto. |
videos.rate
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
emailNotVerified |
L'utente deve verificare il proprio indirizzo email prima di poter valutare. |
badRequest (400) |
invalidRating |
La richiesta conteneva un valore imprevisto per il parametro rating . |
badRequest (400) |
videoPurchaseRequired |
I video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati. |
forbidden (403) |
forbidden |
Il video che stai tentando di valutare non può essere valutato. La richiesta potrebbe non essere correttamente autorizzata. |
forbidden (403) |
videoRatingDisabled |
Il proprietario del video che stai tentando di valutare ha disattivato le valutazioni per quel video. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di valutare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.reportAbuse
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
invalidAbuseReason |
La richiesta conteneva un valore imprevisto per il campo reason_id o una combinazione dei campi reason_id e secondary_reason_id . |
badRequest (400) |
rateLimitExceeded |
L'utente ha inviato troppe richieste in un determinato periodo di tempo. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
Non è possibile trovare il video per cui stai tentando di segnalare un abuso. |
filigrane
Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse watermarks
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.
watermarks.set
Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
imageFormatUnsupported |
L'immagine che hai fornito è in un formato non supportato. |
badRequest (400) |
imageTooTall |
L'immagine che hai fornito è troppo alta. |
badRequest (400) |
imageTooWide |
L'immagine che hai fornito è troppo larga. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
forbidden (403) |
forbidden |
Impossibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere correttamente autorizzata o il parametro channelId potrebbe essere impostato su un valore non valido. |
watermarks.unset
Tipo di errore |
Dettagli errore |
Descrizione |
forbidden (403) |
forbidden |
La filigrana non può essere deselezionata per il canale specificato. La richiesta potrebbe non essere correttamente autorizzata o il parametro channelId potrebbe essere impostato su un valore non valido. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-02-06 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-02-06 UTC."],[[["The YouTube Data API commonly returns errors such as `forbidden (403)` for authorization issues, `badRequest (400)` for invalid requests, and `notFound (404)` for missing resources."],["Specific API methods like `activities`, `captions`, `channelBanners`, `channelSections`, `playlists`, and `videos` have unique error conditions, including missing parameters, content issues, and permission constraints."],["Errors related to channel management, such as creating, deleting, listing, or updating channel sections or playlists, often involve issues with invalid IDs, missing required fields, exceeding limits, or conflicting configurations."],["Comment and comment thread errors can arise from insufficient permissions, disabled commenting, character limits, private comments, or attempting to reply to non-existent parent comments."],["Errors related to video operations may include problems with category IDs, descriptions, titles, privacy settings, invalid licensing, missing content, exceeding upload limits, and improper reporting of abuse."]]],[]]
commenti
comments.markAsSpam
non è più supportato.Le tabelle seguenti identificano i messaggi di errore restituiti dall'API in risposta alle chiamate relative alle risorse
comments
. Questi metodi potrebbero anche restituire gli errori elencati nella sezione Errori comuni delle richieste.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
eparentId
della richiesta siano corretti.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
può essere utilizzato solo se il valore del parametromoderationStatus
èrejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
della richiesta siano corretti.comments.insert
badRequest (400)
commentTextRequired
comment
da inserire deve specificare un valore per la proprietàsnippet.textOriginal
. I commenti non possono essere vuoti.badRequest (400)
commentTextTooLong
comment
che viene inserita contiene troppi caratteri nella proprietàsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. In una risorsacommentThread
, la proprietàsnippet.canReply
indica se lo spettatore corrente può rispondere al thread.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
nel corpo della richiesta API non ha specificato un valore per la proprietàsnippet.parentId
.badRequest (400)
processingFailure
comment
nel corpo della richiesta per assicurarti che sia valida.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
nel corpo della richiesta sia corretto.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
della richiesta sia corretto.comments.update
badRequest (400)
commentTextTooLong
comment
in fase di aggiornamento contiene troppi caratteri nella proprietàsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
nel corpo della richiesta per assicurarti che sia valida.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
nel corpo della richiesta sia corretto.