Package google.cloud.vision.v1

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

end_time

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.

Tipos enumerados
`STATE_UNSPECIFIED`	Inválido.
`PROCESSING`	A solicitação está sendo processada.
`SUCCESSFUL`	A solicitação foi concluída e pelo menos um item foi processado.
`FAILED`	A solicitação foi concluída e nenhum item foi processado.
`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 seguinte ordem: superior esquerda, superior direita, inferior direita e inferior esquerda. Quando for detectada uma rotação da caixa delimitadora, ela será representada no canto superior esquerdo, como definido pela leitura do texto na orientação natural. Exemplo: Quando o texto é horizontal, pode ser semelhante ao seguinte: `0----1 \| \| 3----2` Quando girado 180 graus em torno do canto superior esquerdo, ele 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].
`table`	`Table` Tabela detectada para TABLE block_type. Por padrão, esse campo não é retornado, a menos que seja ativado por TextDetectionParams.table_detection_options. O `bounding_box` desse bloco será os limites detectados para essa tabela.
`key_value_pair`	`KeyValuePair` Par detectado para KEY_VALUE_PAIR block_type. Este campo é retornado por padrão, a menos que DocumentType seja especificado.
`merged_text`	`string` Todo o texto UTF-8 foi detectado neste bloco. Por padrão, esse campo não é retornado, a menos que especificado em TextDetectionParams.block_filter.

BlockType

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

Tipos enumerados
`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
`KEY_VALUE_PAIR`	Um bloco de pares de chave-valor.

BoundingPoly

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

Campos

Campos
`vertices[]`	`Vertex` Os vértices do polígono delimitador.
`normalized_vertices[]`	`NormalizedVertex` Os vértices normalizados do polígono delimitador.

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

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].

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

Mensagem de solicitação para o método CreateProduct.

Campos

Campos
`parent`	`string` O projeto em que o Product 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 o Product. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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 `/`.

parent

string

O projeto em que o Product será criado.

O formato é projects/PROJECT_ID/locations/LOC_ID.

product

O produto a ser criado.

product_id

string

Um ID de recurso fornecido pelo usuário para o Product. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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

Mensagem de solicitação para o método CreateProductSet.

Campos

Campos
`parent`	`string` O projeto em que o ProductSet 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 o ProductSet. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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 `/`.

parent

string

O projeto em que o ProductSet 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 o ProductSet. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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

Mensagem de solicitação para o método CreateReferenceImage.

Campos

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 ID de recurso fornecido pelo usuário para a ReferenceImage a ser adicionada. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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 `/`.

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 ID de recurso fornecido pelo usuário para a ReferenceImage a ser adicionada. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja 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

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.

bounding_poly

DominantColorsAnnotation

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

Campos
`crop_hints[]`	`CropHint` Resultados da dica de corte.

crop_hints[]

CropHint

Resultados da dica de corte.

CropHintsParams

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

Campos

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.

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.

CustomEntityAnnotation

Um CustomEntityAnnotation contém anotações previstas usando modelos personalizados do Vision.

Campos

Campos
`model`	`string` Identifica o modelo personalizado usado para criar essa anotação. O formato do nome do modelo é o URL do recurso do modo personalizado que foi consultado: `/projects/PROJECT_ID/models/MODEL_ID`, ou `/models/MODEL_ID` se o modelo pertencer ao projeto atual.
`label`	`string` O rótulo previsto pelo modelo personalizado.
`score`	`float` A pontuação de confiança do rótulo pelo modelo personalizado.

model

string

Identifica o modelo personalizado usado para criar essa anotação. O formato do nome do modelo é o URL do recurso do modo personalizado que foi consultado: /projects/PROJECT_ID/models/MODEL_ID, ou /models/MODEL_ID se o modelo pertencer ao projeto atual.

label

string

O rótulo previsto pelo modelo personalizado.

score

float

A pontuação de confiança do rótulo pelo modelo personalizado.

DeleteProductRequest

Mensagem de solicitação 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

Mensagem de solicitação 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

Mensagem de solicitação 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

DocumentParsingParams

Parâmetros para o recurso DOCUMENT_PARSING.

Campos

disable_orientation_detection

bool

Desativa a detecção de orientação, para que o texto girado não seja detectado.

table_detection_options

TableDetectionOptions

Controla o comportamento de detecção da tabela. A detecção de tabelas será desativada se esse campo não for definido.

document_type

string

Especifique um tipo de documento conhecido para detectar mais detalhes da estrutura. No momento, os valores válidos são "fatura" ou "geral".

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 da localidade em que a `description` textual da entidade é expressa.
`description`	`string` Descrição textual da entidade, expressa no respectivo idioma de `locale`.
`score`	`float` Pontuação geral do resultado. Intervalo [0, 1].
`confidence (deprecated)`	`float` Este item foi descontinuado. Descontinuado. Use `score`. 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 a que 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 pode indicar a localização do lugar em que a imagem foi gerada. Em geral, há informações de local disponíveis 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 facial.

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). Os lados esquerdo e direito são definidos do ponto de vista de quem vê a imagem, sem considerar as projeções de espelhamento típicas das fotos. Normalmente, LEFT_EYE é o olho direito da pessoa.

Tipos enumerados
`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 executada 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 do tipo. Não se aplica a TEXT_DETECTION, DOCUMENT_TEXT_DETECTION ou CROP_HINTS.

model

string

Modelo a ser usado 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 a ser extraído.

Tipos enumerados
`TYPE_UNSPECIFIED`	Tipo de recurso não especificado.
`FACE_DETECTION`	Executar detecção facial.
`LANDMARK_DETECTION`	Executar detecção de ponto de referência.
`LOGO_DETECTION`	Executar detecção de logotipo.
`LABEL_DETECTION`	Executar detecção de rótulos.
`TEXT_DETECTION`	Executar detecção de texto/reconhecimento óptico de caracteres (OCR). 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 em um documento de texto denso. Tem precedência quando `DOCUMENT_TEXT_DETECTION` e `TEXT_DETECTION` estão presentes.
`SAFE_SEARCH_DETECTION`	Executar o SafeSearch para detectar conteúdos que podem não ser seguros ou são indesejáveis.
`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.
`PRODUCT_SEARCH`	Execute a Pesquisa de produtos.
`CUSTOM_LABEL_DETECTION`	Executar detecção de rótulos personalizados.
`OBJECT_LOCALIZATION`	Execute o localizador para detecção de objetos.
`IMAGE_QUALITY`	Executar pontuação de qualidade.
`OBJECT_ATTRIBUTES`	Calcular os atributos de objetos detectados na imagem. Quatro domínios de objetos são compatíveis. Selecione pelo Feature.model (obrigatório): "builtin/apparel", "builtin/car", "builtin/food" ou "builtin/wildlife".
`QUALITY_OPTIMIZATION`	Execute algoritmos de otimização de qualidade. Há três tipos de operações: COMPRESSION, ENHANCEMENT e QUALITY_SCORE. Os parâmetros COMPRESSION e ENHANCEMENT e a opção de modelo QUALITY_SCORE são especificados em image_context.quality_Optimization_params.
`BARCODE_DETECTION`	Execute a detecção e o reconhecimento de código de barras.
`DOCUMENT_PARSING`	Execute algoritmos de análise de documentos para extrair dados estruturados, como tabelas e formulários. Os resultados são encontrados em `full_text_annotation` -> `page` -> `block`, com o tipo TABLE para tabelas ou KEY_VALUE_PAIR para pares de chave-valor em formulários.

GcsDestination

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

Campos

uri

string

URI do Google Cloud Storage em que os resultados serão armazenados. Os resultados estarão no formato JSON e precedidos pelo URI de entrada correspondente. Esse campo pode representar um único arquivo ou um prefixo para várias saídas. Os prefixos precisam terminar com /.

Exemplos:

Se várias saídas, cada resposta ainda será AnnotationFileResponse, cada uma contendo um subconjunto da lista completa de AnnotateImageResponse. Poderá haver várias saídas se, por exemplo, o JSON de saída for muito grande e for distribuído por vários arquivos fragmentados.

GcsSource

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 aceitos no momento.

GetProductRequest

Mensagem de solicitação para o método GetProduct.

Campos

name

string

Nome do recurso do Product a ser recebido.

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

GetProductSetRequest

Mensagem de solicitação para o método GetProductSet.

Campos

name

string

Nome do recurso do ProductSet a ser recebido.

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

GetReferenceImageRequest

Mensagem de solicitação para o método GetReferenceImage.

Campos

name

string

O nome do recurso da ReferenceImage a ser recebida.

O formato é:

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

Imagem

Imagem do cliente em que serão executadas as tarefas da API Google Cloud Vision.

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, como um PDF, essa mensagem fornece informações sobre a origem da 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 vai 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 porque possibilita a detecção automática de idioma. Para idiomas baseados 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 vai retornar um erro se um ou mais dos idiomas especificados não forem aceitos.
`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.
`text_detection_params`	`TextDetectionParams` Parâmetros para detecção de texto de documentos.
`quality_optimization_params`	`QualityOptimizationParams` Parâmetros para otimizações de qualidade da imagem.
`document_parsing_params`	`DocumentParsingParams` Parâmetros para análise de documentos.

ImageProperties

Armazena as propriedades da imagem, como as cores dominantes.

Campos

dominant_colors

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

ImageQuality

Armazena índices de qualidade da imagem, que podem ser de qualidade estética ou técnica.

Campos

quality_score

float

É uma pontuação que representa a qualidade estética/técnica da imagem. A pontuação está no intervalo [0, 1]. O valor mais alto corresponde a fotos com aparência mais profissional. Zero significa que a imagem está muito ruim, 1 significa que a imagem tem uma qualidade muito alta.

ImageSource

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

Campos

gcs_image_uri

string

Use image_uri.

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

image_uri

string

O URI da imagem de origem pode ser:

Um URI do Google Cloud Storage no formato gs://bucket_name/object_name. O controle de versões do objeto não é aceito. Consulte URIs de solicitação do Google Cloud Storage para mais informações.
Um URL HTTP/HTTPS de imagem acessível ao público. Ao buscar imagens em 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, devido à 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 é recomendado usar imagens hospedadas externamente em 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.

image-uri
image-id
product-set-id
product-id
product-category
product-display-name
labels
bounding-poly

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

Se o ProductSet ou o Product especificado pelos valores product-set-id e product-id não existir, o sistema criará um 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 caso seja fornecida. Se ela estiver vazia, o sistema atribuirá automaticamente um ID exclusivo à imagem.

A coluna product-display-name é opcional. Se estiver vazia, 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 vai 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 tiver várias regiões de interesse, adicione uma linha ao arquivo CSV que inclua as mesmas informações de produto e 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 números inteiros não negativos para polígonos delimitadores absolutos e valores flutuantes em [0, 1] para polígonos delimitadores normalizados.

O sistema vai 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

Mensagem de solicitação para o método ImportProductSets.

Campos

parent

string

O projeto em que os ProductSets serão 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.

Campos

reference_images[]

ReferenceImage

A lista de reference_images importadas.

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 status[i] armazena os status de sucesso ou falha do processamento da linha i do CSV, começando pela linha 0.

InputConfig

Os metadados e o local pretendido para a entrada.

Campos

gcs_source

GcsSource

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

content

bytes

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

mime_type

string

O tipo do arquivo. No momento, somente application/pdf e image/tiff são aceitos. Caracteres curinga não são aceitos.

KeyValuePair

Proto para um par de chave-valor.

Campos
`key`	`string` O valor da string da chave.
`key_block`	`Block` Bloco de chaves do par que contém a caixa delimitadora normalizada e o texto da chave.
`value_block`	`Block` Bloco de valores do par que contém a caixa delimitadora normalizada e o texto do valor, incluindo estruturas potencialmente mais profundas no texto do valor.
`value_type`	`string` Tipo do valor. As strings válidas são as seguintes: "generic": para texto genérico mapeado para um valor. "number": para tipos numéricos "id": para identificadores genéricos. "currency": para valores de moeda. "date": para datas. "time": para valores de tempo e duração. "date_range": para períodos. "address": para valores de endereço (pode ser longo). "person": para nomes de pessoas ou outros identificadores pessoais. "phone": para números de telefone.
`normalized_key`	`string` (Opcional) O texto da chave normalizada se o texto for comum e classificado. Por exemplo, "TOTAL DUE" será normalizado para "Valor total".

LatLongRect

Retângulo determinado por pares mínimos e máximos 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.

Tipos enumerados
`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

Mensagem de solicitação para o método ListProductSets.

Campos

parent

string

O projeto com os ProductSets que precisam ser listados.

O formato é projects/PROJECT_ID/locations/LOC_ID.

page_size

int32

O número máximo de itens a serem retornados. O padrão é 10 e o 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

Mensagem de solicitação para o método ListProductsInProductSet.

Campos

name

string

O recurso ProductSet com os Products que 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 a serem retornados. O padrão é 10 e o 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[]

A 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

Mensagem de solicitação para o método ListProducts.

Campos

parent

string

O projeto OU ProductSet com os Products que serão listados.

Formato: projects/PROJECT_ID/locations/LOC_ID

page_size

int32

O número máximo de itens a serem retornados. O padrão é 10 e o 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[]

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

Mensagem de solicitação 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 a serem retornados. O padrão é 10 e o máximo é 100.

page_token

string

Um token que identifica uma página de resultados a serem retornados. Esse é 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 a serem retornados. O padrão é 10 e o máximo é 100.

next_page_token

string

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

LocalizedBarcodeAnnotation

Conjunto de códigos de barras detectados com caixas delimitadoras.

Campos
`format`	`string` O formato Barcode descreve o formato de um código de barras. Os formatos compatíveis são: CODE_128: tipo de código 128. CODE_39: tipo de código 39. CODE_93: tipo de código 93. CODABAR: tipo Codabar. DATA_MATRIX: tipo de matriz de dados 2D. ITF: tipo ITF. EAN_13: tipo EAN-13. EAN_8: tipo EAN-8. QR_CODE: é um tipo de código QR 2D. UPC_A: tipo UPC-A. UPC_E: tipo UPC-E. PDF417: tipo PDF417. AZTEC: tipo de código Aztec 2D. DATABAR: tipo de código GS1 DataBar.
`value_format`	`string` O formato de valor do código de barras descreve o formato do valor que o código de barras codifica. Os formatos de valor compatíveis são: CONTACT_INFO: dados de contato. EMAIL: endereço de e-mail. ISBN: identificador ISBN. PHONE: número de telefone. PRODUCT: produto. SMS: mensagem SMS. TEXT: string de texto. URL: endereço do URL. Wi-Fi: informações de Wi-Fi. Geolocalização: localização geográfica (long. e lat.). CALENDAR_EVENT: evento da agenda. DRIVER_LICENSE: carteira de habilitação.
`value`	`string` Barcode é o valor de código de barras que é o valor ASCII capturado no código de barras. Barcode pode codificar valores estruturados, por exemplo, 'MEBKM:TITLE:Google;URL:https://www.google.com;;.
`confidence`	`float` O nível de confiança do resultado. Intervalo [0, 1].
`bounding_poly`	`BoundingPoly` Região da imagem à qual este código de barras pertence. Esse campo precisa ser preenchido.

LocalizedObjectAnnotation

Conjunto de objetos detectados com caixas delimitadoras.

Campos
`mid`	`string` ID do objeto que deve se alinhar a 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 a que o 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 os metadados da operação BatchAnnotateImages.

Campos

state

State

Estado atual da operação em lote.

create_time

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

update_time

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

State

Estados de operação em lote.

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

OutputConfig

Os metadados e o local pretendido para a saída.

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, cinco arquivos JSON, cada um com 20 protos de resposta, serão gravados com o prefixo gcs_destination.uri.

No momento, batch_size só se aplica a GcsDestination, com possível suporte futuro para outras configurações de saída.

Página

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].
`merged_text`	`string` Todo o texto UTF-8 detectado nesta página. Por padrão, esse campo não é retornado, a menos que especificado em TextDetectionParams.page_filter.

Parágrafo

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 seguinte ordem: superior esquerda, superior direita, inferior direita e inferior esquerda. Quando for detectada uma rotação da caixa delimitadora, ela será representada no canto superior esquerdo, como definido pela leitura do texto na orientação natural. Por exemplo: * quando o texto é horizontal, é semelhante ao seguinte: 0----1 \| \| 3----2 * quando é girado em 180 graus em torno do canto superior esquerdo, torna-se: 2----3 \| \| 1----0, e a ordem dos vértices ainda é (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].
`merged_text`	`string` Todo o texto UTF-8 detectado neste parágrafo. Por padrão, esse campo não é retornado, a menos que especificado em TextDetectionParams.paragraph_filter.

Posição

Uma posição 3D na imagem, usada principalmente para pontos de referência de detecção facial. 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).

Product

Um Product 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 ao criar um produto.
`display_name`	`string` O nome fornecido pelo usuário para o Product. Não pode ficar em branco. Pode ter no máximo 4.096 caracteres.
`description`	`string` Metadados fornecidos pelo usuário a serem armazenados com o produto. Pode ter no máximo 4.096 caracteres.
`product_category`	`string` A categoria do produto identificado pela imagem de referência. Pode ser: homegoods, apparel ou toys. Esse 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. Valores inteiros podem ser fornecidos como strings. Por exemplo, 1199. Somente strings com valores inteiros funcionam com 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 produtos.

Campos
`bounding_poly`	`BoundingPoly` O polígono delimitador ao redor da área de interesse na imagem. Opcional. Se não for especificado, o critério do sistema será aplicado.
`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 produtos para pesquisar. No momento, apenas a primeira categoria é considerada e é necessário especificar: homegoods, apparel ou toys.
`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 Product. No momento, aceitamos expressões de chave-valor em AND ou OR. No entanto, cada expressão em OR precisa ter a mesma chave. Por exemplo, é aceito: (color = red OR color = blue) AND brand = Google. Não é aceito: (color = red OR brand = Google) ou color: red.

ProductSearchResults

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

Campos

index_time

O carimbo de data/hora do índice que forneceu esses resultados. As alterações feitas após esse período não serão refletidas 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

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.

object_annotations[]

ObjectAnnotation

Lista de previsões genéricas sobre o objeto na caixa delimitadora.

ObjectAnnotation

Previsão sobre o que é o objeto na caixa delimitadora.

Campos
`mid`	`string` ID do objeto que deve se alinhar a 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].

Resultado

Informações sobre um produto.

Campos

product

O produto.

score

float

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 é a correspondência mais próxima da consulta.

ProductSet

Um ProductSet contém Products. Ele pode conter no máximo 1 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`. Este campo é ignorado ao criar um ProductSet.
`display_name`	`string` O nome fornecido pelo usuário para o ProductSet. Não pode ficar em branco. Pode ter no máximo 4.096 caracteres.
`index_time`	`Timestamp` Apenas saída. A hora em que o ProductSet foi indexado pela última vez. Os resultados da consulta vão refletir todas as atualizações anteriores a esse período. Se o ProductSet nunca foi indexado, esse carimbo de data/hora é o valor padrão 1970-01-01T00:00:00Z. Este campo é ignorado ao criar um ProductSet.
`index_error`	`Status` Apenas saída. Se ocorrer um erro na indexação do ProductSet, o campo será preenchido. Este campo é ignorado ao criar um ProductSet.

Propriedade

Uma Property consiste em um par de 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.
`confidence`	`float` Valor no intervalo [0..1]. Confiança desse valor de propriedade.
`mid`	`string` ID do valor da propriedade opaca. Alguns IDs podem estar disponíveis na API Google Knowledge Graph Search. Um exemplo de propriedade para um casaco azul seria: Property { name: 'color' value: 'blue' mid: '/m/01g5v' // For color blue }

QualityOptimizationParams

Parâmetros para otimizações de qualidade da imagem.

Campos
`type`	`Type` Escolha um tipo de otimização.
`compression_config`	`CompressionConfig` Especifique a configuração de compactação.
`enhancement_config`	`EnhancementConfig` Especifique a configuração do ajuste automático.
`quality_score_config`	`QualityScoreConfig` Especifique a configuração do índice de qualidade.

CompressionConfig

Configuração para COMPRESSION.

Campos

target_quality

float

No intervalo [0, 1]. Qualidade desejada após a compactação. "1" significa "sem perdas" em comparação com a imagem de entrada, "0" significa que não há um requisito mínimo de qualidade.

EnhancementConfig

Configuração para ENHANCMENT. Se não especificar enhancement_config, os valores padrão sharpening_level serão iguais a 0,5, auto_hdr_level igual a 0,5 e upscale_ratio igual a 1 serão usados. Se você quiser personalizar qualquer um dos três parâmetros, precisará especificar todo o EnhancementConfig. Por exemplo, se você quiser usar auto_hdr_level mais alto, que geralmente torna a imagem mais clara, e manter o nível de nitidez e a proporção de alto da mesma configuração que o padrão, você pode definir a configuração como: enhancement_config { sharpening_level: 0.5 auto_hdr_level: 1.0 upscale_ratio: 1 }

Campos

sharpening_level

float

No intervalo [0,1]. Nível de nitidez, 0 significa sem nitidez, 1 significa a maior nitidez. O padrão é 0,5.

auto_hdr_level

float

No intervalo [0,1]. Nível de HDR automático: 0 significa sem HDR automático, 1 significa o maior AutoHDR. O padrão é 0,5.

upscale_ratio

float

No intervalo [1, 2]. Ao fazer escalonamento, o valor padrão será 1, o que significa que não há escalonamento. Se especificado, a altura e a largura da saída serão iguais aos valores originais de altura e largura de upscale_ratio.

QualityScoreConfig.

Configuração para QUALITY_SCORE.

Campos

quality_model

string

Especifique o modelo a ser usado. O valor padrão é uma string vazia, e a pontuação estética será retornada. Outro modelo de qualidade compatível é "builtin/technical-score", que retorna a qualidade técnica da imagem.

Tipo

Enumeração do tipo de otimização de qualidade.

Enums
`TYPE_UNSPECIFIED`	Inválido. O cliente precisa selecionar um tipo.
`COMPRESSION`	Reduza o tamanho do arquivo de imagem. Parâmetros detalhados especificados em CompressionConfig. Se o cliente não especificar CompressionConfig, isso reduzirá o tamanho do arquivo de imagem, sem reduzir a qualidade da imagem. Se o cliente especificar CompressionConfig, reduziremos o tamanho do arquivo, mantendo CompressionParams.target_quality.
`ENHANCEMENT`	Ruído, nitidez, HDR e melhoria. Parâmetros detalhados especificados em EnhancementConfig. Se o cliente não especificar o EnhancmentConfig, ele melhorará a imagem usando valores padrão. Se upscale_ratio não for especificado, a imagem de saída terá a mesma resolução da imagem de entrada.
`QUALITY_SCORE`	Consulte o índice de qualidade de uma imagem. Parâmetros detalhados especificados em QualityScoreConfig. Se o cliente não especificar QualityScoreConfig, a pontuação estética da imagem será retornada.

QualityOptimizationResult

Armazena bytes de imagem aprimorados.

Campos

quality_optimization_type

Type

Tipo de otimização obrigatório.

image

bytes

Bytes de imagem otimizados.

mime_type

string

Tipo MIME do imagem de saída.

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 ao criar uma imagem de referência.

uri

string

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

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

Obrigatório.

bounding_polys[]

Polígonos delimitadores em torno das áreas de interesse na imagem de referência. Opcional. Se este campo estiver vazio, o sistema vai 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. Isso significa que 1:3 é aceitável e 1:5 não é.

RemoveProductFromProductSetRequest

Mensagem de solicitação para o método RemoveProductFromProductSet.

Campos

name

string

O nome do recurso do ProductSet a ser modificado.

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

product

string

O nome do recurso do Product a ser removido do 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 seguinte ordem: superior esquerda, superior direita, inferior direita e inferior esquerda. Quando for detectada uma rotação da caixa delimitadora, ela será representada no canto superior esquerdo, como definido pela leitura do texto na orientação natural. Por exemplo: * quando o texto é horizontal, é semelhante ao seguinte: 0----1 \| \| 3----2 * quando é girado 180 graus em torno do canto superior esquerdo, torna-se: 2----3 \| \| 1----0, e a ordem dos vértices 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].

Tabela

Uma representação de tabela semelhante à estrutura da tabela HTML.

Campos

header_rows[]

TableRow

Linhas de cabeçalho da tabela

body_rows[]

TableRow

Linhas do corpo da tabela

TableCell

Uma representação das células dentro de tabelas.

Campos
`row_span`	`int32` Quantas linhas a célula abrange.
`col_span`	`int32` Quantas colunas esta célula abrange.
`text_block`	`Block` Bloco de texto para a célula que também contém a caixa delimitadora normalizada para a célula e estruturas mais profundas dentro de uma célula, se presente.
`text`	`string` O valor de texto mesclado dessa célula, omitindo informações estruturais mais profundas, diferentemente de `text_block`. Isso é útil para células simples.

TableRow

Uma linha de células da tabela.

Campos

cells[]

TableCell

Células que compõem esta linha.

TableBoundHint

Uma dica para uma caixa delimitadora de tabela na página para análise de tabela.

Campos

page_number

int32

Número de página opcional para entradas de várias páginas a que essa dica se aplica. Se não for fornecida, esta dica será aplicada a todas as páginas por padrão. Esse valor é indexado em 1.

bounding_box

Dica da caixa delimitadora para uma tabela nesta página. As coordenadas precisam ser normalizadas para [0,1], e a caixa delimitadora precisa ser um retângulo alinhado ao eixo.

TableDetectionOptions

Opções para detecção de tabelas.

Campos

table_bound_hints[]

TableBoundHint

Dicas opcionais da caixa delimitadora de tabela que podem ser fornecidas para casos complexos em que nosso algoritmo não consegue localizar as tabelas.

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.

Tipos enumerados
`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 pt-BR ou en-US. 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.

TextDetectionParams

Parâmetros para detecção de texto. Isso é usado para controlar os recursos TEXT_DETECTION e DOCUMENT_TEXT_DETECTION.

Campos
`disable_orientation_detection`	`bool` Desativa a detecção de orientação, para que o texto girado não seja detectado. Só é compatível com DOCUMENT_TEXT_DETECTION.
`disable_text_annotations`	`bool` Desativa o campo antigo text_annotations. Somente full_text_annotations será retornado.
`page_filter`	`FieldMask` Controla quais dados são retornados no nível da página em full_text_annotation. Padrão quando não definido: todos os campos são incluídos
`block_filter`	`FieldMask` Controla quais dados são retornados no nível do bloco em full_text_annotation. Padrão quando não definido: todos os campos são incluídos, exceto `merged_text`.
`paragraph_filter`	`FieldMask` Controla quais dados são retornados no nível do parágrafo em full_text_annotation. Padrão quando não definido: todos os campos são incluídos, exceto `merged_text`.
`word_filter`	`FieldMask` Controla quais dados são retornados no nível da palavra em full_text_annotation. Padrão quando não definido: todos os campos são incluídos, exceto `merged_text`.
`symbol_filter`	`FieldMask` Controla quais dados são retornados no nível do símbolo em full_text_annotation. Padrão quando não definido: todos os campos são incluídos, exceto `bounding_box`.

UpdateProductRequest

Mensagem de solicitação para o método UpdateProduct.

Campos

product