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
sutrue
, 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
sutrue
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 risorsacaption
sutrue
, 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 parametroid
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 parametroid
.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete? id=CAPTION_TRACK_ID