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

詳細については、承認ガイドをご覧ください。