Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

API-Referenz

Batch und Bulk

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 AufgabeWählen Sie
Suche mehrere Themen für ein tägliches BriefingBatch: Jede Abfrage hat ihre eigenen Suchbegriffe, Standorte oder Sprachen.
Kombinieren Sie Google Ergebnisse und YouTube Metadaten in einem ForschungsauftragBatch: Mischen Sie Quellen und sammeln Sie ein separates Ergebnis für jede Abfrage.
Metadaten aktualisieren oder Transkripte für einen Videokatalog sammelnBulk: 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 FormatBulk: Verwenden Sie youtube_download mit freigegebenen Medieneinstellungen und Zielspeicher.
Verwenden Sie unterschiedliche Ausgabeeinstellungen für jedes VideoBatch: 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.

Batch-Eingabe · zwei verschiedene Aufgaben
{
  "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.

  1. Wählen Sie Metadaten, Transkript, Bildunterschriften, Lizenzklassifizierung oder Download. Bulk nimmt das Video IDs auf; Verwenden Sie Batch für die Keyword-Suche.
  2. Verwenden Sie einen separaten Job, wenn sich die Quelle oder Optionen ändern. Metadaten und Transkripte für dieselbe Datei sind beispielsweise zwei Bulk-Jobs.
  3. 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.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Planen Sie, wie Sie Ergebnisse sammeln

VerantwortungBatchBulk
Sparen nach EinreichungJedes queries[].id, verbunden mit seinem ursprünglichen Eingang. Es gibt keinen einzelnen Batch-Job ID.Ein Bulk Job ID und die unveränderte Eingabedatei.
GleisabschlussJeder 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.
SammelausgangHolen 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 UnterbrechungLesen 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üfungWas zu berücksichtigen ist
BatchDer maxBatchSize Ihres Plans begrenzt Abfragen pro Einreichung. Teilen Sie größere Gruppen in kleinere Gruppen auf und respektieren Sie die ausstehende Jobkapazität.
BulkBis zu 2 GiB pro ID-Datei. Die Arbeit wird schrittweise innerhalb der Kapazität eines gemeinsamen Kontos eingereicht; entfernen Sie Duplikate vor dem Hochladen.
GuthabenGruppierung ist keine Flat Charge. Abfragen verwenden Preise pro Quelle; Downloads werden nach der gelieferten Datengröße gemessen.
ZugangDer Schlüssel muss jede angeforderte Quelle zulassen. Überprüfen Sie die Limits des aktiven Kontos; eine Testversion ist kein Vollkapazitätskonto.