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.