Cloud Search API . media

upload(resourceName=None, body=None, media_body=None, media_mime_type=None, x__xgafv=None)

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](https://developers.google.com/cloud-search/docs/reference/rest/v1/indexing.datasources.items#itemcontent).
To index large content:

1. Call
   indexing.datasources.items.upload
   with the resource name to begin an upload session and retrieve the
   UploadItemRef.
1. Call media.upload to upload the content using the same resource name from step 1.
1. Call indexing.datasources.items.index
   to index the item. Populate the
   [ItemContent](/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ItemContent)
   with the UploadItemRef from step 1.


For additional information, see
[Create a content connector using the REST API](https://developers.google.com/cloud-search/docs/guides/content-connector#rest).

  **Note:** This API requires a service account to execute.

Args:
  resourceName: string, Name of the media that is being downloaded.  See
ReadRequest.resource_name. (required)
  body: object, The request body.
    The object takes the form of:

{ # Media resource.
    "resourceName": "A String", # Name of the media resource.
  }

  media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Media resource.
      "resourceName": "A String", # Name of the media resource.
    }