Method: projects.locations.productSets.import

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

A API google.longrunning.Operation pode ser usada para acompanhar o progresso e os resultados do pedido. Operation.metadata contém BatchOperationMetadata. (progress) Operation.response contém ImportProductSetsResponse. (resultados)

A origem de entrada deste método é um ficheiro CSV no Google Cloud Storage. Para ver o formato do ficheiro CSV, consulte ImportProductSetsGcsSource.csv_file_uri.

Pedido HTTP

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/productSets:import

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O projeto no qual os ProductSets devem ser importados.

O formato é projects/PROJECT_ID/locations/LOC_ID.

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

Representação JSON 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Campos
inputConfig

object (ImportProductSetsInputConfig)

Obrigatório. O conteúdo de entrada para a lista de pedidos.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte a Vista geral da autenticação.

ImportProductSetsInputConfig

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

Representação JSON 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Campos
gcsSource

object (ImportProductSetsGcsSource)

A localização do Google Cloud Storage para um ficheiro CSV que preserva uma lista de ImportProductSetRequests em cada linha.

ImportProductSetsGcsSource

A localização do Google Cloud Storage para um ficheiro CSV que preserva uma lista de ImportProductSetRequests em cada linha.

Representação JSON 
{
  "csvFileUri": string
}
Campos
csvFileUri

string

O URI do Google Cloud Storage do ficheiro CSV de entrada.

O URI tem de começar por gs://.

O formato do ficheiro CSV de entrada deve ser uma imagem por linha. Em cada linha, existem 8 colunas.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. etiquetas
  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 o Product especificado pelos valores product-set-id e product-id não existir, o sistema cria um novo ProductSet ou Product para a imagem. Neste caso, a coluna product-display-name refere-se a displayName, a coluna product-category refere-se a productCategory e a coluna labels refere-se a productLabels.

A coluna image-id é opcional, mas tem de ser exclusiva se for fornecida. Se estiver vazio, o sistema atribui automaticamente um ID exclusivo à imagem.

A coluna product-display-name é opcional. Se estiver vazio, o sistema define o campo displayName do produto como um espaço (" "). Pode atualizar o campo displayName mais tarde através da API.

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

A coluna labels (opcional) é uma linha que contém uma lista de pares de chave/valor separados por vírgulas, 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 referenceImages.create. Se não especificar a coluna bounding-poly, o sistema tenta detetar automaticamente as regiões de interesse.

É permitida, no máximo, uma coluna bounding-poly por linha. Se a imagem contiver várias regiões de interesse, adicione uma linha ao ficheiro CSV que inclua as mesmas informações do produto e os valores bounding-poly para cada região de interesse.

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

O sistema redimensiona a imagem se a resolução da imagem for demasiado grande para processar (superior a 20 MP).