Options for Uploading Objects

This page describes how to use the Google Cloud Storage JSON API to upload object data, or media, when creating a new Object resource. Any MIME type of data is permitted, up to a maximum of 5 TB per file.

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