Dokumentation durchsuchen
API-Referenz
Wählen Sie Batch für unabhängige Abfragen mit unterschiedlichen Eingaben. Wählen Sie Bulk für eine Videodatei IDs, die alle die gleiche Operation benötigen.
Auf dieser Seite
Wählen Sie nach der Arbeit, die Sie tun müssen
Die Wahl hängt von der Form Ihrer Eingabe ab, nicht von einer festen Anzahl von Elementen. Beide Modi laufen im Hintergrund. Verwenden Sie für eine Abfrage direkt Echtzeit oder async.
| Ihre Aufgabe | Wählen Sie |
|---|---|
| Suche mehrere Themen für ein tägliches Briefing | Batch: Jede Abfrage hat ihre eigenen Suchbegriffe, Standorte oder Sprachen. |
| Kombinieren Sie Google Ergebnisse und YouTube Metadaten in einem Forschungsauftrag | Batch: Mischen Sie Quellen und sammeln Sie ein separates Ergebnis für jede Abfrage. |
| Metadaten aktualisieren oder Transkripte für einen Videokatalog sammeln | Bulk: Eine Video-ID-Datei, eine Quelle und die gleichen Optionen für jedes Video. |
| Liefern Sie eine Liste von Videos an einen Bucket im gleichen Format | Bulk: Verwenden Sie youtube_download mit freigegebenen Medieneinstellungen und Zielspeicher. |
| Verwenden Sie unterschiedliche Ausgabeeinstellungen für jedes Video | Batch: Per-Abfrage-Parameter können unterschiedlich sein; Bulk wendet einen Satz auf die gesamte Datei an. |
Batch: unabhängige Abfragen
Senden Sie ein JSON-Objekt mit Abfragen. Jedes Element hat seine eigene Quelle, Eingabe und Params. Verwenden Sie Batch für Google-Suchen, YouTube-Suchen, gemischte Quellen oder Videos, die unterschiedliche Optionen benötigen.
{
"queries": [
{
"source": "google_search",
"query": "open source speech recognition",
"params": {
"num": 5
}
},
{
"source": "youtube_metadata",
"video_id": "dQw4w9WgXcQ",
"params": {}
}
]
}Bulk: eine Operation über eine Datei
Laden Sie eine UTF-8 Datei mit einem YouTube Video ID pro Zeile hoch. Wählen Sie eine unterstützte Quelle und eine Reihe von Optionen für die gesamte Datei aus. Bulk scannt die Datei, sendet Arbeit innerhalb der Kontokapazität und Paketergebnisse in herunterladbare Teile.
- Wählen Sie Metadaten, Transkript, Bildunterschriften, Lizenzklassifizierung oder Download. Bulk nimmt das Video IDs auf; Verwenden Sie Batch für die Keyword-Suche.
- Verwenden Sie einen separaten Job, wenn sich die Quelle oder Optionen ändern. Metadaten und Transkripte für dieselbe Datei sind beispielsweise zwei Bulk-Jobs.
- Für Downloads stellen Sie Zielspeicherung und Besitzerzugriff mit youtube_download-Berechtigung zur Verfügung. Ergebniszeilen beschreiben gelieferte Medien; Mediendateien werden in Ihrem Bucket gespeichert.
dQw4w9WgXcQ
jNQXAC9IVRwPlanen Sie, wie Sie Ergebnisse sammeln
| Verantwortung | Batch | Bulk |
|---|---|---|
| Sparen nach Einreichung | Jedes queries[].id, verbunden mit seinem ursprünglichen Eingang. Es gibt keinen einzelnen Batch-Job ID. | Ein Bulk Job ID und die unveränderte Eingabedatei. |
| Gleisabschluss | Jeder Job endet unabhängig; ein Fehler beschreibt nicht die gesamte Charge. | Ein Job zeigt Fortschritt zählt. abgeschlossen bedeutet, dass die Ergebnisse verpackt sind, nicht dass jedes Video erfolgreich war. |
| Sammelausgang | Holen Sie das Ergebnis jedes abgeschlossenen Jobs ab und behalten Sie seine Eingabe-zu-ID-Zuordnung bei. | Holen Sie das Manifest und jeden komprimierten NDJSON-Teil. Join by index und video_id, nicht Zeilenreihenfolge. |
| Wiederaufnahme nach Unterbrechung | Lesen Sie den gespeicherten Job IDs, bevor Sie neue Einsendungen in Betracht ziehen. | Überprüfen Sie die gespeicherte Bulk ID. Lösen Sie pauseReason und nehmen Sie diesen Job wieder auf, wenn Sie angehalten werden. |
Kapazität und Kosten vor dem Start überprüfen
| Überprüfung | Was zu berücksichtigen ist |
|---|---|
| Batch | Der maxBatchSize Ihres Plans begrenzt Abfragen pro Einreichung. Teilen Sie größere Gruppen in kleinere Gruppen auf und respektieren Sie die ausstehende Jobkapazität. |
| Bulk | Bis zu 2 GiB pro ID-Datei. Die Arbeit wird schrittweise innerhalb der Kapazität eines gemeinsamen Kontos eingereicht; entfernen Sie Duplikate vor dem Hochladen. |
| Guthaben | Gruppierung ist keine Flat Charge. Abfragen verwenden Preise pro Quelle; Downloads werden nach der gelieferten Datengröße gemessen. |
| Zugang | Der Schlüssel muss jede angeforderte Quelle zulassen. Überprüfen Sie die Limits des aktiven Kontos; eine Testversion ist kein Vollkapazitätskonto. |