Method: media.upload

Faz upload de mídia para indexação.

O endpoint de upload oferece suporte a protocolos de upload direto e retomável e é destinado a itens grandes que não podem ser in-line durante solicitações de indexação. Para indexar conteúdo grande:

  1. Chame indexing.datasources.items.upload com o nome do item para iniciar uma sessão de upload e recuperar o UploadItemRef.
  2. Chame media.upload para fazer upload do conteúdo, como uma solicitação de streaming, usando o mesmo nome de recurso do UploadItemRef da etapa 1.
  3. Chame indexing.datasources.items.index para indexar o item. Preencha o ItemContent com "UploadItemRef" da etapa 1.

Para mais informações, consulte Criar um conector de conteúdo usando a API REST.

Observação:essa API requer uma conta de serviço para ser executada.

Solicitação HTTP

  • URI de upload para solicitações de upload de mídia:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI de metadados, para solicitações somente de metadados:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
resourceName

string

Nome da mídia que está sendo transferida por download. Consulte os ReadRequest.resource_name.

Corpo da solicitação

O corpo da solicitação contém uma instância de Media.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Recurso de mídia.

Representação JSON
{
  "resourceName": string
}
Campos
resourceName

string

Nome do recurso de mídia.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte o Guia de autorização.