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

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