Options for Uploading Objects

This page describes the different types of uploads to Google Cloud Storage that you can perform using the JSON API and provides links to in-depth discussions of each upload type. When uploading object data, any MIME type of data is permitted, and files may be up to 5 TB in size.

See Uploading an object 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