Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Dokumentacja API

Batch i luzem

Wybierz Batch dla niezależnych zapytań o różne wejścia. Wybierz Bulk dla pliku wideo IDs, który wszystkie potrzebują tej samej operacji.

Na tej stronie

Wybierz po pracy, którą musisz wykonać

Wybór zależy od kształtu wejścia, a nie od stałej liczby elementów. Oba tryby działają w tle. W przypadku jednego zapytania należy bezpośrednio używać czasu rzeczywistego lub async.

Twoje zadanieWybierz
Wyszukaj kilka tematów na codzienną odprawęBatch: Każde zapytanie ma własne warunki wyszukiwania, lokalizację lub język.
Połącz wyniki Google i metadane YouTube w pracy badawczejBatch: Wymieszać źródła i zbierać osobny wynik dla każdego zapytania.
Odśwież metadane lub zbieraj transkrypty dla katalogu wideoBulk: Jeden plik wideo-ID, jedno źródło i te same opcje dla każdego wideo.
Dostarcz listę filmów do wiadra w tym samym formacieBulk: Użyj youtube_download z ustawieniami multimedialnymi i pamięcią docelową.
Użyj różnych ustawień wyjściowych dla każdego wideoBatch: Parametry per- query mogą się różnić; Bulk stosuje jeden zestaw do całego pliku.

Batch: niezależne zapytania

Wyślij obiekt JSON zawierający zapytania. Każdy element posiada własne źródło, wejście i paramy. Użyj Batch do wyszukiwań Google, wyszukiwań YouTube, źródeł mieszanych lub filmów, które wymagają różnych opcji.

Wejście Batch · dwa różne zadania
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: jedna operacja nad plikiem

Wyślij plik UTF-8 jednym wideo YouTube ID na linię. Wybierz jedno obsługiwane źródło i jeden zestaw opcji dla całego pliku. Bulk skanuje plik, przekazuje pracę w ramach pojemności konta, a pakiety są wynikiem do pobrania części.

  1. Wybierz metadane, transkrypcję, podpisy, klasyfikację licencji lub pobrać. Bulk zajmuje wideo IDs; użyj Batch do wyszukiwania słów kluczowych.
  2. Użyj oddzielnego zadania, gdy zmieni się źródło lub opcje. Na przykład metadane i transkrypcje dla tego samego pliku to dwa zadania Bulk.
  3. W przypadku pobierania danych należy zapewnić przechowywanie danych docelowych i dostęp do właściciela za pozwoleniem youtube_download. Wiersze wyników opisują dostarczone media; pliki multimedialne są przechowywane w Twoim wiadrze.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Zaplanuj, jak będziesz zbierać wyniki

OdpowiedzialnośćBatchBulk
Zapisz po złożeniuKażdy queries[].id, powiązany ze swoim pierwotnym wejściem. Nie ma pojedynczego zadania Batch IDJedno zadanie Bulk ID i niezmieniony plik wejściowy.
Ukończenie toruKażde zadanie kończy się niezależnie; jedna porażka nie opisuje całej partii.Jedno zadanie ujawnia rangi postępu. Ukończone oznacza, że wyniki są pakowane, nie, że każdy film się powiódł.
Zbierz wynikPobierz każdy zakończony wynik zadania i zachować jego input- to-ID mapowanie.Pobierz manifest i każdą skompresowaną część NDJSON. Dołącz przez indeks i video_id, a nie kolejność wierszy.
Wznowienie po przerwaniu leczeniaPrzeczytaj uratowaną pracę IDs przed rozważeniem nowych wniosków.Sprawdź zapisany Bulk ID. Rozwiąż pauseReason i wznowij pracę, jeśli się wstrzymasz.

Sprawdzić pojemność i koszt przed rozpoczęciem

SprawdźCo się rozlicza
BatchTwój plan jest maxBatchSize ogranicza zapytania na złożenie. Rozdziel większe zestawy na mniejsze grupy i szanuj możliwości zadawania zadań.
BulkDo 2 GiB za plik ID. Prace są składane stopniowo w ramach wspólnej zdolności kontowej; przed wysłaniem usunąć duplikaty.
KredytyGrupowanie nie jest jednym płaskim ładunkiem. Zapytania dotyczą cen o charakterze okołoźródłowym; pobieranie danych mierzy się według wielkości dostarczanych danych.
DostępKlucz musi pozwolić na każde wymagane źródło. Sprawdzić limity aktywnego konta; próba nie jest kontem pełnej pojemności.