ドキュメントを探す
API リファレンス
Batch は、異なる入力で独立したクエリに選択します。 Bulk は、同じ操作を必要とするすべてのビデオ IDs のファイルを選択します。
このページの内容
あなたがする必要がある仕事で選ぶ
選択は、入力の形状に依存し、固定数の項目ではありません。 どちらのモードもバックグラウンドで実行されます。 1つのクエリでは、実時間または非同期を直接使用してください。
| あなたのタスク | 選択する |
|---|---|
| 日常の簡単なトピックを検索する | Batch: 各クエリには、独自の検索条件、場所、言語があります。 |
| Google 結果と YouTube メタデータを研究ジョブに結合する | Batch: ソースをミックスし、クエリごとに別の結果を収集します。 |
| メタデータを更新するか、ビデオカタログのトランスクリプトを収集する | Bulk: 1つのビデオ-IDファイル、1つのソースとすべてのビデオの同じオプション。 |
| 同じ形式の Bucket にビデオのリストを渡す | Bulk: youtube_downloadは、共有メディアの設定と保存先で使用します。 |
| 各ビデオの異なる出力設定を使用する | Batch: クエリパラメータは異なります。 Bulk は、ファイル全体に 1 つのセットを適用します。 |
Batch:独立した問い合わせ
クエリを含む JSON オブジェクトを送信します。 各項目に独自のソース、入力、パラメータがあります。 Google検索、YouTube検索、混合ソース、または異なるオプションを必要とするビデオにBatchを使用します。
Batch入力・2つの異なるタスク
{
"queries": [
{
"source": "google_search",
"query": "open source speech recognition",
"params": {
"num": 5
}
},
{
"source": "youtube_metadata",
"video_id": "dQw4w9WgXcQ",
"params": {}
}
]
}Bulk:ファイル上の1つの操作
UTF-8ファイルを1つのYouTubeビデオIDを1行にアップロードします。 サポートされているソースとファイル全体でオプションの1セットを選択します。 Bulkはファイルをスキャンし、アカウントの容量とパッケージの結果をダウンロード可能な部品に送信します。
- メタデータ、トランスクリプト、キャプション、ライセンスの分類、またはダウンロードを選択します。 BulkはビデオIDsをとります;キーワードの調査のためのBatchを使用して下さい。
- ソースまたはオプションが変更されると、別のジョブを使用します。 たとえば、同じファイルに対するメタデータとトランスクリプトは、Bulkジョブの2つです。
- ダウンロードのため、youtube_downloadの許可を得て保存先と所有者のアクセスを提供します。 結果の行は、配信されたメディアを記述します。メディアファイルは、バケットに保存されます。
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw結果を収集する方法を計画
| 責任の責任 | Batch | Bulk |
|---|---|---|
| 投稿後保存 | queries[].idは、元の入力にリンクされています。 Batch ジョブ ID は 1 つありません。 | Bulk ジョブ ID と変更されていない入力ファイル。 |
| 追跡完了 | 各ジョブは独立して終了します。1つの失敗は全体のバッチを記述しません。 | 1つのジョブが進行数を調べます。完了すると、結果がパッケージ化され、すべてのビデオが成功するわけではありません。 |
| 出力を収集 | 完了したジョブの結果をフェッチし、入力からIDマッピングを保持します。 | マニフェストとすべての圧縮されたNDJSON部分を取得します。 行の注文ではなく、インデックスとvideo_idで参加してください。 |
| 中断後の再開 | 新しい投稿を検討する前に保存されたジョブIDsをお読みください。 | 保存したBulk IDを確認してください。 pauseReasonを解決し、パユース時にジョブを再開します。 |
開始する前に容量と費用をチェックする
| インフォメーション | 口座について |
|---|---|
| Batch | プランのmaxBatchSizeは、投稿ごとにクエリを制限します。 より小さいグループにより大きいセットを分割し、保留中のジョブ容量を尊重します。 |
| Bulk | IDファイルごとの2 GiBまで。 作業は、共有アカウントの容量内で徐々に提出されます。アップロード前に重複を削除してください。 |
| クレジット | グループ化は1つのフラットチャージではありません。 クォーリーは、ソースごとの価格設定を使用しており、ダウンロードは、配信されたデータサイズによってメーターで計られます。 |
| アクセス | 鍵は、要求されたすべてのソースを許可しなければなりません。 アクティブなアカウントの制限をチェックしてください。トライアルはフルキャパシティアカウントではありません。 |