Method: files.annotate

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

Este servicio extraerá un máximo de 5 fotogramas (GIF) o páginas (PDF o TIFF) de cada archivo proporcionado y realizará la detección y la anotación de cada imagen extraída. Los clientes pueden especificar qué 5 fotogramas o páginas se extraerán en AnnotateFileRequest.pages.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

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

object (AnnotateFileRequest)

Obligatorio. Lista de solicitudes de anotación de archivos. Por el momento, solo admitimos un AnnotateFileRequest en BatchAnnotateFilesRequest.

parent

string

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

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

Si no se especifica ningún elemento superior, se elegirá una región automáticamente.

IDs de ubicación admitidos: us: solo en EE. UU., asia: zonas del este de Asia, como Japón y Taiwán, eu: la Unión Europea.

Ejemplo: projects/project-A/locations/eu

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de BatchAnnotateFilesResponse.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

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