Method: files.annotate

Serviço que realiza a deteção e a anotação de imagens para um lote de ficheiros. Agora, apenas são suportados os tipos "application/pdf", "image/tiff" e "image/gif".

Este serviço extrai, no máximo, 5 frames (GIF) ou páginas (PDF ou TIFF) de cada ficheiro fornecido e realiza a deteção e a anotação de cada imagem extraída. Os clientes podem especificar que 5 frames ou páginas querem no AnnotateFileRequest.pages.

Pedido HTTP

POST https://vision.googleapis.com/v1/files:annotate

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

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

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

object (AnnotateFileRequest)

Obrigatório. A lista de pedidos de anotação de ficheiros. Atualmente, só suportamos um AnnotateFileRequest em BatchAnnotateFilesRequest.

parent

string

Opcional. Projeto e localização de destino para fazer uma chamada.

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

Se não for especificado nenhum elemento principal, é escolhida uma região automaticamente.

IDs de localização suportados: us: apenas no país EUA, asia: áreas do leste asiático, como o Japão e Taiwan, eu: a União Europeia.

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

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de BatchAnnotateFilesResponse.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte a Vista geral da autenticação.