Documentatie bekijken
API-referentie
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 taak | Kies |
|---|---|
| Zoek verschillende onderwerpen voor een dagelijkse briefing | Batch: Elke zoekopdracht heeft zijn eigen zoektermen, locatie of taal. |
| Combineer Google resultaten en YouTube metadata in een onderzoekstaak | Batch: Meng bronnen en verzamel een apart resultaat voor elke query. |
| Metadata verversen of transcripten verzamelen voor een videocatalogus | Bulk: Eén video-ID-bestand, één bron en dezelfde opties voor elke video. |
| Een lijst van video's in een emmer in hetzelfde formaat afleveren | Bulk: Gebruik youtube_download met gedeelde mediainstellingen en bestemmingsopslag. |
| Gebruik verschillende uitvoerinstellingen voor elke video | Batch: 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.
{
"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.
- Kies metadata, transcriptie, bijschriften, licentieclassificatie of download. Bulk neemt video IDs; gebruik Batch voor zoekwoorden.
- Een aparte taak gebruiken wanneer de bron of opties veranderen. Bijvoorbeeld, metadata en transcripten voor hetzelfde bestand zijn twee Bulk taken.
- Voor downloads, geef bestemmingsopslag en eigenaar toegang met youtube_download toestemming. Resultaat rijen beschrijven geleverde media; mediabestanden worden opgeslagen in uw emmer.
dQw4w9WgXcQ
jNQXAC9IVRwPlan hoe u resultaten verzamelt
| Verantwoordelijkheid | Batch | Bulk |
|---|---|---|
| Behalve na de indiening | Elke queries[].id, gekoppeld aan de oorspronkelijke invoer. Er is geen enkele Batch job ID. | Eén Bulk-taak ID en het ongewijzigde invoerbestand. |
| Track voltooid | Elke 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 verzamelen | Het 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 onderbreking | Lees 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
| Controleren | Wat te verantwoorden voor |
|---|---|
| Batch | De maxBatchSize van uw plan beperkt vragen per indiening. Grotere sets splitsen in kleinere groepen en respect hebben voor in afwachting van werkcapaciteit. |
| Bulk | Tot 2 GiB per ID bestand. Werk wordt ingediend geleidelijk binnen gedeelde rekening capaciteit; verwijder duplicaten voor upload. |
| Credits | Groeperen is niet één flat charge. Queries gebruiken prijzen per bron; downloads worden gemeten aan de hand van de geleverde gegevensgrootte. |
| Toegang | De sleutel moet elke gevraagde bron toestaan. Controleer de limieten van het actieve account; een proef is geen account met volledige capaciteit. |