Sfoglia la documentazione
Riferimento API
Scegliere Batch per domande indipendenti con diversi input. Scegliere Bulk per un file di video IDs che tutti hanno bisogno della stessa operazione.
In questa pagina
Scegli con il lavoro che devi fare
La scelta dipende dalla forma del vostro input, non da un numero fisso di elementi. Entrambe le modalità funzionano in background. Per una domanda, utilizzare in tempo reale o asincrona direttamente.
| Il tuo compito | Scegli |
|---|---|
| Cerca diversi argomenti per un briefing giornaliero | Batch: Ogni query ha i suoi termini di ricerca, la posizione o la lingua. |
| Combina i risultati Google e i metadati YouTube in un lavoro di ricerca | Batch: Mescolare le fonti e raccogliere un risultato separato per ogni query. |
| Aggiornare i metadati o raccogliere trascrizioni per un catalogo video | Bulk: Un file video-ID, una sorgente e le stesse opzioni per ogni video. |
| Fornire un elenco di video a un secchio nello stesso formato | Bulk: Utilizzare youtube_download con impostazioni di media condivise e archiviazione di destinazione. |
| Utilizzare diverse impostazioni di output per ogni video | Batch: I parametri per-query possono differire; Bulk applica un set all'intero file. |
Batch: query indipendenti
Invia un oggetto JSON contenente query. Ogni elemento ha una propria fonte, ingresso e param. Utilizzare Batch per ricerche Google, ricerche YouTube, sorgenti miste o video che hanno bisogno di diverse opzioni.
{
"queries": [
{
"source": "google_search",
"query": "open source speech recognition",
"params": {
"num": 5
}
},
{
"source": "youtube_metadata",
"video_id": "dQw4w9WgXcQ",
"params": {}
}
]
}Bulk: un'operazione su un file
Caricare un file UTF-8 con un video YouTube ID per linea. Selezionare una sorgente supportata e una serie di opzioni per l'intero file. Bulk esegue la scansione del file, invia il lavoro all'interno della capacità dell'account e i risultati dei pacchetti in parti scaricabili.
- Scegliere metadati, trascrizione, didascalie, classificazione delle licenze o download. Bulk prende il video IDs; usa Batch per le ricerche di parole chiave.
- Utilizzare un lavoro separato quando la fonte o le opzioni cambiano. Ad esempio, i metadati e le trascrizioni per lo stesso file sono due posti di lavoro Bulk.
- Per i download, fornire lo storage di destinazione e l'accesso del proprietario con il permesso youtube_download. Le righe dei risultati descrivono i supporti consegnati; i file multimediali sono memorizzati nel vostro secchio.
dQw4w9WgXcQ
jNQXAC9IVRwPianifica come raccogliere i risultati
| Responsabile | Batch | Bulk |
|---|---|---|
| Salvare dopo la presentazione | Ogni queries[].id, collegato al suo ingresso originale. Non c'è nessun singolo lavoro Batch ID. | Un lavoro Bulk ID e il file di input invariato. |
| Completamento del tracciato | Ogni lavoro finisce in modo indipendente; un fallimento non descrive l'intero lotto. | Un lavoro esibisce i conti di progresso. i risultati completati sono confezionati, non che ogni video è riuscito. |
| Raccogliere l'output | Recuperare ogni risultato del lavoro completato e mantenere la sua mappatura input-to-ID. | Prenda il manifesto e ogni parte compressa NDJSON. Iscriviti per indice e video_id, non ordine di riga. |
| Riprendi dopo interruzione | Leggi il lavoro salvato IDs prima di considerare nuove presentazioni. | Controllare il Bulk ID salvato. Risolvere pauseReason e riprendere il lavoro se si è fermato. |
Controllare la capacità e il costo prima di iniziare
| Check | Cosa fare per |
|---|---|
| Batch | Il tuo piano maxBatchSize limita le domande per presentazione. Dividere i gruppi più grandi in gruppi più piccoli e rispettare la capacità di lavoro in attesa. |
| Bulk | Fino a 2 GiB per file ID. Il lavoro viene sottoposto gradualmente all'interno della capacità dell'account condivisa; rimuovere i duplicati prima del caricamento. |
| Crediti | Il raggruppamento non è una sola carica. Le query usano i prezzi per-source; i download sono misurati con la dimensione dei dati consegnati. |
| Accesso | La chiave deve consentire ogni fonte richiesta. Controllare i limiti del conto attivo; una prova non è un conto a piena capacità. |