REST Resource: accounts.languages.productCertifications

Recurso: ProductCertification

Dados de certificação de produtos.

Representação JSON
{
  "name": string,
  "title": string,
  "brand": string,
  "mpn": [
    string
  ],
  "productCode": [
    string
  ],
  "countryCode": [
    string
  ],
  "productType": [
    string
  ],
  "certification": [
    {
      object (Certification)
    }
  ],
  "issues": [
    {
      object (Issue)
    }
  ],
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ]
}
Campos
name

string

Obrigatório. O identificador exclusivo do nome de uma certificação de produto. Formato: accounts/{account}/languages/{language_code}/productCertifications/{id}. Em que id é um identificador exclusivo e language_code é um código de duas letras ISO 639-1 de um idioma aceito pelo Shopping, de acordo com https://support.google.com/merchants/answer/160637.

title

string

Obrigatório. Isso é para identificar claramente o produto que você está certificando.

brand

string

Obrigatório. É o nome da marca do produto. A marca é usada para ajudar a identificar seu produto.

mpn[]

string

Opcional. São os números de peça do fabricante (MPN). Os MPNs são usados para identificar um produto específico entre os produtos de um mesmo fabricante

productCode[]

string

Opcional. Outro nome para GTIN.

countryCode[]

string

Opcional. Um código de país de duas letras (ISO 3166-1 Alpha 2).

productType[]

string

Opcional. Esse é seu próprio sistema de categorização nos dados de produtos.

certification[]

object (Certification)

Obrigatório. Uma lista de certificações para vincular ao produto descrito.

issues[]

object (Issue)

Apenas saída. Uma lista de problemas associados ao produto gerada pelo servidor.

destinationStatuses[]

object (DestinationStatus)

Apenas saída. Os status dos destinos.

Certificação

Descrição de uma certificação.

Representação JSON
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string
}
Campos
name

string

Obrigatório. Nome da certificação.

authority

string

Obrigatório. Nome do órgão de certificação.

code

string

Opcional. Um código exclusivo para identificar a certificação.

value

string

Opcional. Um valor personalizado da certificação.

validUntil

string

Opcional. A data de validade (UTC).

Problema

Problema no produto.

Representação JSON
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string,
  "applicableCountries": [
    string
  ]
}
Campos
type

string

O tipo de problema gerado pelo servidor, por exemplo, "INCORRECT_TEXT_FORMATTING", "IMAGE_NOT_SERVEABLE" etc.

severity

enum (Severity)

A gravidade do problema.

attribute

string

Se presente, o atributo que acionou o problema. Para mais informações sobre atributos, acesse https://support.google.com/manufacturers/answer/6124116.

title

string

Título curto que descreve a natureza do problema.

description

string

Descrição mais longa do problema com foco em como resolvê-lo.

resolution

enum (IssueResolution)

O que precisa acontecer para resolver o problema.

destination

string

O destino a que o problema se aplica.

timestamp

string (Timestamp format)

O carimbo de data/hora em que o problema apareceu.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

applicableCountries[]

string

Apenas saída. Lista de códigos de países (ISO 3166-1 alfa-2) em que o problema se aplica ao produto do fabricante.

Gravidade

Gravidade do problema.

Enums
SEVERITY_UNSPECIFIED Gravidade não especificada, nunca usada.
ERROR Gravidade do erro. O problema impede o uso do item inteiro.
WARNING Gravidade do aviso. O problema impede o uso do atributo que o acionou ou vai impedir o uso de todo o item em breve.
INFO Gravidade da informação. O problema não exige atenção imediata. Por exemplo, ele é usado para comunicar quais atributos ainda estão pendentes de revisão.

IssueResolution

Resolução do problema.

Enums
RESOLUTION_UNSPECIFIED Resolução não especificada, nunca usada.
USER_ACTION O usuário que forneceu os dados precisa agir para resolver o problema, por exemplo, corrigindo algumas informações.
PENDING_PROCESSING O problema será resolvido automaticamente (por exemplo, rastreamento de imagens ou avaliação do Google). Nenhuma ação é necessária no momento. A resolução pode levar a outro problema (por exemplo, se o rastreamento falhar).

DestinationStatus

O status do destino.

Representação JSON
{
  "destination": string,
  "status": enum (Status),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campos
destination

string

O nome do destino.

status

enum (Status)

O status do destino.

approvedCountries[]

string

Apenas saída. Lista de códigos de países (ISO 3166-1 alfa-2) em que a oferta foi aprovada.

pendingCountries[]

string

Apenas saída. Lista de códigos de países (ISO 3166-1 alfa-2) em que a oferta está pendente de aprovação.

disapprovedCountries[]

string

Apenas saída. Lista de códigos de países (ISO 3166-1 alfa-2) em que a oferta foi reprovada.

Status

O status.

Enums
UNKNOWN Status não especificado, nunca usado.
ACTIVE O produto é usado para esse destino.
PENDING A decisão ainda está pendente.
DISAPPROVED O produto é reprovado. Analise os problemas.

Métodos

delete

Exclui uma certificação de produto pelo nome.

get

Recebe uma certificação de produto pelo nome.

list

Lista as certificações de produtos de um órgão certificador especificado.

patch

Atualiza (ou cria se allow_missing = true) uma certificação de produto que vincula certificações a produtos.