Загружает медиафайлы для индексации.
Конечная точка загрузки поддерживает протоколы прямой и возобновляемой загрузки и предназначена для больших элементов, которые невозможно встроить во время запросов индекса . Чтобы индексировать большой контент:
- Вызовите
indexing.datasources.items.upload
с именем элемента, чтобы начать сеанс загрузки и получитьUploadItemRef
. - Вызовите media.upload, чтобы загрузить контент в виде запроса потоковой передачи, используя то же имя ресурса, что и в UploadItemRef из шага 1.
- Вызовите
indexing.datasources.items.index
, чтобы проиндексировать элемент. Заполните ItemContent с помощью UploadItemRef из шага 1.
Дополнительные сведения см. в разделе Создание соединителя контента с помощью REST API .
Примечание. Для выполнения этого API требуется учетная запись службы.
HTTP-запрос
- URI загрузки для запросов на загрузку мультимедиа:
POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
- URI метаданных для запросов только метаданных:
POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
resourceName | Имя загружаемого носителя. См. |
Тело запроса
Тело запроса содержит экземпляр Media
.
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
Медиа-ресурс.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Название медиаресурса. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/cloud_search.indexing
-
https://www.googleapis.com/auth/cloud_search
Дополнительную информацию см. в руководстве по авторизации .