Method: photo.startUpload

Creates an upload session to start uploading photo bytes. The method uses the upload URL of the returned UploadRef to upload the bytes for the Photo.

In addition to the photo requirements shown in, the photo must meet the following requirements:

After the upload completes, the method uses UploadRef with photo.create to create the Photo object entry.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.