Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Riferimento API

Batch e rinfuse

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 compitoScegli
Cerca diversi argomenti per un briefing giornalieroBatch: 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 ricercaBatch: Mescolare le fonti e raccogliere un risultato separato per ogni query.
Aggiornare i metadati o raccogliere trascrizioni per un catalogo videoBulk: Un file video-ID, una sorgente e le stesse opzioni per ogni video.
Fornire un elenco di video a un secchio nello stesso formatoBulk: Utilizzare youtube_download con impostazioni di media condivise e archiviazione di destinazione.
Utilizzare diverse impostazioni di output per ogni videoBatch: 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.

Ingresso Batch · due diverse attività
{
  "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.

  1. Scegliere metadati, trascrizione, didascalie, classificazione delle licenze o download. Bulk prende il video IDs; usa Batch per le ricerche di parole chiave.
  2. 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.
  3. 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.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Pianifica come raccogliere i risultati

ResponsabileBatchBulk
Salvare dopo la presentazioneOgni 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 tracciatoOgni 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'outputRecuperare 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 interruzioneLeggi 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

CheckCosa fare per
BatchIl 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.
BulkFino a 2 GiB per file ID. Il lavoro viene sottoposto gradualmente all'interno della capacità dell'account condivisa; rimuovere i duplicati prima del caricamento.
CreditiIl raggruppamento non è una sola carica. Le query usano i prezzi per-source; i download sono misurati con la dimensione dei dati consegnati.
AccessoLa chiave deve consentire ogni fonte richiesta. Controllare i limiti del conto attivo; una prova non è un conto a piena capacità.