Method: files.annotate

Servicio que realiza la detección y anotación de imágenes para un lote de archivos. Ahora solo se admiten "application/pdf", "image/tiff".

Este servicio extraerá como máximo 5 marcos (gif) o páginas (pdf o tiff) (los clientes pueden especificar los 5 en AnnotateFileRequest.pages) de cada archivo proporcionado y realizará la detección y anotación para cada imagen extraída.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ],
  "parent": string
}
Campos
requests[]

object (AnnotateFileRequest)

Obligatorio. La lista de solicitudes de anotación de archivos. En este momento, solo se admite una AnnotateFileRequest en BatchAnnotateFilesRequest.

parent

string

Opcional. Proyecto de destino y ubicación para realizar una llamada.

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

Si no se especifica un elemento superior, se seleccionará una región de forma automática.

location_id [id_ubicación] admitidos: us: Solo países de EE.UU., asia: Áreas de Asia oriental, como Japón y Taiwán, eu: La Unión Europea.

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

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de BatchAnnotateFilesResponse.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.