Method: media.upload

インデックス登録用のメディアをアップロードします。

アップロード エンドポイントは、直接アップロード プロトコルと再開可能なアップロード プロトコルをサポートしています。インデックス リクエスト中にインライン化できない大規模なアイテムを対象としています。大規模なコンテンツをインデックスに登録するには:

  1. アイテム名を指定して indexing.datasources.items.upload を呼び出してアップロード セッションを開始し、UploadItemRef を取得します。
  2. media.upload を呼び出して、手順 1 の UploadItemRef と同じリソース名を使用して、ストリーミング リクエストとしてコンテンツをアップロードします。
  3. indexing.datasources.items.index を呼び出してアイテムをインデックス登録します。ItemContent に、ステップ 1 の UploadItemRef を入力します。

詳細については、REST API を使用してコンテンツ コネクタを作成するをご覧ください。

注: この API を実行するには、サービス アカウントが必要です。

HTTP リクエスト

  • アップロード URI（メディアのアップロード リクエストの場合）:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • メタデータ URI（メタデータのみの追加リクエストの場合）:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
resourceName

string

ダウンロード中のメディアの名前。ReadRequest.resource_name をご覧ください。

リクエストの本文

リクエストの本文には Media のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

メディア リソース。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

メディア リソースの名前。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

詳しくは、認可ガイドをご覧ください。