Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

API-referentie

Batch en bulk

Kies Batch voor onafhankelijke vragen met verschillende ingangen. Kies Bulk voor een bestand van video IDs dat allemaal dezelfde bewerking nodig heeft.

Op deze pagina

Kies door het werk dat u moet doen

De keuze hangt af van de vorm van uw input, niet van een vast aantal items. Beide modi draaien op de achtergrond. Voor één query, gebruik real-time of async direct.

Uw taakKies
Zoek verschillende onderwerpen voor een dagelijkse briefingBatch: Elke zoekopdracht heeft zijn eigen zoektermen, locatie of taal.
Combineer Google resultaten en YouTube metadata in een onderzoekstaakBatch: Meng bronnen en verzamel een apart resultaat voor elke query.
Metadata verversen of transcripten verzamelen voor een videocatalogusBulk: Eén video-ID-bestand, één bron en dezelfde opties voor elke video.
Een lijst van video's in een emmer in hetzelfde formaat afleverenBulk: Gebruik youtube_download met gedeelde mediainstellingen en bestemmingsopslag.
Gebruik verschillende uitvoerinstellingen voor elke videoBatch: Perquery parameters kunnen verschillen; Bulk past één set toe op het hele bestand.

Batch: onafhankelijke queries

Stuur een JSON object met queries. Elk item heeft zijn eigen bron, input en params. Gebruik Batch voor Google zoekopdrachten, YouTube zoekopdrachten, gemengde bronnen of video's die verschillende opties nodig hebben.

Batch input · twee verschillende taken
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: één bewerking boven een bestand

Upload een UTF-8-bestand met één YouTube-video ID per regel. Selecteer één ondersteunde bron en één set opties voor het hele bestand. Bulk scant het bestand, stuurt werk binnen de accountcapaciteit en pakketten resultaten in downloadbare delen.

  1. Kies metadata, transcriptie, bijschriften, licentieclassificatie of download. Bulk neemt video IDs; gebruik Batch voor zoekwoorden.
  2. Een aparte taak gebruiken wanneer de bron of opties veranderen. Bijvoorbeeld, metadata en transcripten voor hetzelfde bestand zijn twee Bulk taken.
  3. Voor downloads, geef bestemmingsopslag en eigenaar toegang met youtube_download toestemming. Resultaat rijen beschrijven geleverde media; mediabestanden worden opgeslagen in uw emmer.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Plan hoe u resultaten verzamelt

VerantwoordelijkheidBatchBulk
Behalve na de indieningElke queries[].id, gekoppeld aan de oorspronkelijke invoer. Er is geen enkele Batch job ID.Eén Bulk-taak ID en het ongewijzigde invoerbestand.
Track voltooidElke taak eindigt onafhankelijk; één fout beschrijft niet de hele partij.Een taak bloot vooruitgang telt. voltooide betekent resultaten zijn verpakt, niet dat elke video geslaagd.
Uitvoer verzamelenHet resultaat van elke voltooide taak ophalen en de input-to-ID-mapping behouden.Haal het manifest en elk gecomprimeerd NDJSON-deel. Sluit je aan op index en video_id, geen rijvolgorde.
Hervatten na onderbrekingLees de bewaarde job IDs alvorens nieuwe inzendingen te overwegen.Controleer de opgeslagen Bulk ID. Oplossen van pauseReason en hervatten van die taak indien gepauzeerd.

Controleer capaciteit en kosten voordat u begint

ControlerenWat te verantwoorden voor
BatchDe maxBatchSize van uw plan beperkt vragen per indiening. Grotere sets splitsen in kleinere groepen en respect hebben voor in afwachting van werkcapaciteit.
BulkTot 2 GiB per ID bestand. Werk wordt ingediend geleidelijk binnen gedeelde rekening capaciteit; verwijder duplicaten voor upload.
CreditsGroeperen is niet één flat charge. Queries gebruiken prijzen per bron; downloads worden gemeten aan de hand van de geleverde gegevensgrootte.
ToegangDe sleutel moet elke gevraagde bron toestaan. Controleer de limieten van het actieve account; een proef is geen account met volledige capaciteit.