Method: media.upload
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],[],null,["# Method: media.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Media.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads media for indexing.\n\nThe upload endpoint supports direct and resumable upload protocols and is intended for large items that can not be [inlined during index requests](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#itemcontent). To index large content:\n\n1. Call [indexing.datasources.items.upload](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items/upload#google.apps.search.v1.ItemsService.StartUploadItem) with the item name to begin an upload session and retrieve the [UploadItemRef](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#UploadItemRef).\n2. Call media.upload to upload the content, as a streaming request, using the same resource name from the UploadItemRef from step 1.\n3. Call [indexing.datasources.items.index](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items/index_#google.apps.search.v1.ItemsService.IndexItem) to index the item. Populate the [ItemContent](/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ItemContent) with the UploadItemRef from step 1.\n\nFor additional information, see [Create a content connector using the REST API](https://developers.google.com/workspace/cloud-search/docs/guides/content-connector#rest).\n\n**Note:** This API requires a service account to execute.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}`\n- Metadata URI, for metadata-only requests: \n `POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------|\n| `resourceName` | `string` Name of the media that is being downloaded. See `ReadRequest.resource_name`. |\n\n### Request body\n\nThe request body contains an instance of [Media](/workspace/cloud-search/docs/reference/rest/v1/media/upload#body.Media).\n\n### Response body\n\nMedia resource.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------|\n| ``` { \"resourceName\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------|\n| `resourceName` | `string` Name of the media resource. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.indexing`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
