Method: projects.files.annotate
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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/{parent=projects/*}/files:annotate
O URL usa a sintaxe de transcodificação de gRPC.
Parâmetros de caminho
| Parâmetros |
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 do pedido
O corpo do pedido contém dados com a seguinte estrutura:
| Campos |
requests[] |
object (AnnotateFileRequest)
Obrigatório. A lista de pedidos de anotação de ficheiros. Atualmente, só suportamos um AnnotateFileRequest em BatchAnnotateFilesRequest.
|
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-platformhttps://www.googleapis.com/auth/cloud-vision
Para mais informações, consulte a Vista geral da autenticação.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-20 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-20 UTC."],[],[],null,["# Method: projects.files.annotate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nService that performs image detection and annotation for a batch of files. Now only \"application/pdf\", \"image/tiff\" and \"image/gif\" are supported.\n\nThis 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.\n\n### HTTP request\n\n`POST https://vision.googleapis.com/v1/{parent=projects/*}/files:annotate`\n\nThe URL uses [gRPC Transcoding](https://github.com/googleapis/googleapis/blob/master/google/api/http.proto) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [BatchAnnotateFilesResponse](/vision/product-search/docs/reference/rest/v1/BatchAnnotateFilesResponse).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-vision`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
