JSON API: Options for Uploading Objects

This page describes ways you can use the JSON API to upload objects to Cloud Storage. Any MIME type of data is permitted, and files may be up to 5 TB in size.

See Uploading Objects for a quick guide to simple uploads using tools such as the JSON API.

You can send upload requests in any of the following ways:

  • Simple upload: uploadType=media. For quick transfer of a small file (5 MB or less). To perform a simple upload, refer to Performing a Simple Upload.
  • Multipart upload: uploadType=multipart. For quick transfer of a small file (5 MB or less) and metadata describing the file, all in a single request. To perform a multipart upload, refer to Performing a Multipart Upload.
  • Resumable upload: uploadType=resumable. For more reliable transfer, especially important with large files. Resumable uploads are a good choice for most applications, since they also work for small files at the cost of one additional HTTP request per upload. To perform a resumable upload, refer to Performing a Resumable Upload.

All of these options require you to include an OAuth 2.0 token in your request. See Authorize Requests for details about obtaining OAuth tokens.

Send feedback about...

Cloud Storage Documentation