Method: projects.locations.productSets.import

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 da entrada desse método é um arquivo CSV no Google Cloud Storage. Para o formato do arquivo CSV, consulte ImportProductSetsGcsSource.csv_file_uri.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O projeto em que os ProductSets serão importados.

O formato é: projects/PROJECT_ID/locations/LOC_ID

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

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

object (ImportProductSetsInputConfig)

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

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

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.

ImportProductSetsInputConfig

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

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

object (ImportProductSetsGcsSource)

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

ImportProductSetsGcsSource

O local do Google Cloud Storage para um arquivo 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 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. labels
  8. 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 displayName, a coluna product-category refere-se a productCategory e a coluna labels refere-se a productLabels.

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 displayName do produto como um espaço. É possível atualizar o displayName 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 referenceImages.create. 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).