Method: media.upload

Загружает медиафайлы для индексации.

Конечная точка загрузки поддерживает протоколы прямой и возобновляемой загрузки и предназначена для больших элементов, которые невозможно встроить во время запросов индекса . Чтобы индексировать большой контент:

  1. Вызовите indexing.datasources.items.upload с именем элемента, чтобы начать сеанс загрузки и получить UploadItemRef .
  2. Вызовите media.upload, чтобы загрузить контент в виде запроса потоковой передачи, используя то же имя ресурса, что и в UploadItemRef из шага 1.
  3. Вызовите 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

string

Имя загружаемого носителя. См. ReadRequest.resource_name .

Тело запроса

Тело запроса содержит экземпляр Media .

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

Медиа-ресурс.

JSON-представление
{
  "resourceName": string
}
Поля
resourceName

string

Название медиаресурса.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Дополнительную информацию см. в руководстве по авторизации .