コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

API リファレンス

Batchとバルク

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はファイルをスキャンし、アカウントの容量とパッケージの結果をダウンロード可能な部品に送信します。

  1. メタデータ、トランスクリプト、キャプション、ライセンスの分類、またはダウンロードを選択します。 BulkはビデオIDsをとります;キーワードの調査のためのBatchを使用して下さい。
  2. ソースまたはオプションが変更されると、別のジョブを使用します。 たとえば、同じファイルに対するメタデータとトランスクリプトは、Bulkジョブの2つです。
  3. ダウンロードのため、youtube_downloadの許可を得て保存先と所有者のアクセスを提供します。 結果の行は、配信されたメディアを記述します。メディアファイルは、バケットに保存されます。
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

結果を収集する方法を計画

責任の責任BatchBulk
投稿後保存queries[].idは、元の入力にリンクされています。 Batch ジョブ ID は 1 つありません。Bulk ジョブ ID と変更されていない入力ファイル。
追跡完了各ジョブは独立して終了します。1つの失敗は全体のバッチを記述しません。1つのジョブが進行数を調べます。完了すると、結果がパッケージ化され、すべてのビデオが成功するわけではありません。
出力を収集完了したジョブの結果をフェッチし、入力からIDマッピングを保持します。マニフェストとすべての圧縮されたNDJSON部分を取得します。 行の注文ではなく、インデックスとvideo_idで参加してください。
中断後の再開新しい投稿を検討する前に保存されたジョブIDsをお読みください。保存したBulk IDを確認してください。 pauseReasonを解決し、パユース時にジョブを再開します。

開始する前に容量と費用をチェックする

インフォメーション口座について
BatchプランのmaxBatchSizeは、投稿ごとにクエリを制限します。 より小さいグループにより大きいセットを分割し、保留中のジョブ容量を尊重します。
BulkIDファイルごとの2 GiBまで。 作業は、共有アカウントの容量内で徐々に提出されます。アップロード前に重複を削除してください。
クレジットグループ化は1つのフラットチャージではありません。 クォーリーは、ソースごとの価格設定を使用しており、ダウンロードは、配信されたデータサイズによってメーターで計られます。
アクセス鍵は、要求されたすべてのソースを許可しなければなりません。 アクティブなアカウントの制限をチェックしてください。トライアルはフルキャパシティアカウントではありません。