Questo documento identifica i diversi tipi di errori che possono essere restituiti dalle operazioni di YouTube Data API. Puoi anche trovare un elenco degli errori relativi a un singolo metodo nella documentazione di riferimento del metodo in questione.
Errori generali
Le seguenti tabelle identificano i messaggi di errore dell'API non specifici per un determinato metodo API.
Core API errors
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
quotaExceeded (403) |
quotaExceeded |
La richiesta non può essere completata perché hai superato la tua quota. |
Common request errors
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
incompatibleParameters |
La richiesta specifica due o più parametri che non possono essere utilizzati nella stessa richiesta. |
badRequest (400) |
invalidFilters |
La richiesta specifica un parametro di filtro non valido. |
badRequest (400) |
invalidPageToken |
La richiesta specifica un token di pagina non valido. |
badRequest (400) |
missingRequiredParameter |
Nella richiesta manca un parametro obbligatorio. |
badRequest (400) |
unexpectedParameter |
La richiesta specifica un parametro imprevisto. |
forbidden (403) |
accountDelegationForbidden |
L'utente autenticato non può agire per conto dell'Account Google specificato. |
forbidden (403) |
authenticatedUserAccountClosed |
L'account YouTube dell'utente autenticato viene chiuso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo. |
forbidden (403) |
authenticatedUserAccountSuspended |
L'account YouTube dell'utente autenticato è stato sospeso. Se l'utente autenticato agisce per conto di un altro Account Google, questo errore si riferisce a quest'ultimo. |
forbidden (403) |
authenticatedUserNotChannel |
Per questa richiesta, l'utente autenticato deve risolversi in un canale, ma non lo fa. Se la tua richiesta è autenticata e utilizza il parametro di delega onBehalfOfContentOwner , devi impostare anche il parametro onBehalfOfContentOwnerChannel . |
forbidden (403) |
channelClosed |
Il canale identificato nella richiesta è stato chiuso. |
forbidden (403) |
channelNotFound |
Impossibile trovare il canale identificato nella richiesta. |
forbidden (403) |
channelSuspended |
Il canale identificato nella richiesta è stato sospeso. |
forbidden (403) |
cmsUserAccountNotFound |
L'utente CMS non è autorizzato ad agire per conto del proprietario dei contenuti specificato. |
forbidden (403) |
insufficientCapabilities |
L'utente CMS non ha capacità sufficienti. |
forbidden (403) |
insufficientPermissions |
Il token OAuth 2.0 fornito per la richiesta specifica gli ambiti insufficienti per accedere ai dati richiesti. |
notFound (404) |
contentOwnerAccountNotFound |
Impossibile trovare l'account del proprietario dei contenuti specificato. |
Request context errors
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
invalidLanguage |
Il valore del parametro hl non specifica un codice lingua valido. |
badRequest (400) |
invalidMine |
L'utilizzo del parametro mine da parte della richiesta non è supportato. |
badRequest (400) |
invalidMine |
Il parametro mine non può essere utilizzato nelle richieste in cui l'utente autenticato è un partner di YouTube. Devi rimuovere il parametro mine , autenticarti come utente di YouTube rimuovendo il parametro onBehalfOfContentOwner o agire come uno dei canali del partner fornendo il parametro onBehalfOfContentOwnerChannel , se disponibile per il metodo chiamato. |
badRequest (400) |
invalidPart |
Il parametro part della richiesta specifica alcune parti che non possono essere scritte contemporaneamente. |
badRequest (400) |
invalidRegionCode |
Il parametro regionCode specifica un codice regione non valido. |
badRequest (400) |
unexpectedPart |
Il parametro part della richiesta specifica un valore imprevisto. |
badRequest (400) |
unknownPart |
Il parametro part della richiesta specifica un valore sconosciuto. |
badRequest (400) |
unsupportedLanguageCode |
Il valore del parametro hl non specifica un codice lingua supportato. |
badRequest (400) |
unsupportedRegionCode |
Il parametro regionCode specifica un codice regione non supportato. |
unauthorized (401) |
authorizationRequired |
La richiesta utilizza il parametro mine ma non è autorizzata correttamente. |
unauthorized (401) |
youtubeSignupRequired |
Questo errore indica che l'utente ha un Account Google scollegato, il che significa che l'utente ha un Account Google, ma non ha un canale YouTube. Questi utenti possono accedere a molte funzionalità che dipendono dall'autorizzazione dell'utente, come la valutazione dei video o l'aggiunta di video a una playlist di watch_later . Tuttavia, ad esempio, l'utente deve avere un canale YouTube per poter caricare un video. Un utente che ha un account Gmail o un dispositivo Android è sicuro di avere un Account Google, ma potrebbe non averlo già collegato a un canale YouTube.Questo errore si verifica di solito se provi a utilizzare il flusso Account di servizio OAuth 2.0. YouTube non supporta gli account di servizio e, se tenti di autenticarti utilizzando un account di servizio, riceverai questo errore. Il post del blog sull'API di YouTube che presenta l'assistenza per gli Account Google illustra in modo più dettagliato l'errore youtubeSignupRequired . Anche se il post del blog spiega l'errore della versione 2.1 dell'API, il significato dell'errore è comunque applicabile. |
attività
activities.insert
non è più supportato.
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse activities
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
activities.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
I dati relativi alle attività nella home page dell'utente non sono disponibili tramite questa API. Questo errore può verificarsi se imposti il parametro home su true in una richiesta non autorizzata. |
forbidden (403) |
forbidden |
La richiesta non è autorizzata in modo adeguato. |
notFound (404) |
channelNotFound |
Impossibile trovare l'ID canale identificato dal parametro channelId della richiesta. |
notFound (404) |
homeChannelNotFound |
Impossibile trovare un feed della home page di YouTube per l'utente attualmente autenticato. |
unauthorized (401) |
authorizationRequired |
La richiesta utilizza il parametro home ma non è autorizzata correttamente. |
channelBanners
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channelBanners
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
channelBanners.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
bannerAlbumFull |
L'album della grafica del canale YouTube contiene troppe immagini. Vai all'indirizzo http://photos.google.com, vai alla pagina degli album e rimuovi alcune dalle immagini dall'album. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
channelSections
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channelSections
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
channelSections.delete
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
notEditable |
Impossibile eliminare la sezione di questo canale. |
forbidden (403) |
channelSectionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
idInvalid |
La proprietà id specifica un ID sezione del canale non valido. |
invalidValue (400) |
idRequired |
La proprietà id deve specificare un valore che identifichi la sezione del canale che viene eliminata. |
notFound (404) |
channelNotFound |
Canale non trovato. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale che stai tentando di aggiornare. |
channelSections.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
La proprietà snippet.defaultLanguage della risorsa channelSection deve essere impostata per inserire o aggiornare correttamente l'oggetto localizations per quella risorsa. |
badRequest (400) |
invalidLanguage |
Una delle chiavi lingua dell'oggetto localizations non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Impossibile creare la sezione di questo canale. |
badRequest (400) |
styleRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno dei valori dell'elenco targeting.countries non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno dei valori dell'elenco targeting.languages non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno dei valori dell'elenco targeting.regions non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
channelNotActive |
Almeno uno dei canali specificati non è attivo. |
invalidValue (400) |
channelsDuplicated |
La richiesta non è andata a buon fine perché sono stati specificati canali duplicati. |
invalidValue (400) |
channelsNeeded |
Se la proprietà snippet.type ha un valore di multipleChannels , è necessario specificare la proprietà contentDetails.channels[] e almeno un canale. |
invalidValue (400) |
channelsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.channels[] , ma non sono previsti canali per questo tipo di sezione del canale. |
invalidValue (400) |
contentDetailsNeeded |
La risorsa che stai inserendo deve contenere un oggetto contentDetails per questo tipo di sezione di canale. |
invalidValue (400) |
inValidPosition |
La proprietà snippet.position contiene un valore non valido. |
invalidValue (400) |
maxChannelSectionExceeded |
La richiesta non può essere completata perché il canale ha già raggiunto il numero massimo di sezioni del canale. |
invalidValue (400) |
maxChannelsExceeded |
La richiesta non è andata a buon fine perché ha tentato di includere troppi canali nella sezione del canale. |
invalidValue (400) |
maxPlaylistExceeded |
La richiesta non è andata a buon fine perché ha tentato di includere troppe playlist nella sezione del canale. |
invalidValue (400) |
onePlaylistNeeded |
Se la proprietà snippet.type ha un valore di singlePlaylist , la proprietà contentDetails.playlists[] deve specificare esattamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
Non puoi includere il tuo canale in una sezione del canale che appare su quel canale. |
invalidValue (400) |
playlistIsPrivate |
Una o più playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale. |
invalidValue (400) |
playlistsDuplicated |
La richiesta non è andata a buon fine perché contiene playlist duplicate. |
invalidValue (400) |
playlistsNeeded |
Se la proprietà snippet.type ha un valore di singlePlaylist o multiplePlaylists , è necessario specificare la proprietà contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.playlists[] , ma non sono previste playlist per questo tipo di sezione del canale. |
invalidValue (400) |
snippetNeeded |
Devi specificare un snippet per creare la sezione del canale. |
invalidValue (400) |
titleLengthExceeded |
Il valore della proprietà snippet.title è troppo lungo. |
invalidValue (400) |
titleRequired |
Se la proprietà snippet.type ha un valore di multiplePlaylists o multipleChannels , devi impostare il titolo della sezione specificando un valore per la proprietà snippet.title . |
notFound (404) |
channelNotFound |
Impossibile trovare uno o più canali specificati. |
notFound (404) |
playlistNotFound |
Impossibile trovare una o più playlist specificate. |
channelSections.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
channelSectionForbidden |
Il richiedente non è autorizzato ad accedere alle sezioni del canale richieste. |
invalidValue (400) |
idInvalid |
La richiesta specifica un ID sezione del canale non valido. |
invalidValue (400) |
invalidCriteria |
Impossibile completare la richiesta perché i criteri del filtro non sono validi. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale associato alla richiesta. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale associata alla richiesta. |
channelSections.update
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
La proprietà snippet.defaultLanguage della risorsa channelSection deve essere impostata per inserire o aggiornare correttamente l'oggetto localizations per quella risorsa. |
badRequest (400) |
invalidLanguage |
Una delle chiavi lingua dell'oggetto localizations non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Impossibile modificare la sezione di questo canale. |
badRequest (400) |
styleRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno dei valori dell'elenco targeting.countries non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno dei valori dell'elenco targeting.languages non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno dei valori dell'elenco targeting.regions non ha superato la convalida. Utilizza il metodo channelSections.list per recuperare i valori validi e aggiornarli seguendo le linee guida nella documentazione delle risorse di a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
La risorsa channelSection deve specificare un valore per il campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
invalidValue (400) |
channelNotActive |
Almeno uno dei canali specificati non è attivo. |
invalidValue (400) |
channelsDuplicated |
La richiesta non è andata a buon fine perché sono stati specificati canali duplicati. |
invalidValue (400) |
channelsNeeded |
Se la proprietà snippet.type ha un valore di multipleChannels , è necessario specificare la proprietà contentDetails.channels[] e almeno un canale. |
invalidValue (400) |
channelsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.channels[] , ma non sono previsti canali per questo tipo di sezione del canale. |
invalidValue (400) |
contentDetailsNeeded |
La risorsa che stai aggiornando deve contenere un oggetto contentDetails per questo tipo di sezione di canale. |
invalidValue (400) |
idInvalid |
La proprietà id specifica un ID sezione del canale non valido. |
invalidValue (400) |
idRequired |
La proprietà id deve specificare un valore che identifichi la sezione del canale aggiornata. |
invalidValue (400) |
inValidPosition |
La proprietà snippet.position contiene un valore non valido. |
invalidValue (400) |
maxChannelsExceeded |
La richiesta non è andata a buon fine perché ha tentato di includere troppi canali nella sezione del canale. |
invalidValue (400) |
maxPlaylistExceeded |
La richiesta non è andata a buon fine perché ha tentato di includere troppe playlist nella sezione del canale. |
invalidValue (400) |
onePlaylistNeeded |
Se la proprietà snippet.type ha un valore di singlePlaylist , la proprietà contentDetails.playlists[] deve specificare esattamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
Non puoi includere il tuo canale in una sezione del canale che appare su quel canale. |
invalidValue (400) |
playlistIsPrivate |
Una o più playlist specificate sono private e, pertanto, non possono essere incluse nella sezione del canale. |
invalidValue (400) |
playlistsDuplicated |
La richiesta non è andata a buon fine perché contiene playlist duplicate. |
invalidValue (400) |
playlistsNeeded |
Se la proprietà snippet.type ha un valore di singlePlaylist o multiplePlaylists , è necessario specificare la proprietà contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
La risorsa fornita con la richiesta ha specificato un valore per la proprietà contentDetails.playlists[] , ma non sono previste playlist per questo tipo di sezione del canale. |
invalidValue (400) |
snippetNeeded |
Devi specificare un snippet per aggiornare la sezione del canale. |
invalidValue (400) |
titleLengthExceeded |
Il valore della proprietà snippet.title è troppo lungo. |
invalidValue (400) |
titleRequired |
Se la proprietà snippet.type ha un valore di multiplePlaylists o multipleChannels , devi impostare il titolo della sezione specificando un valore per la proprietà snippet.title . |
notFound (404) |
channelNotFound |
Impossibile trovare uno o più canali specificati. |
notFound (404) |
channelSectionNotFound |
Impossibile trovare la sezione del canale che stai tentando di aggiornare. |
notFound (404) |
playlistNotFound |
Impossibile trovare una o più playlist specificate. |
canali
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse channels
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
channels.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
invalidCriteria |
È possibile specificare un massimo di uno dei seguenti filtri:id , mySubscribers , categoryId , mine , managedByMe , forUsername . In caso di autenticazione come proprietario dei contenuti mediante il parametro onBehalfOfContentOwner , è possibile specificare solo id o managedByMe . |
forbidden (403) |
channelForbidden |
Il canale specificato dal parametro id non supporta la richiesta oppure la richiesta non è autorizzata correttamente. |
notFound (404) |
categoryNotFound |
Impossibile trovare la categoria identificata dal parametro categoryId . Utilizza il metodo guideCategories.list per recuperare un elenco di valori validi. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro id . |
channels.update
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
brandingValidationError |
Uno dei valori dell'oggetto brandingSettings non ha superato la convalida. Utilizza il metodo channels.list per recuperare le impostazioni esistenti del canale e aggiorna i valori delle proprietà seguendo le linee guida riportate nella documentazione delle risorse di channels . |
badRequest (400) |
channelTitleUpdateForbidden |
Quando aggiorni il brandingSettings part di un canale, devi impostare il valore della proprietà brandingSettings.channel.title sul titolo corrente del canale oppure omettere la proprietà. L'API restituisce un errore se modifichi il valore della proprietà. |
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per l'aggiornamento di localizations . |
badRequest (400) |
invalidBrandingOption |
Una delle impostazioni di branding specificate non esiste. Utilizza il metodo channels.list per recuperare i valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse di channels . |
badRequest (400) |
invalidCustomMessage |
I metadati della richiesta specificano un messaggio personalizzato non valido. Verifica il valore della proprietà invideoPromotion.items[].customMessage nella risorsa inviata dalla richiesta. |
badRequest (400) |
invalidDuration |
I metadati della richiesta specificano una durata non valida nella parte invideopromotion. |
badRequest (400) |
invalidDuration |
I metadati della richiesta specificano un tipo di posizione non valido per determinare il modo in cui l'elemento promosso viene posizionato nel video player. Verifica il valore della proprietà invideoPromotion.position.type nella risorsa inviata dalla richiesta. |
badRequest (400) |
invalidRecentlyUploadedBy |
I metadati della richiesta specificano un ID canale non valido. Verifica il valore della proprietà invideoPromotion.items[].id.recentlyUploadedBy nella risorsa inviata dalla richiesta. |
badRequest (400) |
invalidTimingOffset |
La richiesta metadati specifica un offset di tempo non valido nella parte invideopromotion. |
badRequest (400) |
invalidTimingOffset |
I metadati della richiesta specificano un offset temporale non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Verifica il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta. |
badRequest (400) |
invalidTimingType |
I metadati della richiesta specificano un metodo di temporizzazione non valido per determinare quando l'articolo promosso deve essere visualizzato nel video player. Verifica il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta. |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo channels.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida riportate nella documentazione delle risorse dei canali. |
badRequest (400) |
tooManyPromotedItems |
È stato superato il numero di articoli promossi consentiti nella parte invideopromotion. |
forbidden (403) |
channelForbidden |
Il canale specificato nel parametro id non supporta la richiesta oppure la richiesta non è autorizzata in modo appropriato. |
forbidden (403) |
promotedVideoNotAllowed |
Impossibile trovare il canale che la richiesta API sta tentando di aggiornare. Controlla il valore della proprietà id nella risorsa channel inviata dalla richiesta per assicurarti che l'ID canale sia corretto. |
forbidden (403) |
websiteLinkNotAllowed |
L'URL del sito web specificato non è consentito. |
notFound (404) |
channelNotFound |
Il canale specificato dal parametro id non è stato trovato o non dispone di opzioni di branding. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro id . |
notFound (404) |
unknownChannelId |
L'ID canale specificato non è stato trovato. |
notFound (404) |
unknownChannelId |
L'ID canale RecentUploadedBy specificato non è stato trovato. |
notFound (404) |
unknownVideoId |
Impossibile trovare l'ID video specificato come articolo promosso. |
required (400) |
requiredItemIdType |
I metadati della richiesta devono specificare un tipo di articolo nella parte invideopromotion. |
required (400) |
requiredItemId |
I metadati della richiesta devono specificare un elemento nella parte invideopromotion. |
required (400) |
requiredTimingOffset |
I metadati della richiesta devono specificare un offset di tempo predefinito in modo che YouTube possa determinare quando visualizzare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.offsetMs nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingOffset |
I metadati della richiesta devono specificare un offset di tempo per consentire a YouTube di determinare quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.timing.offsetMs nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingType |
I metadati della richiesta devono specificare un metodo di tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.defaultTiming.type nella risorsa inviata dalla richiesta. |
required (400) |
requiredTimingType |
I metadati della richiesta devono specificare un metodo di tempo per consentire a YouTube di stabilire quando mostrare l'articolo promosso. Imposta il valore della proprietà invideoPromotion.timing.type nella risorsa inviata dalla richiesta. |
required (400) |
requiredTiming |
I metadati della richiesta devono specificare una tempistica per ogni elemento nella parte invideoPromotion . |
required (400) |
requiredVideoId |
I metadati della richiesta devono specificare un ID video per identificare l'articolo promosso. |
required (400) |
requiredWebsiteUrl |
I metadati della richiesta devono specificare l'URL di un sito web nella parte invideopromotion. Imposta il valore della proprietà invideoPromotion.items[].id.websiteUrl nella risorsa inviata dalla richiesta. |
commentThreads
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse commentThreads
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
commentThreads.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
operationNotSupported |
La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è riuscito a comprendere la richiesta. |
badRequest (400) |
processingFailure |
Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per assicurarti che sia valida. |
forbidden (403) |
commentsDisabled |
Il video identificato dal parametro videoId ha disattivato i commenti. |
forbidden (403) |
forbidden |
Impossibile recuperare uno o più thread di commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale identificato dal parametro allThreadsRelatedToChannelId . |
notFound (404) |
commentThreadNotFound |
Impossibile trovare uno o più thread di commenti specificati. Controlla i valori del parametro id della richiesta per assicurarti che siano corretti. |
notFound (404) |
videoNotFound |
Impossibile trovare il video identificato dal parametro videoId . |
commentThreads.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Ogni thread di commenti deve essere collegato a un canale o a un video. Assicurati che la risorsa specifichi i valori per entrambe le proprietà snippet.channelId e snippet.videoId . Nella pagina di visualizzazione del video viene visualizzato un commento su un video. |
badRequest (400) |
commentTextRequired |
La risorsa comment inserita deve specificare un valore per la proprietà snippet.topLevelComment.snippet.textOriginal . I commenti non possono essere vuoti. |
badRequest (400) |
commentTextTooLong |
La risorsa comment che viene inserita contiene troppi caratteri nella proprietà snippet.topLevelComment.snippet.textOriginal . |
badRequest (400) |
invalidCommentThreadMetadata |
I metadati della richiesta non sono validi. |
badRequest (400) |
processingFailure |
Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per assicurarti che sia valida. |
forbidden (403) |
forbidden |
Autorizzazioni insufficienti. È possibile creare il thread di commenti. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
ineligibleAccount |
Per poter inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato. Controlla il valore della proprietà snippet.channelId per assicurarti che sia corretto. |
notFound (404) |
videoNotFound |
Impossibile trovare il video specificato. Controlla il valore della proprietà snippet.videoId per assicurarti che sia corretto. |
membri
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse members
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
members.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta. |
badRequest (400) |
invalidMode |
Il valore del parametro mode non è valido.
Questo errore può verificarsi se il parametro pageToken specifica un token che è stato recuperato utilizzando una modalità diversa da quella specificata. |
badRequest (400) |
invalidPageToken |
Il valore del parametro pageToken non è valido. Questo errore si verifica se il token di pagina utilizzato nella richiesta è scaduto. |
badRequest (400) |
invalidHasAccessToLevel |
Il valore del parametro hasAccessToLevel non è valido. Non esiste alcun livello con il valore id specificato. |
badRequest (400) |
invalidFilterByMemberChannelId |
Il valore del parametro filterByMemberChannelId non è valido. Questo errore si verifica se il valore del parametro filterByMemberChannelId specifica più di 100 canali. |
membershipsLevels
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse members
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
membershipsLevels.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta. |
playlistItems
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse playlistItems
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
playlistItems.delete
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è autorizzata a eliminare l'elemento della playlist specificato. |
notFound (404) |
playlistItemNotFound |
Impossibile trovare l'elemento della playlist identificato con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di eliminare video dalla playlist specificata. Ad esempio, non puoi eliminare un video dalla playlist dei video caricati. |
playlistItems.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
duplicate |
videoAlreadyInPlaylist |
Il video che stai tentando di aggiungere alla playlist è già presente nella playlist. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
La playlist contiene già il numero massimo consentito di elementi. |
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è autorizzata a inserire l'elemento della playlist specificato. |
invalidValue (400) |
invalidContentDetails |
La proprietà contentDetails nella richiesta non è valida. È possibile che il campo contentDetails.note contenga più di 280 caratteri. |
invalidValue (400) |
invalidPlaylistItemPosition |
La richiesta cerca di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà position in snippet della risorsa. |
invalidValue (400) |
invalidResourceType |
Il valore type specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio youtube#video . |
invalidValue (400) |
manualSortRequired |
La richiesta cerca di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento snippet.position dalla risorsa che sta inserendo nella richiesta. Se vuoi che l'elemento della playlist abbia una posizione particolare nell'elenco, devi prima aggiornare l'opzione Ordine della playlist impostandola su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere modificate in Gestione video di YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Il video che stai cercando di aggiungere alla playlist è già presente in un'altra playlist della serie. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di inserire video nella playlist specificata. Ad esempio, non puoi inserire un video nella playlist dei video caricati. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai cercando di aggiungere alla playlist. Controlla il valore della proprietà videoId per assicurarti che sia corretto. |
required (400) |
channelIdRequired |
La richiesta non specifica un valore per la proprietà channelId obbligatoria. |
required (400) |
playlistIdRequired |
La richiesta non specifica un valore per la proprietà playlistId obbligatoria. |
required (400) |
resourceIdRequired |
La richiesta deve contenere una risorsa in cui l'oggetto snippet specifica un resourceId . |
playlistItems.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è autorizzata a recuperare la playlist specificata. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
notFound (404) |
videoNotFound |
Impossibile trovare il video identificato con il parametro videoId della richiesta. |
required (400) |
playlistIdRequired |
La richiesta di abbonamento non specifica un valore per la proprietà playlistId obbligatoria. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di elencare i video nella playlist specificata. Ad esempio, non puoi elencare un video nella playlist Guarda più tardi. |
playlistItems.update
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
La richiesta non è autorizzata ad aggiornare l'elemento della playlist specificato. |
invalidValue (400) |
invalidPlaylistItemPosition |
La richiesta cerca di impostare la posizione dell'elemento della playlist su un valore non valido o non supportato. Controlla il valore della proprietà position in snippet della risorsa. |
invalidValue (400) |
invalidResourceType |
Il valore type specificato per l'ID risorsa non è supportato per questa operazione. L'ID risorsa identifica l'elemento aggiunto alla playlist, ad esempio youtube#video . |
invalidValue (400) |
invalidSnippet |
La richiesta non specifica una proprietà snippet valida. |
invalidValue (400) |
manualSortRequired |
La richiesta cerca di impostare la posizione dell'elemento della playlist, ma la playlist non utilizza l'ordinamento manuale. Ad esempio, gli elementi della playlist potrebbero essere ordinati per data o popolarità. Puoi risolvere l'errore rimuovendo l'elemento snippet.position dalla risorsa che sta inserendo nella richiesta. Se vuoi che l'elemento della playlist abbia una posizione particolare nell'elenco, devi prima aggiornare l'opzione Ordine della playlist impostandola su Manuale nelle impostazioni della playlist. Queste impostazioni possono essere modificate in Gestione video di YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di aggiornare i video nella playlist specificata. Ad esempio, non puoi aggiornare un video nella playlist dei video caricati. |
notFound (404) |
playlistItemNotFound |
Impossibile trovare l'elemento della playlist identificato con la proprietà id della richiesta. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro playlistId della richiesta. |
required (400) |
channelIdRequired |
La richiesta non specifica un valore per la proprietà channelId obbligatoria. |
required (400) |
playlistIdRequired |
La richiesta non specifica un valore per la proprietà playlistId obbligatoria. |
required (400) |
playlistItemIdRequired |
La risorsa dell'elemento della playlist specificata nella richiesta deve utilizzare la proprietà id per identificare l'elemento della playlist che viene aggiornato. |
playlist
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse playlists
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
playlists.delete
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è autorizzata correttamente. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di eliminare la playlist specificata. Ad esempio, non puoi eliminare la playlist dei video caricati. |
playlists.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
channelClosed |
Il canale specificato nel parametro channelId è stato chiuso. |
forbidden (403) |
channelSuspended |
Il canale specificato nel parametro channelId è stato sospeso. |
forbidden (403) |
playlistForbidden |
La playlist identificata con il parametro id della richiesta non supporta la richiesta oppure quest'ultima non è autorizzata correttamente. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato nel parametro channelId . |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di elencare la playlist specificata. Ad esempio, non puoi elencare la playlist Guarda più tardi. |
playlists.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per l'aggiornamento di localizations . |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo playlists.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse delle playlist. |
badRequest (400) |
maxPlaylistExceeded |
Impossibile creare la playlist perché il canale ha già raggiunto il numero massimo di playlist consentito. |
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è autorizzata correttamente. |
invalidValue (400) |
invalidPlaylistSnippet |
La richiesta fornisce uno snippet della playlist non valido. |
required (400) |
playlistTitleRequired |
La richiesta deve specificare un titolo della playlist. |
playlists.update
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage deve essere impostato per l'aggiornamento di localizations . |
badRequest (400) |
localizationValidationError |
Uno dei valori nell'oggetto localizations non ha superato la convalida. Utilizza il metodo playlists.list per recuperare valori validi e assicurati di aggiornarli seguendo le linee guida nella documentazione delle risorse delle playlist. |
forbidden (403) |
playlistForbidden |
Questa operazione è vietata o la richiesta non è autorizzata correttamente. |
invalidValue (400) |
invalidPlaylistSnippet |
La richiesta fornisce uno snippet della playlist non valido. |
invalidValue (400) |
playlistOperationUnsupported |
L'API non supporta la possibilità di aggiornare la playlist specificata. Ad esempio, non puoi aggiornare le proprietà della playlist dei video caricati. |
notFound (404) |
playlistNotFound |
Impossibile trovare la playlist identificata con il parametro id della richiesta. |
required (400) |
playlistTitleRequired |
La richiesta deve specificare un titolo della playlist. |
search
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse search
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle 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 formato del valore parametro location e/o locationRadius non è corretto. |
badRequest (400) |
invalidRelevanceLanguage |
Il formato del valore parametro relevanceLanguage non è corretto. |
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 seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse subscriptions
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
subscriptions.delete
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
subscriptionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
notFound (404) |
subscriptionNotFound |
Impossibile trovare la sottoscrizione che stai tentando di eliminare. Verifica che il valore del parametro id della richiesta sia corretto. |
subscriptions.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
La sottoscrizione che stai cercando di creare esiste già. |
badRequest (400) |
subscriptionForbidden |
Hai raggiunto il numero massimo di iscrizioni. |
badRequest (400) |
subscriptionForbidden |
Troppe iscrizioni recenti. Riprova fra qualche ora. |
badRequest (400) |
subscriptionForbidden |
L'iscrizione al tuo canale non è supportata. |
forbidden (403) |
subscriptionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
notFound (404) |
publisherNotFound |
Impossibile trovare la risorsa specificata dalla proprietà snippet.resourceId della richiesta. |
notFound (404) |
subscriberNotFound |
Impossibile trovare l'abbonato identificato con la richiesta. |
required (400) |
publisherRequired |
La risorsa di iscrizione specificata nella richiesta deve utilizzare la proprietà snippet.resourceId per identificare il canale a cui è iscritto. |
subscriptions.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
accountClosed |
Impossibile recuperare le iscrizioni perché l'account dell'abbonato è chiuso. |
forbidden (403) |
accountSuspended |
Non è stato possibile recuperare gli abbonamenti perché l'account dell'abbonato è sospeso. |
forbidden (403) |
subscriptionForbidden |
Il richiedente non è autorizzato ad accedere agli abbonamenti richiesti. |
notFound (404) |
subscriberNotFound |
Impossibile trovare l'abbonato identificato con la richiesta. |
miniature
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse thumbnails
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
thumbnails.set
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
invalidImage |
I contenuti dell'immagine fornita non sono validi. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
forbidden (403) |
forbidden |
Impossibile impostare la miniatura per il video specificato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
forbidden |
L'utente autenticato non dispone delle autorizzazioni per caricare e impostare miniature personalizzate dei video. |
notFound (404) |
videoNotFound |
Impossibile trovare il video per il quale stai tentando di inserire un'immagine in miniatura. Verifica che il valore del parametro videoId della richiesta sia corretto. |
tooManyRequests (429) |
uploadRateLimitExceeded |
Il canale ha caricato troppe miniature di recente. Riprova a inviare la richiesta più tardi. |
videoAbuseReportReasons
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videoAbuseReportReasons
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
videoAbuseReportReasons.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
videoCategories
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videoCategories
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
videoCategories.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Impossibile trovare la categoria del video identificata dal parametro id . Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi. |
video
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse videos
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
videos.insert
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
La richiesta sta tentando di aggiungere dettagli localizzati del video senza specificare la lingua predefinita dei dettagli. |
badRequest (400) |
invalidCategoryId |
La proprietà snippet.categoryId specifica un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate. |
badRequest (400) |
invalidDescription |
I metadati della richiesta specificano una descrizione del video non valida. |
badRequest (400) |
invalidFilename |
Il nome file video specificato nell'intestazione Slug non è valido. |
badRequest (400) |
invalidPublishAt |
I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida. |
badRequest (400) |
invalidRecordingDetails |
L'oggetto recordingDetails nei metadati della richiesta specifica dettagli della registrazione non validi. |
badRequest (400) |
invalidTags |
I metadati della richiesta specificano parole chiave del video non valide. |
badRequest (400) |
invalidTitle |
I metadati della richiesta specificano un titolo del video non valido o vuoto. |
badRequest (400) |
invalidVideoGameRating |
I metadati della richiesta specificano una classificazione del videogioco non valida. |
badRequest (400) |
invalidVideoMetadata |
I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video , ma non imposta un valore per entrambe le proprietà snippet.title e snippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti video. |
badRequest (400) |
uploadLimitExceeded |
L'utente ha superato il numero di video che può caricare. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
La richiesta tenta di impostare una licenza non valida per il video. |
forbidden (403) |
forbiddenPrivacySetting |
La richiesta tenta di configurare un'impostazione di privacy non valida per il video. |
videos.list
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
videoChartNotFound |
Il grafico video richiesto non è supportato o non è disponibile. |
forbidden (403) |
forbidden |
La richiesta non dispone dell'autorizzazione necessaria per accedere al file video o alle informazioni relative all'elaborazione. Le parti fileDetails , processingDetails e suggestions sono disponibili solo per il proprietario di quel video. |
forbidden (403) |
forbidden |
La richiesta non può accedere alle informazioni sulla valutazione degli utenti. Questo errore può verificarsi perché la richiesta non è autorizzata a utilizzare il parametro myRating . |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di recuperare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.delete
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
Il video che stai tentando di eliminare non può essere eliminato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di eliminare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.update
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
La richiesta API sta tentando di aggiungere dettagli localizzati del video senza specificare la lingua predefinita dei dettagli del video. |
badRequest (400) |
invalidCategoryId |
La proprietà snippet.categoryId specifica un ID categoria non valido. Utilizza il metodo videoCategories.list per recuperare le categorie supportate. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
La richiesta tenta di configurare un'impostazione di privacy non valida per la trasmissione predefinita. |
badRequest (400) |
invalidDescription |
I metadati della richiesta specificano una descrizione del video non valida. |
badRequest (400) |
invalidPublishAt |
I metadati della richiesta specificano un'ora di pubblicazione pianificata non valida. |
badRequest (400) |
invalidRecordingDetails |
L'oggetto recordingDetails nei metadati della richiesta specifica dettagli della registrazione non validi. |
badRequest (400) |
invalidTags |
I metadati della richiesta specificano parole chiave del video non valide. |
badRequest (400) |
invalidTitle |
I metadati della richiesta specificano un titolo del video non valido o vuoto. |
badRequest (400) |
invalidVideoMetadata |
I metadati della richiesta non sono validi. Questo errore si verifica se la richiesta aggiorna la parte snippet di una risorsa video , ma non imposta un valore per entrambe le proprietà snippet.title e snippet.categoryId . |
forbidden (403) |
forbidden |
Accesso vietato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
forbiddenEmbedSetting |
La richiesta tenta di configurare un'impostazione di incorporamento non valida per il video. Alcuni canali potrebbero non disporre dell'autorizzazione per offrire player incorporati per i live streaming. Consulta il Centro assistenza YouTube per ulteriori informazioni. |
forbidden (403) |
forbiddenLicenseSetting |
La richiesta tenta di impostare una licenza non valida per il video. |
forbidden (403) |
forbiddenPrivacySetting |
La richiesta tenta di configurare un'impostazione di privacy non valida per il video. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai tentando di aggiornare. Controlla il valore del campo id nel corpo della richiesta per assicurarti che sia corretto. |
videos.rate
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
emailNotVerified |
L'utente deve verificare il proprio indirizzo email prima della valutazione. |
badRequest (400) |
invalidRating |
La richiesta conteneva un valore imprevisto per il parametro rating . |
badRequest (400) |
videoPurchaseRequired |
I video a noleggio possono essere valutati solo dagli utenti che li hanno noleggiati. |
forbidden (403) |
forbidden |
Il video che stai cercando di valutare non può essere valutato. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
videoRatingDisabled |
Il proprietario del video che stai tentando di valutare ha disattivato le valutazioni del video in questione. |
notFound (404) |
videoNotFound |
Impossibile trovare il video che stai cercando di valutare. Verifica che il valore del parametro id della richiesta sia corretto. |
videos.reportAbuse
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
invalidAbuseReason |
La richiesta conteneva un valore imprevisto per il campo reason_id o una combinazione di campi reason_id e secondary_reason_id . |
badRequest (400) |
rateLimitExceeded |
L'utente ha inviato troppe richieste in un determinato periodo di tempo. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
Impossibile trovare il video per il quale stai cercando di segnalare un abuso. |
watermarks
Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse watermarks
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.
watermarks.set
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
L'immagine che hai fornito è in un formato non supportato. |
badRequest (400) |
imageTooTall |
L'immagine che hai fornito è troppo alto. |
badRequest (400) |
imageTooWide |
L'immagine che hai fornito è troppo larga. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
forbidden (403) |
forbidden |
Non è possibile impostare la filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente oppure il parametro channelId è impostato su un valore non valido. |
watermarks.unset
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
Non è possibile annullare l'impostazione della filigrana per il canale specificato. La richiesta potrebbe non essere autorizzata correttamente oppure il parametro channelId è impostato su un valore non valido. |
comments
comments.markAsSpam
non è più supportato.Le seguenti tabelle identificano i messaggi di errore che l'API restituisce in risposta alle chiamate relative alle risorse
comments
. Questi metodi potrebbero anche restituire errori elencati nella sezione Errori comuni relativi alle richieste.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
eparentId
della richiesta per assicurarti che 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 per assicurarti che siano corretti.comments.insert
badRequest (400)
commentTextRequired
comment
inserita 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 il visualizzatore 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 per assicurarti che 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 per assicurarti che sia corretto.