Method: indexing.datasources.items.upload

Creates an upload session for uploading item content. For items smaller than 100 KB, it's easier to embed the content inline within an index request.

This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source.

HTTP request

POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}:upload

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the Item to start a resumable upload. Format: datasources/{sourceId}/items/{itemId}. The maximum length is 1536 bytes.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "connectorName": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Fields
connectorName

string

The name of connector making this call.

Format: datasources/{sourceId}/connectors/{ID}
debugOptions

object (DebugOptions)

Common debug options.

Response body

If successful, the response body contains an instance of UploadItemRef.

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.