Przeglądaj dokumentację
Dokumentacja API
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 zadanie | Wybierz |
|---|---|
| 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 badawczej | Batch: Wymieszać źródła i zbierać osobny wynik dla każdego zapytania. |
| Odśwież metadane lub zbieraj transkrypty dla katalogu wideo | Bulk: 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 formacie | Bulk: Użyj youtube_download z ustawieniami multimedialnymi i pamięcią docelową. |
| Użyj różnych ustawień wyjściowych dla każdego wideo | Batch: 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.
{
"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.
- Wybierz metadane, transkrypcję, podpisy, klasyfikację licencji lub pobrać. Bulk zajmuje wideo IDs; użyj Batch do wyszukiwania słów kluczowych.
- 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.
- 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.
dQw4w9WgXcQ
jNQXAC9IVRwZaplanuj, jak będziesz zbierać wyniki
| Odpowiedzialność | Batch | Bulk |
|---|---|---|
| Zapisz po złożeniu | Każdy queries[].id, powiązany ze swoim pierwotnym wejściem. Nie ma pojedynczego zadania Batch ID | Jedno zadanie Bulk ID i niezmieniony plik wejściowy. |
| Ukończenie toru | Każ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 wynik | Pobierz 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 leczenia | Przeczytaj 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 |
|---|---|
| Batch | Twój plan jest maxBatchSize ogranicza zapytania na złożenie. Rozdziel większe zestawy na mniejsze grupy i szanuj możliwości zadawania zadań. |
| Bulk | Do 2 GiB za plik ID. Prace są składane stopniowo w ramach wspólnej zdolności kontowej; przed wysłaniem usunąć duplikaty. |
| Kredyty | Grupowanie 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ęp | Klucz musi pozwolić na każde wymagane źródło. Sprawdzić limity aktywnego konta; próba nie jest kontem pełnej pojemności. |