インデックス登録するメディアをアップロードします。
アップロード エンドポイントは、直接アップロードと再開可能なアップロード プロトコルをサポートしており、インデックス登録リクエスト中にインライン化できないサイズの大きいアイテムを対象としています。サイズの大きいコンテンツをインデックス登録するには:
- アイテム名を指定して
indexing.datasources.items.upload
を呼び出し、アップロード セッションを開始し、UploadItemRef
を取得します。 - media.upload を呼び出し、ステップ 1 の UploadItemRef と同じリソース名を使って、コンテンツをストリーミング リクエストとしてアップロードします。
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 |
ダウンロード中のメディアの名前。 |
リクエスト本文
リクエストの本文には Media
のインスタンスが含まれています。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
メディア リソースです。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
メディア リソースの名前。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
詳細については、承認ガイドをご覧ください。