Captions: insert

Carica una traccia di sottotitoli codificati.

Questo metodo supporta il caricamento di contenuti multimediali. I file caricati devono rispettare questi vincoli:

  • Dimensioni massime del file: 100 MB
  • Tipi MIME multimediali accettati: text/xml, application/octet-stream, */*

Impatto sulle quote: una chiamata a questo metodo ha un costo della quota di 400 unità.

Casi d'uso comuni

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/upload/youtube/v3/captions

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti. Per scoprire di più sull'autenticazione e sull'autorizzazione, consulta Implementazione dell'autorizzazione OAuth 2.0.

Ambito
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
part string
Il parametro part specifica le parti della risorsa caption che verranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet.

Il seguente elenco contiene i nomi part che puoi includere nel valore del parametro:
  • id
  • snippet
Parametri facoltativi
onBehalfOfContentOwner string
Questo parametro può essere utilizzato solo in una richiesta autorizzata.

Nota: questo parametro è destinato esclusivamente ai partner di contenuti di YouTube.

Il parametro onBehalfOfContentOwner indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. Questo parametro è destinato ai partner di contenuti di YouTube che possiedono e gestiscono molti canali YouTube diversi. Consente ai proprietari di contenuti di autenticarsi una volta sola per accedere a tutti i dati dei video e dei canali, senza dover fornire le credenziali di autenticazione per ogni singolo canale. L'account CMS effettivo con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato.
sync boolean
Questo parametro è stato ritirato. Il parametro sync indica se YouTube deve sincronizzare automaticamente il file dei sottotitoli codificati con la traccia audio del video. Se imposti il valore su true, YouTube ignorerà i codici temporali presenti nel file dei sottotitoli codificati caricato e genererà nuovi codici temporali per i sottotitoli.

Devi impostare il parametro sync su true se carichi una trascrizione che non contiene codici temporali o se sospetti che i codici temporali nel file siano errati e vuoi che YouTube provi a correggerli.

Corpo della richiesta

Fornisci una risorsa caption nel corpo della richiesta. Per questa risorsa:

Devi specificare un valore per queste proprietà:

  • snippet.videoId
  • snippet.language
  • snippet.name

Puoi impostare i valori per le seguenti proprietà:

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa caption nel corpo della risposta.

Errori

La seguente tabella identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la pagina API YouTube Data - Errori.

Tipo di errore Dettaglio 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.

Prova

Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.