Method: projects.locations.files.annotate

Serviço que realiza detecção e anotação de imagens em um lote de arquivos. No momento, só são aceitos application/pdf, image/tiff e image/gif.

O serviço vai extrair no máximo cinco frames (GIF) ou páginas (PDF ou TIFF) de cada arquivo fornecido e realizar a detecção e a anotação de cada imagem extraída. Os clientes podem especificar esses frames ou páginas em AnnotateFileRequest.pages.

Solicitação HTTP

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/files:annotate

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

Parâmetros de caminho

Parâmetros
parent

string

Opcional. Projeto e local de destino para fazer uma chamada.

Formato: projects/{project-id}/locations/{location-id}.

Se nenhum pai for especificado, uma região será escolhida automaticamente.

IDs de local aceitos – us: apenas nos EUA, asia: áreas do leste da Ásia, como Japão e Taiwan, eu: União Europeia.

Exemplo: projects/project-A/locations/eu.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ]
}
Campos
requests[]

object (AnnotateFileRequest)

Obrigatório. A lista de solicitações de anotação de arquivo. No momento, apenas uma AnnotateFileRequest é aceita em BatchAnnotateFilesRequest.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de BatchAnnotateFilesResponse.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Para saber mais, consulte a Visão geral da autenticação.