Implementazione: sottotitoli codificati

Gli esempi seguenti mostrano come utilizzare l'API YouTube Data (v3) per eseguire funzioni relative ai sottotitoli codificati.

Recuperare un elenco di tracce dei sottotitoli codificati per un video

Per recuperare un elenco delle tracce di sottotitoli codificati disponibili per un video specifico, chiama il metodo captions.list. Imposta il valore del parametro videoId sull'ID video di YouTube che identifica in modo univoco il video per cui stai recuperando i sottotitoli codificati. La richiesta deve essere autorizzata utilizzando OAuth 2.0.

La richiesta riportata di seguito recupera un elenco di sottotitoli codificati per un video sul canale YouTube di Google Stories:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list?
part=snippet
&videoId=PRU2ShMzQRg

Per esempi di codice, consulta la documentazione del metodo captions.list.

Creare una traccia sottotitoli codificati

Questa query non può essere testata utilizzando Explorer API perché non supporta la possibilità di caricare file, un requisito per questo metodo.

Puoi utilizzare il metodo captions.insert dell'API per caricare un nuovo canale di sottotitoli codificati per un video. Quando carichi un canale, devi specificare un valore per le seguenti proprietà della risorsa caption:

• snippet.videoId: identifica il video a cui viene aggiunto il canale di sottotitoli codificati.
• snippet.language: la lingua della traccia sottotitoli.
• snippet.name: il nome della traccia di sottotitoli codificati.

Quando carichi una traccia di sottotitoli codificati, sono disponibili le seguenti opzioni aggiuntive:

• Se imposti il parametro sync 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 senza codici di tempo o se sospetti che i codici di tempo nel file non siano corretti e vuoi che YouTube provi a correggerli.

• Se imposti la proprietà snippet.isDraft della risorsa caption su true, il canale non sarà visibile al pubblico.

Per esempi di codice, consulta la documentazione del metodo captions.insert.

Scaricare una traccia sottotitoli codificati

Questa query non può essere testata utilizzando Explorer API perché non supporta la possibilità di scaricare file.

Per scaricare una traccia sottotitoli codificati specifica, chiama il metodo captions.download. Imposta il valore del parametro id sull'ID traccia di sottotitoli codificati di YouTube che identifica in modo univoco la traccia di sottotitoli codificati che stai scaricando. La richiesta deve essere autorizzata utilizzando OAuth 2.0.

L'API v3 supporta le seguenti opzioni:

• Per specificare che un canale di sottotitoli codificati deve essere restituito in un formato specifico, imposta il valore del parametro tfmt in modo da identificare il formato desiderato. La definizione del parametro elenca i valori supportati.

• Per recuperare una traduzione di una traccia sottotitoli codificati, imposta il valore del parametro tlang su un codice lingua ISO 639-1 di due lettere che identifichi la lingua dei sottotitoli codificati desiderata. La traduzione viene generata utilizzando la traduzione automatica, ad esempio Google Traduttore.

Per esempi di codice, consulta la documentazione del metodo captions.download.

Aggiornare una traccia sottotitoli codificati

L'API supporta la possibilità di modificare lo stato di bozza di una traccia dei sottotitoli codificati, caricare una nuova traccia dei sottotitoli codificati per un file o entrambe le operazioni.

Puoi utilizzare Explorer API per verificare la possibilità di modificare lo stato della bozza di un canale. Tuttavia, non puoi utilizzare Explorer API per aggiornare la traccia dei sottotitoli codificati effettiva perché lo strumento non supporta la possibilità di caricare file.

La richiesta riportata di seguito recupera un elenco di sottotitoli codificati per un video sul canale YouTube di Google Stories:

La richiesta aggiorna lo stato della bozza di una traccia dei sottotitoli codificati su true, il che significa che la traccia non sarà visibile pubblicamente. Per completare la richiesta in Esplora API, devi impostare il valore della proprietà id per identificare una traccia di sottotitoli codificati.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update?
part=snippet

Per esempi di codice, consulta la documentazione del metodo captions.update.

Eliminare una traccia di sottotitoli codificati

Questo esempio mostra come eliminare una traccia sottotitoli codificati. L'esempio prevede i seguenti passaggi:

• Passaggio 1: recupera l'ID traccia sottotitoli codificati

  Segui i passaggi precedenti per recuperare un elenco di tracce sottotitoli codificati per un video. L'elenco potrebbe essere utilizzato per visualizzare un elenco di tracce sottotitoli codificati, utilizzando l'ID di ogni traccia come chiave.

• Passaggio 2: elimina la traccia

  Chiama il metodo captions.delete per eliminare un video specifico. Nella richiesta, il parametro id specifica l'ID traccia di sottotitoli codificati della traccia che stai eliminando. La richiesta deve essere autorizzata utilizzando OAuth 2.0. Se stai testando questa query in API Explorer, devi sostituire un ID traccia audio codificato valido per il valore del parametro id.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete?
  id=CAPTION_TRACK_ID