Package google.cloud.vision.v1p4beta1

Índice

ImageAnnotator

Serviço que executa tarefas de detecção da Google Cloud Vision API em imagens de clientes, como detecção de rosto, ponto de referência, logotipo, marcadores e texto. O serviço ImageAnnotator retorna as entidades detectadas das imagens.

AsyncBatchAnnotateFiles

rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest) returns (Operation)

Execute a detecção e anotação de imagem assíncrona para obter uma lista de arquivos genéricos, como arquivos PDF, que podem conter várias páginas e várias imagens por página. O progresso e os resultados podem ser recuperados por meio da interface google.longrunning.Operations Operation.metadata contém OperationMetadata (metadados). Operation.response contém AsyncBatchAnnotateFilesResponse (resultados).

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
AsyncBatchAnnotateImages

rpc AsyncBatchAnnotateImages(AsyncBatchAnnotateImagesRequest) returns (Operation)

Executar detecção e anotação de imagem assíncrona para uma lista de imagens.

O progresso e os resultados podem ser recuperados por meio da interface google.longrunning.Operations Operation.metadata contém OperationMetadata (metadados). Operation.response contém AsyncBatchAnnotateImagesResponse (resultados).

Esse serviço gravará saídas de anotação de imagem em arquivos json no bucket do Google Cloud Storage do cliente, cada arquivo json contendo proto BatchAnnotateImagesResponse.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
BatchAnnotateFiles

rpc BatchAnnotateFiles(BatchAnnotateFilesRequest) returns (BatchAnnotateFilesResponse)

Serviço que realiza detecção e anotação de imagens para um lote de arquivos. Agora, somente "aplicativo/pdf", "imagem/tiff" e "imagem/gif" são compatíveis.

Esse serviço extrairá no máximo 5 (clientes podem especificar quais cinco em frames do AnnotateFileRequest.pages) (gif) ou páginas (pdf ou tiff) de cada arquivo fornecido e realizar a detecção e anotação para cada imagem extraída.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
BatchAnnotateImages

rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse)

Executar detecção e anotação de imagem para um lote de imagens.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Pesquisadeprodutos

Gerencia produtos e conjuntos de produtos de imagens de referência para uso na pesquisa de produtos. Ele usa o seguinte modelo de recurso:

  • A API tem um conjunto de recursos ProductSet, denominado projects/*/locations/*/productSets/*, que funciona como uma forma de colocar produtos diferentes em grupos para limitar a identificação.

Paralelamente,

  • A API tem uma coleção de recursos Product chamada projects/*/locations/*/products/*

  • Cada Product tem uma coleção de ReferenceImage recursos, denominados projects/*/locations/*/products/*/referenceImages/*

AddProductToProductSet

rpc AddProductToProductSet(AddProductToProductSetRequest) returns (Empty)

Adiciona um produto ao ProductSet especificado. Se o produto já estiver presente, nenhuma alteração será feita.

Um produto pode ser adicionado a, no máximo, 100 ProductSets.

Erros possíveis:

  • Retorna NOT_FOUND se Produto ou ProductSet não existir.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
CreateProduct

rpc CreateProduct(CreateProductRequest) returns (Product)

Cria e retorna um novo recurso do produto.

Erros possíveis:

  • Retorna INVALID_ARGUMENT se display_name não for preenchido ou tiver mais de 4.096 caracteres.
  • Retorna INVALID_ARGUMENT se a descrição tiver mais de 4.096 caracteres.
  • Retorna INVALID_ARGUMENT se product_category estiver ausente ou for inválido.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
CreateProductSet

rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet)

Cria e retorna um novo recurso ProductSet.

Erros possíveis:

  • Retorna INVALID_ARGUMENT se display_name não estiver definido ou tiver mais de 4.096 caracteres.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
CreateReferenceImage

rpc CreateReferenceImage(CreateReferenceImageRequest) returns (ReferenceImage)

Cria e retorna um novo recurso ReferenceImage.

O campo bounding_poly é opcional. Se bounding_poly não for especificado, o sistema tentará detectar regiões de interesse na imagem que sejam compatíveis com product_category no produto pai. Se for especificado, a detecção será SEMPRE ignorada. O sistema converte polígonos em retângulos não girados.

O pipeline redimensionará a imagem se ela for muito grande para processar (acima de 50 MP).

Erros possíveis:

  • Retorna INVALID_ARGUMENT se o image_uri estiver ausente ou tiver mais de 4096 caracteres.
  • Retorna INVALID_ARGUMENT se o produto não existir.
  • Retorna INVALID_ARGUMENT se não for fornecido delimitador_poly e nada será compatível com a product_category do produto pai.
  • Retorna INVALID_ARGUMENT se limit_poly tiver mais de 10 polígonos.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
DeleteProduct

rpc DeleteProduct(DeleteProductRequest) returns (Empty)

Exclui permanentemente um produto e as imagens de referência dele.

Os metadados do produto e todas as imagens dele serão excluídos imediatamente, mas as consultas de pesquisa dos ProductSets que contêm o produto ainda poderão funcionar até que todos os caches relacionados sejam atualizados.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
DeleteProductSet

rpc DeleteProductSet(DeleteProductSetRequest) returns (Empty)

Exclui permanentemente um ProductSet. Produtos e ReferenceImages no ProductSet não são excluídos.

Os arquivos de imagem reais não são excluídos do Google Cloud Storage

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
DeleteReferenceImage

rpc DeleteReferenceImage(DeleteReferenceImageRequest) returns (Empty)

Exclui permanentemente uma imagem de referência.

Os metadados da imagem serão excluídos imediatamente, mas as consultas de pesquisa dos ProductSets que contêm a imagem ainda poderão funcionar até que todos os caches relacionados sejam atualizados.

Os arquivos de imagem reais não são excluídos do Google Cloud Storage

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Recebe informações associadas a um produto.

Erros possíveis:

  • Retornará NOT_FOUND se o produto não existir.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
GetProductSet

rpc GetProductSet(GetProductSetRequest) returns (ProductSet)

Obtém informações associadas a um ProductSet.

Erros possíveis:

  • Retornará NOT_FOUND se o ProductSet não existir.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
GetReferenceImage

rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage)

Obtém informações associadas a uma ReferenceImage.

Erros possíveis:

  • Retorna NOT_FOUND se a imagem especificada não existir.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ImportProductSets

rpc ImportProductSets(ImportProductSetsRequest) returns (Operation)

API assíncrona que importa uma lista de imagens de referência para conjuntos de produtos especificados com base em uma lista de informações de imagem.

A API google.longrunning.Operation pode ser usada para acompanhar o progresso e os resultados da solicitação. Operation.metadata contém BatchOperationMetadata. (progresso) Operation.response contém ImportProductSetsResponse. (resultados)

A origem de entrada desse método é um arquivo csv no Google Cloud Storage. Para o formato do arquivo csv, consulte ImportProductSetsGcsSource.csv_file_uri.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ListProductSets

rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse)

Lista ProductSets em uma ordem não especificada.

Erros possíveis:

  • Retorna INVALID_ARGUMENT se page_size for maior que 100 ou menor que 1.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Lista produtos em uma ordem não especificada.

Erros possíveis:

  • Retorna INVALID_ARGUMENT se page_size for maior que 100 ou menor que 1.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ListProductsInProductSet

rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse)

Lista os produtos em um ProductSet, em uma ordem não especificada. Se o ProductSet não existir, o campo de produtos da resposta ficará vazio.

Erros possíveis:

  • Retorna INVALID_ARGUMENT se page_size for maior que 100 ou menor que 1.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
ListReferenceImages

rpc ListReferenceImages(ListReferenceImagesRequest) returns (ListReferenceImagesResponse)

Lista as imagens de referência.

Erros possíveis:

  • Retornará NOT_FOUND se o produto pai não existir.
  • Retorna INVALID_ARGUMENT se o page_size for maior que 100 ou menor que 1.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
RemoveProductFromProductSet

rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest) returns (Empty)

Remove um produto do conjunto de produtos especificado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
UpdateProduct

rpc UpdateProduct(UpdateProductRequest) returns (Product)

Faz alterações em um recurso de produto. No momento, apenas os campos display_name, description e labels podem ser atualizados.

Se os rótulos forem atualizados, a alteração não será refletida nas consultas até o próximo horário do índice.

Erros possíveis:

  • Retornará NOT_FOUND se o produto não existir.
  • Retorna INVALID_ARGUMENT se display_name estiver presente em update_mask, mas estiver ausente na solicitação ou tiver mais de 4.096 caracteres.
  • Retorna INVALID_ARGUMENT se a descrição estiver presente na update_mask, mas tiver mais de 4.096 caracteres.
  • Retorna INVALID_ARGUMENT se product_category estiver presente em update_mask.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.
Atualizar o conjunto de produtos

rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet)

Faz alterações em um recurso ProductSet. No momento, apenas display_name pode ser atualizado.

Erros possíveis:

  • Retornará NOT_FOUND se o ProductSet não existir.
  • Retorna INVALID_ARGUMENT se display_name estiver presente em update_mask, mas ausente na solicitação ou com mais de 4.096 caracteres.
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

AddProductToProductSetRequest

Solicite mensagem para o método AddProductToProductSet.

Campos
name

string

O nome do recurso para o ProductSet a ser modificado.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
product

string

O nome do recurso do produto a ser adicionado ao ProductSet.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

AnnotateFileRequest

Uma solicitação para anotar um único arquivo, por exemplo, um arquivo PDF, TIFF ou GIF.

Campos
input_config

InputConfig

Obrigatório. Informações sobre o arquivo de entrada.

features[]

Feature

Obrigatório. Recursos solicitados.

image_context

ImageContext

Contexto adicional que pode acompanhar as imagens no arquivo.

pages[]

int32

Páginas do arquivo para realizar a anotação de imagem.

As páginas começam no número 1, presume-se que a primeira página do arquivo seja a página 1. No máximo, cinco páginas são compatíveis por solicitação. As páginas podem ser negativas.

A página 1 significa a primeira página. "Página 2" significa a segunda página. Página -1 significa a última página. Página -2 significa o segundo para a última página.

Se o arquivo for um GIF em vez de PDF ou TIFF, a página fará referência a frames GIF.

Se este campo estiver vazio, por padrão, o serviço realizará anotações de imagens nas primeiras cinco páginas do arquivo.

AnnotateFileResponse

Resposta a uma única solicitação de anotação de arquivo. Um arquivo pode conter uma ou mais imagens, que têm as próprias respostas individualmente.

Campos
input_config

InputConfig

Informações sobre o arquivo para onde essa resposta é gerada.

responses[]

AnnotateImageResponse

Respostas individuais às imagens encontradas no arquivo.

total_pages

int32

Este campo fornece o número total de páginas no arquivo.

AnnotateImageRequest

Solicitação para executar tarefas da Google Cloud Vision API em uma imagem fornecida pelo usuário, com recursos solicitados pelo usuário e com informações de contexto.

Campos
image

Image

A imagem a ser processada.

features[]

Feature

Recursos solicitados.

image_context

ImageContext

Contexto adicional que pode acompanhar a imagem.

AnnotateImageResponse

Resposta a uma solicitação de anotação de imagem.

Campos
face_annotations[]

FaceAnnotation

Se presente, a detecção de rosto foi concluída com sucesso.

landmark_annotations[]

EntityAnnotation

Se presente, a detecção de ponto de referência foi concluída com sucesso.

logo_annotations[]

EntityAnnotation

Se presente, a detecção de logotipo foi concluída com sucesso.

label_annotations[]

EntityAnnotation

Se presente, a detecção de marcadores foi concluída com sucesso.

localized_object_annotations[]

LocalizedObjectAnnotation

Se presente, a detecção de objeto localizada foi concluída com sucesso. A classificação será decrescente por pontuação de confiança.

text_annotations[]

EntityAnnotation

Se presente, a detecção de texto (OCR) foi concluída com sucesso.

full_text_annotation

TextAnnotation

Se presente, a detecção de texto (OCR) ou de texto de documentos foi concluída com sucesso. Esta anotação fornece a hierarquia estrutural para o texto detectado pelo OCR.

safe_search_annotation

SafeSearchAnnotation

Se presente, a anotação de pesquisa segura foi concluída com sucesso.

image_properties_annotation

ImageProperties

Se presente, as propriedades da imagem foram extraídas com sucesso.

crop_hints_annotation

CropHintsAnnotation

Se presente, as dicas de corte foram concluídas com sucesso.

web_detection

WebDetection

Se presente, a detecção da Web foi concluída com sucesso.

product_search_results

ProductSearchResults

Se presente, a pesquisa de produtos foi concluída com sucesso.

error

Status

Se definido, representa a mensagem de erro da operação. Observe que há uma garantia de que as anotações de imagens preenchidas são corretas, mesmo quando errorestá definido.

context

ImageAnnotationContext

Se presente, as informações contextuais são necessárias para entender de onde vem essa imagem.

AsyncAnnotateFileRequest

Uma solicitação de anotação de arquivo off-line.

Campos
input_config

InputConfig

Obrigatório. Informações sobre o arquivo de entrada.

features[]

Feature

Obrigatório. Recursos solicitados.

image_context

ImageContext

Contexto adicional que pode acompanhar as imagens no arquivo.

output_config

OutputConfig

Obrigatório. O local e os metadados da saída desejados (por exemplo, formato).

AsyncAnnotateFileResponse

A resposta a uma única solicitação de anotação de arquivo off-line.

Campos
output_config

OutputConfig

O local e os metadados da saída de AsyncAnnotateFileRequest.

AsyncBatchAnnotateFilesRequest

Várias solicitações de anotação de arquivo assíncrono são agrupadas em uma única chamada de serviço.

Campos
requests[]

AsyncAnnotateFileRequest

Solicitações individuais de anotação de arquivo assíncrono para este lote.

AsyncBatchAnnotateFilesResponse

Resposta a uma solicitação de anotação de arquivo em lote assíncrona.

Campos
responses[]

AsyncAnnotateFileResponse

A lista de respostas de anotação de arquivo, uma para cada solicitação em AsyncBatchAnnotateFilesRequest.

AsyncBatchAnnotateImagesRequest

Solicitação de anotação de imagem assíncrona para uma lista de imagens.

Campos
requests[]

AnnotateImageRequest

Solicitações individuais de anotação de imagem para este lote.

output_config

OutputConfig

Obrigatório. O local e os metadados da saída desejados (por exemplo, formato).

AsyncBatchAnnotateImagesResponse

Resposta a uma solicitação de anotação de imagem em lote assíncrona.

Campos
output_config

OutputConfig

O local e os metadados da saída de AsyncBatchAnnotateImagesRequest.

BatchAnnotateFilesRequest

Uma lista de solicitações para fazer anotações em arquivos usando a API BatchAnnotateFiles.

Campos
requests[]

AnnotateFileRequest

A lista de solicitações de anotação de arquivo. Agora, oferecemos suporte apenas a um AnnotateFileRequest em BatchAnnotateFilesRequest.

BatchAnnotateFilesResponse

Uma lista de respostas de anotações de arquivos.

Campos
responses[]

AnnotateFileResponse

A lista de respostas de anotação de arquivo, cada resposta correspondente a cada AnnotateFileRequest em BatchAnnotateFilesRequest.

BatchAnnotateImagesRequest

Várias solicitações de anotação de imagem são agrupadas em uma única chamada de serviço.

Campos
requests[]

AnnotateImageRequest

Solicitações individuais de anotação de imagem para este lote.

BatchAnnotateImagesResponse

Resposta a uma solicitação de anotação de imagem em lote.

Campos
responses[]

AnnotateImageResponse

Respostas individuais às solicitações de anotação de imagem no lote.

BatchOperationMetadata

Metadados das operações em lote, como o estado atual.

Isso está incluído no campo metadata do Operation retornado pela chamada GetOperation do serviço google::longrunning::Operations.

Campos
state
(deprecated)

State

O estado atual da operação em lote.
submit_time

Timestamp

A hora em que a solicitação em lote foi enviada ao servidor.
end_time

Timestamp

A hora em que a solicitação em lote é concluída e google.longrunning.Operation.done é definido como verdadeiro.

State

Enumera os possíveis estados da solicitação em lote.

Enums
STATE_UNSPECIFIED Inválido.
PROCESSING A solicitação está sendo processada ativamente.
SUCCESSFUL A solicitação foi concluída e pelo menos um item foi processado com sucesso.
FAILED A solicitação foi concluída e nenhum item foi processado com sucesso.
CANCELLED A solicitação foi concluída após o usuário ter chamado longrunning.Operations.CancelOperation. Todos os registros que foram processados antes do comando de cancelamento são emitidos conforme especificado na solicitação.

Block

Elemento lógico na página.

Campos
property

TextProperty

Informações adicionais detectadas para o bloco.

bounding_box

BoundingPoly

A caixa delimitadora do bloco. Os vértices estão na ordem superior esquerda, superior direita, inferior direita e inferior esquerda. Quando uma rotação da caixa delimitadora é detectada, a rotação é representada ao redor do canto superior esquerdo, conforme definido quando o texto é lido na orientação "natural". Exemplo:

  • Quando o texto é horizontal, pode ser semelhante a:
    0----1
    |    |
    3----2
  • quando girada 180 graus em torno do canto superior esquerdo, ela se torna:
    2----3
    |    |
    1----0

e a ordem dos vértices ainda será (0, 1, 2, 3)
paragraphs[]

Paragraph

Lista de parágrafos neste bloco, se ele for do tipo "texto".

block_type

BlockType

Tipo de bloco detectado (texto, imagem etc.) para este bloco.

confidence

float

Confiança dos resultados do OCR no bloco. Intervalo [0, 1].

BlockType

Tipo de um bloco (texto, imagem etc.), conforme identificado pelo OCR.

Enums
UNKNOWN Tipo de bloco desconhecido
TEXT Bloco de texto regular
TABLE Bloco de tabelas
PICTURE Bloco de imagens
RULER Caixa de linha horizontal/vertical
BARCODE Bloco de códigos de barras

BoundingPoly

Um polígono delimitador para a anotação de imagem detectada.

Campos
vertices[]

Vertex

Os vértices do polígono delimitador.

normalized_vertices[]

NormalizedVertex

Os vértices normalizados do polígono delimitador.

ColorInfo

As informações de cores consistem em canais RGB, pontuação e a fração da imagem ocupada pela cor.

Campos
color

Color

Componentes RGB da cor.

score

float

Pontuação específica da imagem referente a esta cor. Valor no intervalo [0, 1].

pixel_fraction

float

A fração de pixels que a cor ocupa na imagem. Valor no intervalo [0, 1].

CreateProductRequest

Solicite mensagem para o método CreateProduct.

Campos
parent

string

O projeto em que o Produto precisa ser criado.

O formato é projects/PROJECT_ID/locations/LOC_ID.
product

Product

O produto a ser criado.

product_id

string

Um ID de recurso fornecido pelo usuário para este produto. Se definido, o servidor tentará usar esse valor como ID do recurso. Se já estiver em uso, um erro será retornado com o código ALREADY_EXISTS. Precisa ter no máximo 128 caracteres. Não pode conter o caractere /.

CreateProductSetRequest

Solicite mensagem para o método CreateProductSet.

Campos
parent

string

O projeto em que o ProductSet precisa ser criado.

O formato é projects/PROJECT_ID/locations/LOC_ID.
product_set

ProductSet

O ProductSet a ser criado.

product_set_id

string

Um ID de recurso fornecido pelo usuário para ProductSet. Se definido, o servidor tentará usar esse valor como ID do recurso. Se já estiver em uso, um erro será retornado com o código ALREADY_EXISTS. Precisa ter no máximo 128 caracteres. Não pode conter o caractere /.

CreateReferenceImageRequest

Solicite mensagem para o método CreateReferenceImage.

Campos
parent

string

Nome do recurso do produto onde será criada a imagem de referência.

O formato é projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.
reference_image

ReferenceImage

A imagem de referência a ser criada. Se um ID de imagem for especificado, ele será ignorado.

reference_image_id

string

Um código de recurso fornecido pelo usuário para a ReferenceImage a ser adicionada. Se definido, o servidor tentará usar esse valor como ID do recurso. Se já estiver em uso, um erro será retornado com o código ALREADY_EXISTS. Precisa ter no máximo 128 caracteres. Não pode conter o caractere /.

CropHint

Dica de corte único usada para gerar um novo corte ao suprir uma imagem.

Campos
bounding_poly

BoundingPoly

O polígono delimitador da região do corte. As coordenadas da caixa delimitadora estão na escala da imagem original.

confidence

float

A confiança de que se trata de uma região saliente. Intervalo [0, 1].

importance_fraction

float

Fração de importância desta região saliente em relação à imagem original.

CropHintsAnnotation

Conjunto de dicas de corte usadas para gerar novos cortes ao suprir as imagens.

Campos
crop_hints[]

CropHint

Resultados da dica de corte.

CropHintsParams

Parâmetros para solicitação de anotação de dicas de corte.

Campos
aspect_ratios[]

float

Índices proporcionais nas flutuações, representando a proporção entre a largura e a altura da imagem. Por exemplo, se a proporção desejada for 4/3, o valor de flutuação correspondente deverá ser 1,33333. Se ele não for especificado, o melhor corte possível será retornado. O número de proporções fornecidas tem um limite máximo de 16. Acima disso, elas serão ignoradas.

DeleteProductRequest

Solicite mensagem para o método DeleteProduct.

Campos
name

string

Nome do recurso do produto a ser excluído.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

DeleteProductSetRequest

Solicite mensagem para o método DeleteProductSet.

Campos
name

string

Nome do recurso do ProductSet a ser excluído.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

DeleteReferenceImageRequest

Solicite mensagem para o método DeleteReferenceImage.

Campos
name

string

O nome do recurso da imagem de referência a ser excluída.

O formato é:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID

DominantColorsAnnotation

Conjunto de cores dominantes e as pontuações correspondentes.

Campos
colors[]

ColorInfo

Valores de cor RGB com a respectiva fração de pontuação e pixel.

EntityAnnotation

Conjunto de recursos detectados da entidade.

Campos
mid

string

Código da entidade opaca. Alguns códigos podem estar disponíveis na Google Knowledge Graph Search API.

locale

string

O código do idioma do local em que o description textual da entidade é expresso.

description

string

Descrição textual da entidade, expressa no respectivo idioma locale.

score

float

Pontuação geral do resultado. Intervalo [0, 1].

confidence
(deprecated)

float

Obsoleto. Use score, em vez disso. A precisão da detecção de entidade em uma imagem. Por exemplo, para uma imagem em que a entidade "Torre Eiffel" é detectada, esse campo representa a confiança de que há uma torre na imagem da consulta. Intervalo [0, 1].
topicality

float

A relevância do marcador de anotação de conteúdo da imagem (ICA, na sigla em inglês) em relação à imagem. Por exemplo, a relevância de "torre" provavelmente é maior em uma imagem que contém a "Torre Eiffel" detectada do que em uma imagem com um prédio alto distante detectado, mesmo que a confiança de que há uma torre em cada imagem possa ser a mesma. Intervalo [0, 1].

bounding_poly

BoundingPoly

Região da imagem à qual esta entidade pertence. Não produzido para os recursos LABEL_DETECTION.

locations[]

LocationInfo

As informações de local da entidade detectada. Vários elementos de LocationInfo podem estar presentes porque um local pode indicar a localização da cena na imagem, e outro local pode indicar a localização do lugar em que a imagem foi tirada. Geralmente, as informações de local estão presentes para pontos de referência.

properties[]

Property

Algumas entidades podem ter campos opcionais de Property(nome/valor) fornecidos pelo usuário, como pontuação ou string que qualifica a entidade.

FaceAnnotation

Um objeto de anotação de rosto contém os resultados da detecção de rosto.

Campos
bounding_poly

BoundingPoly

O polígono delimitador ao redor do rosto. As coordenadas da caixa delimitadora estão na escala da imagem original. A caixa delimitadora é processada para "enquadrar" o rosto de acordo com as expectativas humanas. Ela usa como base os resultados do detector de ponto de referência. Uma ou mais coordenadas X ou Y talvez não sejam geradas no BoundingPoly (o polígono será ilimitado) se apenas parte do rosto aparecer na imagem que será anotada.

fd_bounding_poly

BoundingPoly

O polígono delimitador fd_bounding_poly é mais restrito que o boundingPoly e inclui apenas a parte da pele do rosto. Normalmente, ele é usado para eliminar o rosto de qualquer análise da imagem que detecta a "quantidade de pele" visível. Ele não se baseia nos resultados do detector de ponto de referência, apenas na detecção inicial de rosto. Por isso, há o prefixo

fd

(detecção de rosto).
landmarks[]

Landmark

Pontos de referência detectados do rosto.

roll_angle

float

Ângulo de giro, que indica a quantidade de rotação no sentido horário/anti-horário do rosto em relação à imagem vertical do eixo perpendicular ao rosto. Intervalo [-180,180].

pan_angle

float

Ângulo de desvio, que indica o ângulo de desvio para a esquerda/direita que o rosto aponta em relação ao plano vertical perpendicular à imagem. Intervalo [-180,180].

tilt_angle

float

Ângulo de inclinação, que indica o ângulo de inclinação para cima/baixo que o rosto aponta em relação ao plano horizontal da imagem. Intervalo [-180,180].

detection_confidence

float

Confiança da detecção. Intervalo [0, 1].

landmarking_confidence

float

Confiança da detecção de ponto de referência do rosto. Intervalo [0, 1].

joy_likelihood

Likelihood

Probabilidade de alegria.

sorrow_likelihood

Likelihood

Probabilidade de tristeza.

anger_likelihood

Likelihood

Probabilidade de raiva.

surprise_likelihood

Likelihood

Probabilidade de surpresa.

under_exposed_likelihood

Likelihood

Probabilidade de subexposição.

blurred_likelihood

Likelihood

Probabilidade de desfoque.

headwear_likelihood

Likelihood

Probabilidade de acessório na cabeça.

Ponto de referência

Um ponto de referência específico do rosto. Por exemplo, uma característica.

Campos
type

Type

Tipo de ponto de referência do rosto.

position

Position

Posição do ponto de referência do rosto.

Tipo

Tipo de ponto de referência do rosto (característica). A esquerda e a direita são definidas do ponto de vista do visualizador da imagem, sem considerar as projeções de espelhamento típicas das fotos. Normalmente, LEFT_EYE é o olho direito da pessoa.

Enums
UNKNOWN_LANDMARK Ponto de referência desconhecido do rosto detectado. Não preencha.
LEFT_EYE Olho esquerdo.
RIGHT_EYE Olho direito.
LEFT_OF_LEFT_EYEBROW Esquerda da sobrancelha esquerda.
RIGHT_OF_LEFT_EYEBROW Direita da sobrancelha esquerda.
LEFT_OF_RIGHT_EYEBROW Esquerda da sobrancelha direita.
RIGHT_OF_RIGHT_EYEBROW Direita da sobrancelha direita.
MIDPOINT_BETWEEN_EYES Ponto intermediário entre os olhos.
NOSE_TIP Ponta do nariz.
UPPER_LIP Lábio superior.
LOWER_LIP Lábio inferior.
MOUTH_LEFT Lado esquerdo da boca.
MOUTH_RIGHT Lado direito da boca.
MOUTH_CENTER Centro da boca.
NOSE_BOTTOM_RIGHT Nariz, parte inferior direita.
NOSE_BOTTOM_LEFT Nariz, parte inferior esquerda.
NOSE_BOTTOM_CENTER Nariz, centro inferior.
LEFT_EYE_TOP_BOUNDARY Olho esquerdo, limite superior.
LEFT_EYE_RIGHT_CORNER Olho esquerdo, canto direito.
LEFT_EYE_BOTTOM_BOUNDARY Olho esquerdo, limite inferior.
LEFT_EYE_LEFT_CORNER Olho esquerdo, canto esquerdo.
RIGHT_EYE_TOP_BOUNDARY Olho direito, limite superior.
RIGHT_EYE_RIGHT_CORNER Olho direito, canto direito.
RIGHT_EYE_BOTTOM_BOUNDARY Olho direito, limite inferior.
RIGHT_EYE_LEFT_CORNER Olho direito, canto esquerdo.
LEFT_EYEBROW_UPPER_MIDPOINT Sobrancelha esquerda, ponto intermediário superior.
RIGHT_EYEBROW_UPPER_MIDPOINT Sobrancelha direita, ponto intermediário superior.
LEFT_EAR_TRAGION Trágus da orelha esquerda.
RIGHT_EAR_TRAGION Trágus da orelha direita.
LEFT_EYE_PUPIL Pupila do olho esquerdo.
RIGHT_EYE_PUPIL Pupila do olho direito.
FOREHEAD_GLABELLA Glabela da testa.
CHIN_GNATHION Gnátio do queixo.
CHIN_LEFT_GONION Gônio esquerdo do queixo.
CHIN_RIGHT_GONION Gônio direito do queixo.

Recurso

O tipo de detecção da API Google Cloud Vision a ser executado e o número máximo de resultados a serem retornados para esse tipo. Vários objetos Feature podem ser especificados na lista features.

Campos
type

Type

O tipo de recurso.

max_results

int32

Número máximo de resultados deste tipo. Não se aplica a TEXT_DETECTION, DOCUMENT_TEXT_DETECTION ou CROP_HINTS.

model

string

Modelo para usar com o recurso. Valores aceitos: "builtin/stable", o padrão se não definido, e "builtin/latest".

Tipo

Tipo de recurso da API Google Cloud Vision que será extraído.

Enums
TYPE_UNSPECIFIED Tipo de recurso não especificado.
FACE_DETECTION Executar detecção de rosto.
LANDMARK_DETECTION Executar detecção de ponto de referência.
LOGO_DETECTION Executar detecção de logotipo.
LABEL_DETECTION Executar detecção de marcadores.
TEXT_DETECTION Realizar reconhecimento de caracteres/reconhecimento de caracteres ópticos (OCR, na sigla em inglês). A detecção de texto é otimizada para áreas de texto em uma imagem maior. Se a imagem for um documento, use DOCUMENT_TEXT_DETECTION.
DOCUMENT_TEXT_DETECTION Executar o OCR denso do documento de texto. Tem precedência quando DOCUMENT_TEXT_DETECTION e TEXT_DETECTION estão presentes.
SAFE_SEARCH_DETECTION Executar a Pesquisa segura para detectar conteúdo possivelmente inseguro ou indesejável.
IMAGE_PROPERTIES Calcular um conjunto de propriedades de imagem, como as cores dominantes.
CROP_HINTS Executar dicas de corte.
WEB_DETECTION Executar detecção da Web.
OBJECT_LOCALIZATION Execute o localizador para detecção de objetos.

GcsDestination

O local do Google Cloud Storage em que a saída precisa ser gravada.

Campos
uri

string

O prefixo URI do Google Cloud Storage em que os resultados serão armazenados. Os resultados estarão no formato JSON e precedidos pelo prefixo de URI de entrada correspondente. Esse campo pode representar um prefixo de arquivo ou um diretório do Google Cloud Storage. Em ambos os casos, o URI precisa ser exclusivo porque, para conseguir todos os arquivos de saída, você precisará fazer uma pesquisa curinga do Google Cloud Storage no prefixo de URI fornecido.

Exemplos:

Se várias saídas, cada resposta ainda será AnnotationFileResponse, cada uma contendo um subconjunto da lista completa de AnnotateImageResponse. Várias saídas podem acontecer se, por exemplo, o JSON de saída for muito grande e transbordar em vários arquivos fragmentados.

GcsSource

O local do Google Cloud Storage em que a entrada será lida.

Campos
uri

string

URI do Google Cloud Storage para o arquivo de entrada. Precisa ser apenas um objeto do Google Cloud Storage. Caracteres curinga não são compatíveis no momento.

GetProductRequest

Solicite a mensagem para o método GetProduct.

Campos
name

string

Nome do recurso do produto a ser recebido.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

GetProductSetRequest

Solicite a mensagem para o método GetProductSet.

Campos
name

string

Nome do recurso do ProductSet a ser recebido.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

GetReferenceImageRequest

Solicite a mensagem para o método GetReferenceImage.

Campos
name

string

O nome do recurso do ReferenceImage a ser recebido.

O formato é:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID

Image

Imagem do cliente na qual executar as tarefas da Google Cloud Vision API.

Campos
content

bytes

Conteúdo da imagem, representado como um stream de bytes. Observação: assim como acontece com todos os campos bytes, os protobuffers usam uma representação binária pura, e as representações JSON usam base64.

source

ImageSource

URL da imagem do Google Cloud Storage ou URL da imagem acessível publicamente. Se content e source forem fornecidos para uma imagem, content terá precedência e será usado para executar a solicitação de anotação de imagem.

ImageAnnotationContext

Se uma imagem foi produzida com base em um arquivo (por exemplo, um PDF), essa mensagem fornece informações sobre a origem dessa imagem.

Campos
uri

string

O URI do arquivo usado para produzir a imagem.

page_number

int32

Se o arquivo for um PDF ou TIFF, esse campo fornecerá o número da página no arquivo usado para produzir a imagem.

ImageContext

Contexto da imagem e/ou parâmetros específicos do recurso.

Campos
lat_long_rect

LatLongRect

Não utilizado.

language_hints[]

string

Lista de idiomas a serem usados para TEXT_DETECTION. Na maioria dos casos, um valor vazio produz os melhores resultados, já que ele possibilita a detecção automática do idioma. Para idiomas com base no alfabeto latino, não é necessário definir language_hints. Em alguns casos raros, quando o idioma do texto na imagem é conhecido, você recebe resultados melhores definindo uma dica. No entanto, isso poderá ser um problema se ela for definida incorretamente. A detecção de texto retornará um erro se um ou mais dos idiomas especificados não forem compatíveis.

crop_hints_params

CropHintsParams

Parâmetros para solicitação de anotação de dicas de corte.

product_search_params

ProductSearchParams

Parâmetros para pesquisa de produtos.

web_detection_params

WebDetectionParams

Parâmetros para detecção da Web.

ImageProperties

Armazena as propriedades da imagem, como as cores dominantes.

Campos
dominant_colors

DominantColorsAnnotation

Se presente, as cores dominantes foram concluídas com sucesso.

ImageSource

Origem da imagem externa (Google Cloud Storage ou local da imagem do URL da Web).

Campos
gcs_image_uri

string

Use image_uri, em vez disso.

O URI do Google Cloud Storage no formato gs://bucket_name/object_name. O controle de versão de objeto não é compatível. Consulte URIs de solicitação do Google Cloud Storage para mais informações.
image_uri

string

O URI da imagem de origem. Pode ser:

  1. Um URI do Google Cloud Storage no formato gs://bucket_name/object_name. O controle de versão de objeto não é compatível. Consulte URIs de solicitação do Google Cloud Storage para mais informações.

  2. Um URL HTTP/HTTPS de imagem acessível publicamente. Ao buscar imagens de URLs HTTP/HTTPS, o Google não pode garantir que a solicitação seja concluída. A solicitação poderá falhar se o host especificado negá-la (por exemplo, por causa de limitação da solicitação ou prevenção de DOS) ou se o Google limitar as solicitações ao site para prevenção de abuso. Não convém depender de imagens hospedadas externamente para aplicativos de produção.

Quando gcs_image_uri e image_uri são especificados, image_uri tem precedência.

ImportProductSetsGcsSource

O local do Google Cloud Storage para um arquivo csv que preserva uma lista de ImportProductSetRequests em cada linha.

Campos
csv_file_uri

string

O URI do Google Cloud Storage do arquivo csv de entrada.

O URI precisa começar com gs://.

O formato do arquivo CSV de entrada deve ser uma imagem por linha. Em cada linha, há oito colunas.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. rótulos
  8. bounding-poly

As colunas image-uri, product-set-id, product-id e product-category são obrigatórias. Todas as outras colunas são opcionais.

Se o ProductSet ou Product especificado pelos valores product-set-id e product-id não existir, o sistema criará um novo ProductSet ou Product para a imagem. Nesse caso, a coluna product-display-name refere-se a display_name, a coluna product-category refere-se a product_category e a coluna labels refere-se a product_labels.

A coluna image-id é opcional, mas precisa ser exclusiva se fornecida. Se estiver vazio, o sistema atribuirá automaticamente um ID exclusivo à imagem.

A coluna product-display-name é opcional. Se ele estiver vazio, o sistema definirá o campo display_name do produto como um espaço (" "). É possível atualizar o display_name posteriormente usando a API.

Se um Product com o product-id especificado já existir, o sistema ignorará as colunas product-display-name, product-category e labels.

A coluna labels (opcional) é uma linha com uma lista de pares de chave-valor separados por vírgula, no seguinte formato:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

A coluna bounding-poly (opcional) identifica uma região de interesse da imagem da mesma forma que CreateReferenceImage. Se você não especificar a coluna bounding-poly, o sistema tentará detectar automaticamente as regiões de interesse.

No máximo, uma coluna bounding-poly é permitida por linha. Se a imagem contiver várias regiões de interesse, adicione uma linha ao arquivo CSV que inclua as mesmas informações de produto, bem como os valores bounding-poly de cada região de interesse.

A coluna bounding-poly precisa conter um número par de números separados por vírgula, no formato "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Use inteiros não negativos para polígonos delimitadores absolutos e valores flutuantes em [0, 1] para polígonos delimitadores normalizados.

O sistema redimensionará a imagem se ela for muito grande para processar (maior que 20 MP).

ImportProductSetsInputConfig

O conteúdo de entrada para o método ImportProductSets.

Campos
gcs_source

ImportProductSetsGcsSource

O local do Google Cloud Storage para um arquivo csv que preserva uma lista de ImportProductSetRequests em cada linha.

ImportProductSetsRequest

Solicite mensagem para o método ImportProductSets.

Campos
parent

string

O projeto em que os ProductSets precisam ser importados.

O formato é projects/PROJECT_ID/locations/LOC_ID.
input_config

ImportProductSetsInputConfig

O conteúdo de entrada da lista de solicitações.

ImportProductSetsResponse

Mensagem de resposta para o método ImportProductSets.

Essa mensagem é retornada pelo método google.longrunning.Operations.GetOperation no campo google.longrunning.Operation.response retornado.

Campos
reference_images[]

ReferenceImage

A lista de reference_images importadas com êxito.

statuses[]

Status

O status de rpc de cada solicitação ImportProductSet, incluindo sucessos e erros.

O número de status aqui corresponde ao número de linhas no arquivo csv, e os status[i] armazenam o status de sucesso ou com falha do processamento da linha i do csv, começando pela linha 0.

InputConfig

O local e os metadados da entrada desejados.

Campos
gcs_source

GcsSource

Local do Google Cloud Storage onde será lida a entrada.

content

bytes

Conteúdo do arquivo, representado como um stream de bytes. Observação: assim como acontece com todos os campos bytes, os protobuffers usam uma representação binária pura, e as representações JSON usam base64.

Atualmente, esse campo só funciona para solicitações BatchAnnotateFiles. Ele não funciona para solicitações AsyncBatchAnnotateFiles.
mime_type

string

O tipo do arquivo. Atualmente, apenas "application/pdf", "image/tiff" e "image/gif" são compatíveis. Caracteres curinga não são aceitos.

LatLongRect

Retângulo determinado pelos pares "min" e "max" de LatLng.

Campos
min_lat_lng

LatLng

Par "lat/long" mínimo.

max_lat_lng

LatLng

Par "lat/long" máximo.

Likelihood

Uma representação de probabilidade em intervalos com o objetivo de gerar resultados altamente estáveis aos clientes em todos os upgrades de modelo.

Enums
UNKNOWN Probabilidade desconhecida.
VERY_UNLIKELY É muito improvável que a imagem pertença à vertical especificada.
UNLIKELY É improvável que a imagem pertença à vertical especificada.
POSSIBLE É possível que a imagem pertença à vertical especificada.
LIKELY É provável que a imagem pertença à vertical especificada.
VERY_LIKELY É muito provável que a imagem pertença à vertical especificada.

ListProductSetsRequest

Solicite a mensagem para o método ListProductSets.

Campos
parent

string

O projeto do qual o ProductSets precisa ser listado.

O formato é projects/PROJECT_ID/locations/LOC_ID.
page_size

int32

O número máximo de itens para retornar. 10 (padrão), no máximo 100.

page_token

string

O next_page_token retornado de uma solicitação List anterior, se houver.

ListProductSetsResponse

Mensagem de resposta para o método ListProductSets.

Campos
product_sets[]

ProductSet

Lista de ProductSets.

next_page_token

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

ListProductsInProductSetRequest

Solicite a mensagem para o método ListProductsInProductSet.

Campos
name

string

O recurso ProductSet onde os produtos serão recuperados.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
page_size

int32

O número máximo de itens para retornar. 10 (padrão), no máximo 100.

page_token

string

O next_page_token retornado de uma solicitação List anterior, se houver.

ListProductsInProductSetResponse

Mensagem de resposta para o método ListProductsInProductSet.

Campos
products[]

Product

Lista de Products.

next_page_token

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

ListProductsRequest

Solicite a mensagem para o método ListProducts.

Campos
parent

string

O projeto OU o ProductSet a partir do qual os produtos precisam ser listados.

Formato: projects/PROJECT_ID/locations/LOC_ID
page_size

int32

O número máximo de itens para retornar. 10 (padrão), no máximo 100.

page_token

string

O next_page_token retornado de uma solicitação List anterior, se houver.

ListProductsResponse

Mensagem de resposta para o método ListProducts.

Campos
products[]

Product

Lista de produtos.

next_page_token

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

ListReferenceImagesRequest

Solicite a mensagem para o método ListReferenceImages.

Campos
parent

string

Nome do recurso do produto que contém as imagens de referência.

O formato é projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.
page_size

int32

O número máximo de itens para retornar. 10 (padrão), no máximo 100.

page_token

string

Um token que identifica uma página de resultados a serem retornados. Este é o valor de nextPageToken retornado em uma solicitação de lista de imagens de referência anterior.

Se não for especificado, o padrão será a primeira página.

ListReferenceImagesResponse

Mensagem de resposta para o método ListReferenceImages.

Campos
reference_images[]

ReferenceImage

A lista de imagens de referência.

page_size

int32

O número máximo de itens para retornar. 10 (padrão), no máximo 100.

next_page_token

string

O next_page_token retornado de uma solicitação List anterior, se houver.

LocalizedObjectAnnotation

Conjunto de objetos detectados com caixas delimitadoras.

Campos
mid

string

ID do objeto que deve se alinhar com EntityAnnotation no meio.

language_code

string

O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nome do objeto, expresso no idioma language_code.

score

float

Pontuação do resultado. Intervalo [0, 1].

bounding_poly

BoundingPoly

Região da imagem à qual este objeto pertence. Esse campo precisa ser preenchido.

LocationInfo

Informações de local da entidade detectada.

Campos
lat_lng

LatLng

Coordenadas de local "lat/long".

NormalizedVertex

Um vértice representa um ponto 2D na imagem. OBSERVAÇÃO: as coordenadas do vértice normalizado são relativas à imagem original e variam de 0 a 1.

Campos
x

float

Coordenada X.

y

float

Coordenada Y.

OperationMetadata

Contém metadados para a operação BatchAnnotateImages.

Campos
state
(deprecated)

State

Estado atual da operação em lote.
create_time

Timestamp

A hora em que a solicitação em lote foi recebida.
update_time

Timestamp

A hora em que o resultado da operação foi atualizado pela última vez.

State

Estados de operação em lote.

Enums
STATE_UNSPECIFIED Inválido.
CREATED A solicitação é recebida.
RUNNING A solicitação está sendo processada ativamente.
DONE O processamento em lote foi concluído.
CANCELLED O processamento em lote foi cancelado.

OutputConfig

O local e os metadados da saída desejados.

Campos
gcs_destination

GcsDestination

O local do Google Cloud Storage em que a saída será gravada.

batch_size

int32

O número máximo de protos de resposta a serem colocados em cada arquivo JSON de saída no Google Cloud Storage. O intervalo válido é [1, 100]. Se não for especificado, o valor padrão será 20.

Por exemplo, para um arquivo PDF com 100 páginas, serão gerados 100 protos de resposta. Se batch_size = 20, então cinco arquivos json, cada qual contendo 20 protos de resposta, serão gravados com o prefixo gcs_destination.uri.

Atualmente, batch_size se aplica apenas ao GcsDestination, com possível suporte futuro para outras configurações de saída.

Page

Página detectada do OCR.

Campos
property

TextProperty

Informações adicionais detectadas na página.

width

int32

Largura da página. Nos PDFs, a unidade é a pontuação. Para imagens (incluindo TIFFs), a unidade é pixels

height

int32

Altura da página. Nos PDFs, a unidade é a pontuação. Para imagens (incluindo TIFFs), a unidade é pixels

blocks[]

Block

Lista de blocos de texto, imagens, entre outros, nesta página.

confidence

float

Confiança dos resultados do OCR na página. Intervalo [0, 1].

Paragraph

Unidade estrutural de texto que representa uma série de palavras em determinada ordem.

Campos
property

TextProperty

Informações adicionais detectadas para o parágrafo.

bounding_box

BoundingPoly

A caixa delimitadora do parágrafo. Os vértices estão na ordem superior esquerda, superior direita, inferior direita e inferior esquerda. Quando uma rotação da caixa delimitadora é detectada, a rotação é representada ao redor do canto superior esquerdo, conforme definido quando o texto é lido na orientação "natural". Por exemplo: * quando o texto for horizontal, a aparência será: 0----1 | | 3----2 * quando for girado em 180 graus em torno do canto superior esquerdo, torna-se: 2----3 | | 1----0 e a ordem dos vértices ainda será (0, 1, 2, 3).

words[]

Word

Lista de palavras neste parágrafo.

confidence

float

Confiança dos resultados do OCR para o parágrafo. Intervalo [0, 1].

Position

Uma posição 3D na imagem, usada principalmente para pontos de referência de detecção de rosto. Uma posição válida precisa ter as coordenadas X e Y. As coordenadas da posição estão na mesma escala que a imagem original.

Campos
x

float

Coordenada X.

y

float

Coordenada Y.

z

float

Coordenada Z (ou profundidade).

Produto

Um produto contém ReferenceImages.

Campos
name

string

O nome do recurso do produto.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Esse campo é ignorado quando um produto é criado.
display_name

string

O nome fornecido pelo usuário para este produto. Não pode ficar em branco Precisa ter no máximo 4.096 caracteres.

description

string

Metadados fornecidos pelo usuário a serem armazenados com esse produto. Precisa ter no máximo 4.096 caracteres.

product_category

string

A categoria do produto identificado pela imagem de referência. Deve ser "homegoods-v2", "apparel-v2", "toys-v2" ou "packagedgoods-v1". As categorias legadas "homegoods", "apparel" e "toys" ainda são compatíveis, mas serão descontinuadas. Para novos produtos, use "homegoods-v2", "apparel-v2" ou "toys-v2" para melhorar a precisão da pesquisa de produtos. É recomendável migrar também os produtos para essas categorias.

Este campo não pode ser modificado.
product_labels[]

KeyValue

Pares de chave-valor que podem ser anexados a um produto. No momento da consulta, é possível especificar restrições com base nos product_labels.

Observe que valores inteiros podem ser fornecidos como strings. Por exemplo, "1199". Somente strings com valores inteiros podem corresponder a uma restrição baseada em intervalo, que será aceita em breve.

Vários valores podem ser atribuídos à mesma chave. Um produto pode ter até 100 product_labels.

KeyValue

Um rótulo de produto representado como um par de chave-valor.

Campos
key

string

A chave do rótulo anexado ao produto. Não pode estar vazio e não pode exceder 128 bytes.

value

string

O valor do rótulo anexado ao produto. Não pode estar vazio e não pode exceder 128 bytes.

ProductSearchParams

Parâmetros para uma solicitação de pesquisa de produto.

Campos
bounding_poly

BoundingPoly

O polígono delimitador ao redor da área de interesse na imagem. Opcional. Se não for especificado, a discrição do sistema será aplicada.

product_set

string

O nome do recurso de um ProductSet a ser pesquisado para imagens semelhantes.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.
product_categories[]

string

A lista de categorias de produto para pesquisar. No momento, consideramos apenas a primeira categoria, e é necessário especificar "homegoods-v2", "apparel-v2" ou "toys-v2". As categorias legadas "homegoods", "vestuário" e "brinquedos" ainda são compatíveis, mas terão o uso suspenso. Para novos produtos, use "homegoods-v2", "app-rel-v2" ou "brinquedos-v2" para melhorar a precisão da pesquisa de produtos. É recomendável migrar também os produtos para essas categorias.

filter

string

A expressão de filtragem. Essa opção pode ser usada para restringir os resultados da pesquisa com base nos rótulos do produto. No momento, aceitamos AND de expressões de valor-chave, em que cada expressão em OR precisa ter a mesma chave. Um '=' deve ser usado para conectar a chave e o valor.

Por exemplo, "(cor = vermelho OU cor = azul) E marca = Google" é aceitável, mas "(cor = vermelho OU marca = Google)" não é aceitável. "color: red" não é aceitável porque usa um ":" em vez de um "=".

ProductSearchResults

Resultados para uma solicitação de pesquisa de produto.

Campos
index_time

Timestamp

O carimbo de data/hora do índice que forneceu esses resultados. Os produtos adicionados ao conjunto de produtos e os produtos removidos desse conjunto não serão refletidos nos resultados atuais.

results[]

Result

Lista de resultados, um para cada correspondência de produto.

product_grouped_results[]

GroupedResult

Lista de resultados agrupados por produtos detectados na imagem da consulta. Cada entrada corresponde a um polígono delimitador na imagem da consulta e contém os produtos correspondentes específicos dessa região. Pode haver correspondências duplicadas de produtos na união de todos os resultados por produto.

GroupedResult

Informações sobre os produtos semelhantes a um único produto em uma imagem de consulta.

Campos
bounding_poly

BoundingPoly

O polígono delimitador ao redor do produto detectado na imagem da consulta.

results[]

Result

Lista de resultados, um para cada correspondência de produto.

Resultado

Informações sobre um produto.

Campos
product

Product

O produto.

score

float

Um nível de confiança na correspondência, variando de 0 (nenhuma confiança) a 1 (confiança total).

image

string

O nome do recurso da imagem do produto que é o mais próximo da consulta.

ProductSet

Um ProductSet contém produtos. Um ProductSet pode conter no máximo um milhão de imagens de referência. Se o limite for excedido, a indexação periódica falhará.

Campos
name

string

O nome do recurso do ProductSet.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.

Esse campo é ignorado ao criar um ProductSet.
display_name

string

O nome fornecido pelo usuário para este ProductSet. Não pode ficar em branco Precisa ter no máximo 4.096 caracteres.

index_time

Timestamp

Apenas saída. A hora em que este ProductSet foi indexado pela última vez. Os resultados da consulta refletirão todas as atualizações anteriores a esse período. Se este ProductSet nunca tiver sido indexado, esse carimbo de data/hora será o valor padrão "1970-01-01T00:00:00Z".

Esse campo é ignorado ao criar um ProductSet.
index_error

Status

Apenas saída. Se ocorrer um erro na indexação do conjunto de produtos, o campo será preenchido.

Esse campo é ignorado ao criar um ProductSet.

Propriedade

Uma Property consiste em um par nome/valor fornecido pelo usuário.

Campos
name

string

Nome da propriedade.

value

string

Valor da propriedade.

uint64_value

uint64

Valor das propriedades numéricas.

ReferenceImage

Uma ReferenceImage representa uma imagem de produto e os metadados associados, como caixas delimitadoras.

Campos
name

string

O nome do recurso da imagem de referência.

O formato é:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID

Esse campo é ignorado quando uma imagem de referência é criada.
uri

string

URI do Google Cloud Storage da imagem de referência.

O URI precisa começar com gs://.

Obrigatório.
bounding_polys[]

BoundingPoly

Polígonos delimitadores em torno das áreas de interesse na imagem de referência. Opcional. Se este campo estiver vazio, o sistema tentará detectar regiões de interesse. No máximo, 10 polígonos delimitadores serão usados.

A forma fornecida é convertida em um retângulo não girado. Depois de convertida, a borda pequena do retângulo precisa ser maior ou igual a 300 pixels. A proporção deve ser de 1:4 ou menos (ou seja, 1:3 é aceitável; 1:5 não é).

RemoveProductFromProductSetRequest

Solicite a mensagem para o método RemoveProductFromProductSet.

Campos
name

string

O nome do recurso para o ProductSet a ser modificado.

O formato é: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
product

string

O nome do recurso para o produto a ser removido deste ProductSet.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

SafeSearchAnnotation

Conjunto de recursos pertencentes à imagem, calculados por métodos de visão computacional em verticais da pesquisa segura. Por exemplo, conteúdo adulto, paródia, assunto médico, violência.

Campos
adult

Likelihood

Representa a probabilidade de conteúdo adulto na imagem. O conteúdo adulto pode conter elementos como nudez, imagens ou desenhos animados pornográficos ou atividades sexuais.

spoof

Likelihood

Probabilidade de paródia. A probabilidade de uma modificação ter sido feita na versão canônica da imagem para que pareça engraçada ou ofensiva.

medical

Likelihood

Probabilidade de ser uma imagem médica.

violence

Likelihood

Probabilidade de ser uma imagem com conteúdo violento.

racy

Likelihood

Probabilidade de conteúdo indecente na imagem da solicitação. Conteúdo indecente pode incluir mas não está limitado a: roupas curtas ou transparentes, nudez estrategicamente coberta, poses obscenas ou provocativas ou closes de partes inapropriadas do corpo.

Symbol

Uma única representação de símbolo.

Campos
property

TextProperty

Informações adicionais detectadas para o símbolo.

bounding_box

BoundingPoly

A caixa delimitadora do símbolo. Os vértices estão na ordem superior esquerda, superior direita, inferior direita e inferior esquerda. Quando uma rotação da caixa delimitadora é detectada, a rotação é representada ao redor do canto superior esquerdo, conforme definido quando o texto é lido na orientação "natural". Por exemplo: * quando o texto é horizontal, pode ter esta aparência: 0 ---- 1 | | 3 ---- 2. * Quando é girado 180 graus em torno do canto superior esquerdo, ele muda para: 2 ---- 3 | | 1 ---- 0, e a ordem do vértice ainda é (0, 1, 2, 3).

text

string

A representação UTF-8 real do símbolo.

confidence

float

Confiança dos resultados do OCR para o símbolo. Intervalo [0, 1].

TextAnnotation

TextAnnotation contém uma representação estruturada do texto extraído pelo OCR. A hierarquia de uma estrutura de texto extraído pelo OCR tem esta aparência: TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol. Cada componente estrutural, começando por Page, ainda pode ter propriedades próprias. As propriedades descrevem os idiomas detectados, as quebras etc. Consulte a definição da mensagem TextAnnotation.TextProperty abaixo para mais detalhes.

Campos
pages[]

Page

Lista de páginas detectadas pelo OCR.

text

string

Texto UTF-8 detectado nas páginas.

DetectedBreak

Início ou fim da detecção de um componente estrutural.

Campos
type

BreakType

Tipo de quebra detectado.

is_prefix

bool

Verdadeiro se a quebra preceder o elemento.

BreakType

Enum para denotar o tipo de quebra encontrado. Nova linha, espaço etc.

Enums
UNKNOWN Tipo de marcador de quebra desconhecido.
SPACE Espaço regular.
SURE_SPACE Espaço garantido (muito largo).
EOL_SURE_SPACE Quebra de linha.
HYPHEN Hífen de fim de linha que não está presente no texto. Não ocorre juntamente com SPACE, LEADER_SPACE ou LINE_BREAK.
LINE_BREAK Quebra de linha que termina um parágrafo.

DetectedLanguage

Idioma detectado para um componente estrutural.

Campos
language_code

string

O código de idioma BCP-47, como "en-US" ou "sr-Latn". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

float

Confiança do idioma detectado. Intervalo [0, 1].

TextProperty

Informações adicionais detectadas sobre o componente estrutural.

Campos
detected_languages[]

DetectedLanguage

Uma lista de idiomas detectados juntamente com a confiança.

detected_break

DetectedBreak

Início ou fim detectado de um segmento de texto.

UpdateProductRequest

Solicite a mensagem para o método UpdateProduct.

Campos
product

Product

O recurso Product que substitui o recurso no servidor product.name é imutável.

update_mask

FieldMask

O FieldMask que especifica quais campos serão atualizados. Se update_mask não for especificado, todos os campos mutáveis serão atualizados. Os caminhos de máscara válidos incluem product_labels, display_name e description.

UpdateProductSetRequest

Solicite a mensagem para o método UpdateProductSet.

Campos
product_set

ProductSet

O recurso ProductSet que substitui aquele que está no servidor.

update_mask

FieldMask

O FieldMask que especifica quais campos serão atualizados. Se update_mask não for especificado, todos os campos mutáveis serão atualizados. O caminho de máscara válido é display_name.

Vertex

Um vértice representa um ponto 2D na imagem. OBSERVAÇÃO: as coordenadas do vértice estão na mesma escala que a imagem original.

Campos
x

int32

Coordenada X.

y

int32

Coordenada Y.

WebDetection

Informações relevantes sobre a imagem da Internet.

Campos
web_entities[]

WebEntity

Entidades deduzidas de imagens semelhantes na Internet.

full_matching_images[]

WebImage

Imagens da Internet totalmente correspondentes. Pode incluir cópias redimensionadas da imagem de consulta.

partial_matching_images[]

WebImage

Imagens da Internet parcialmente correspondentes. Elas são semelhantes o suficiente para compartilhar algumas características importantes. Por exemplo, uma imagem original provavelmente apresenta correspondência parcial em relação aos cortes.

pages_with_matching_images[]

WebPage

Páginas da Web que contêm as imagens correspondentes da Internet.

visually_similar_images[]

WebImage

Os resultados visualmente semelhantes da imagem.

best_guess_labels[]

WebLabel

O melhor palpite do serviço quanto ao tópico da imagem da solicitação. Inferido a partir de imagens semelhantes na Web aberta.

WebEntity

Entidade deduzida de imagens semelhantes na Internet.

Campos
entity_id

string

Código da entidade opaca.

score

float

Pontuação geral de relevância da entidade. Não normalizada e não comparável em diferentes consultas de imagem.

description

string

Descrição canônica da entidade, em inglês.

WebImage

Metadados das imagens on-line.

Campos
url

string

O URL da imagem do resultado.

score

float

Pontuação geral de relevância da imagem (obsoleta).

WebLabel

Marcador para fornecer metadados adicionais para detecção da Web.

Campos
label

string

Marcador para metadados adicionais.

language_code

string

O código de idioma BCP-47 para label, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

WebPage

Metadados para páginas da Web.

Campos
url

string

O URL da página da Web de resultados.

score

float

Pontuação geral de relevância para a página da Web (obsoleta).

page_title

string

Título da página da Web, pode conter marcações HTML.

full_matching_images[]

WebImage

Imagens totalmente correspondentes na página. Pode incluir cópias redimensionadas da imagem de consulta.

partial_matching_images[]

WebImage

Imagens parcialmente correspondentes na página. Elas são semelhantes o suficiente para compartilhar algumas características importantes. Por exemplo, uma imagem original provavelmente apresenta correspondência parcial em relação aos cortes.

WebDetectionParams

Parâmetros para solicitação de detecção da Web.

Campos
include_geo_results

bool

Determina se é para incluir resultados derivados das informações geográficas na imagem.

Word

Uma representação de palavra.

Campos
property

TextProperty

Informações adicionais detectadas para a palavra.

bounding_box

BoundingPoly

A caixa delimitadora da palavra. Os vértices estão na ordem superior esquerda, superior direita, inferior direita e inferior esquerda. Quando uma rotação da caixa delimitadora é detectada, a rotação é representada ao redor do canto superior esquerdo, conforme definido quando o texto é lido na orientação "natural". Por exemplo: * quando o texto for horizontal, a aparência será: 0----1 | | 3----2 * quando for girado em 180 graus em torno do canto superior esquerdo, torna-se: 2----3 | | 1----0 e a ordem dos vértices ainda será (0, 1, 2, 3).

symbols[]

Symbol

Lista de símbolos na palavra. A ordem dos símbolos segue a ordem de leitura natural.

confidence

float

Confiança dos resultados do OCR para a palavra. Intervalo [0, 1].