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.