Console
    Contact Us Start free

    Method: files.annotate

    Service that performs image detection and annotation for a batch of files. Now only "application/pdf", "image/tiff" and "image/gif" are supported.

    This service will extract at most 5 (customers can specify which 5 in AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file provided and perform detection and annotation for each image extracted.

    HTTP request

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

    The URL uses gRPC Transcoding syntax.

    Request body

    The request body contains data with the following structure:

    JSON representation 
     { 
 "requests" 
 : 
 [ 
 { 
 object (  AnnotateFileRequest 
 
) 
 } 
 ] 
 , 
 "parent" 
 : 
 string 
 }
    Fields
    requests[]

    object ( AnnotateFileRequest )

    Required. The list of file annotation requests. Right now we support only one AnnotateFileRequest in BatchAnnotateFilesRequest.
    parent

    string

    Optional. Target project and location to make a call.

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

    If no parent is specified, a region will be chosen automatically.

    Supported location-ids: us : USA country only, eu : The European Union.

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

    Response body

    If successful, the response body contains an instance of BatchAnnotateFilesResponse .

    Authorization Scopes

    Requires one of the following OAuth scopes:

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

    For more information, see the Authentication Overview .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: