Riferimento errori API YouTubeGuida completa alla risoluzione dei problemi con soluzioni

Riferimento completo per gli errori dell'API Dati YouTube. Trova soluzioni per limiti di caricamento, errori di quota, problemi titolo/miniatura e problemi di autenticazione.

11 codici di errore

•

5 categorie

•

Data API v3

← Torna all'Integrazione YouTube View API Documentation

Categorie di Errori

Autenticazione

2 errors

Caricamento

4 errors

Account

1 error

Quota

2 errors

Contenuto

2 errors

Tutti i Codici di Errore

#Autenticazione

invalid_grantrefresh-token

Il token di accesso YouTube è scaduto. Riconnetti il tuo account YouTube.

Soluzione:

Il tuo token di accesso YouTube/Google è scaduto o è stato revocato. Vai nelle impostazioni dell'account e riconnetti il tuo account YouTube per ottenere un nuovo token di accesso.

token has been expired or revokedrefresh-token

Il token di accesso YouTube è scaduto. Riconnetti il tuo account YouTube.

Soluzione:

Il tuo token non è più valido. Ciò può accadere dopo un cambio di password o una revisione della sicurezza. Riconnetti il tuo account YouTube per stabilire una nuova sessione.

#Caricamento

invalidTitleuser-error

Il titolo del video è troppo lungo. I titoli YouTube devono essere di 100 caratteri o meno.

Soluzione:

Accorcia il titolo del tuo video a 100 caratteri o meno. YouTube applica rigorosamente questo limite per tutti i caricamenti video.

failedPreconditionuser-error

La dimensione della miniatura è troppo grande. Usa un'immagine più piccola (max 2MB).

Soluzione:

La tua miniatura personalizzata supera il limite di 2MB di YouTube. Comprimi l'immagine della miniatura a meno di 2MB. La dimensione consigliata è 1280x720 pixel.

youtube.thumbnailuser-error

Il tuo account YouTube non è verificato. Abbiamo caricato il tuo video ma non abbiamo potuto impostare la miniatura. Verifica il tuo account e riprova.

Soluzione:

Gli account YouTube non verificati non possono impostare miniature personalizzate. Verifica il tuo account su youtube.com/verify usando un numero di telefono. Il video è stato caricato con successo.

uploadLimitExceededuser-error

Hai raggiunto il limite di caricamento giornaliero di YouTube. Riprova domani.

Soluzione:

YouTube limita i caricamenti in base allo stato del tuo account. I nuovi account potrebbero essere limitati a 10 caricamenti al giorno. Attendi 24 ore o verifica il tuo account su youtube.com/verify.

#Account

youtubeSignupRequireduser-error

La configurazione del canale YouTube non è completa. Crea un canale YouTube prima di caricare video.

Soluzione:

Devi prima creare un canale YouTube. Vai su youtube.com e clicca su 'Crea un canale'. Segui la procedura guidata di configurazione per completare la creazione del canale.

#Quota

quotaExceededretry

Quota API YouTube superata. Riprova più tardi.

Soluzione:

Hai superato i limiti di quota dell'API YouTube. La quota predefinita è di 10.000 unità al giorno. Attendi che la tua quota si reimposti (mezzanotte ora del Pacifico) o richiedi un aumento della quota a Google.

quotaretry

Quota API YouTube superata. Riprova più tardi.

Soluzione:

L'API Dati YouTube ha quote di utilizzo. Ogni operazione costa unità di quota. Attendi il ripristino della quota o ottimizza il tuo utilizzo dell'API per ridurre il consumo di quota.

#Contenuto

copyrightuser-error

Il video potrebbe contenere contenuti protetti da copyright. Consulta le politiche sul copyright di YouTube.

Soluzione:

YouTube ha rilevato potenziali problemi di copyright. Assicurati di avere i diritti su tutti i contenuti nel tuo video. Consulta le linee guida sul copyright di YouTube e usa musica/filmati esenti da royalty.

content iduser-error

Il video potrebbe contenere contenuti protetti da copyright. Consulta le politiche sul copyright di YouTube.

Soluzione:

Content ID ha abbinato il tuo video a materiale protetto da copyright. Se hai il permesso, puoi contestare il reclamo. Altrimenti, rimuovi il contenuto protetto da copyright e ricarica.

Migliori Pratiche

Gestione degli Errori

→Monitorare utilizzo quota e ottimizzare chiamate API
→Validare lunghezza titolo e dimensione miniatura prima del caricamento
→Gestire requisiti verifica account
→Implementare rilevamento copyright

Suggerimenti per la Prevenzione

→Mantenere titoli sotto 100 caratteri
→Usare miniature sotto 2 MB (1280x720 consigliato)
→Verificare account per miniature personalizzate
→Usare solo contenuto originale o con licenza

Hai Bisogno di Aiuto per YouTube l'Integrazione?

La nostra API gestisce automaticamente gli scenari di errore con logica di riprova intelligente e registrazione dettagliata.

Inizia a Costruire Visualizza Documentazione