Uploads media for indexing.
The upload endpoint supports direct and resumable upload protocols and is intended for large items that can not be inlined during index requests . To index large content:
- Call
indexing.datasources.items.uploadwith the item name to begin an upload session and retrieve theUploadItemRef. - Call media.upload to upload the content, as a streaming request, using the same resource name from the UploadItemRef from step 1.
- Call
indexing.datasources.items.indexto index the item. Populate the ItemContent with the UploadItemRef from step 1.
For additional information, see Create a content connector using the REST API .
Note:This API requires a service account to execute.
HTTP request
- Upload URI, for media upload requests:
POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**} - Metadata URI, for metadata-only requests:
POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
resourceName
|
Name of the media that is being downloaded. See |
Request body
The request body contains an instance of Media
.
Response body
Media resource.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{ "resourceName" : string } |
| Fields | |
|---|---|
resourceName
|
Name of the media resource. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloud_search.indexing -
https://www.googleapis.com/auth/cloud_search
For more information, see the Authorization guide .

