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.