Method: files.annotate

Service qui détecte et annote les images d'un lot de fichiers. Actuellement, seuls les fichiers "application/pdf", "image/tiff" et "image/gif" sont acceptés.

Ce service extrait au maximum cinq frames GIF (les clients peuvent les spécifier dans les requêtes AnnotateFileRequest.pages) ou pages (PDF ou TIFF) de chaque fichier fourni, et détecte et annote chaque image extraite.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requests": [
    {
      object (AnnotateFileRequest)
    }
  ],
  "parent": string
}
Champs
requests[]

object (AnnotateFileRequest)

Obligatoire. Liste des requêtes d'annotation de fichiers. À l'heure actuelle, nous n'acceptons qu'une seule requête AnnotateFileRequest dans la liste BatchAnnotateFilesRequest.

parent

string

Facultatif. Projet et emplacement cibles pour passer un appel.

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

Si aucun parent n'est spécifié, une région est automatiquement sélectionnée.

ID de zone géographique acceptés: us: États-Unis uniquement, asia: régions d'Asie de l'Est, comme le Japon et Taïwan, eu: Union européenne.

Exemple : projects/project-A/locations/eu

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de BatchAnnotateFilesResponse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez Présentation de l'authentification.