Migrar de "accountstatuses" para "Account Issues"

A forma de recuperar problemas no nível da conta que podem afetar seus produtos e a integridade da conta mudou. Em comparação com o recurso accountstatuses na API Content for Shopping, a API Merchant apresenta um recurso AccountIssue dedicado que fornece informações mais estruturadas e detalhadas.

Para mais informações sobre como usar o novo recurso, consulte o guia para ver problemas na conta.

Observação: na API Merchant, os problemas no nível da conta e os status agregados dos produtos são divididos. Consulte também nosso guia para migrar de accountstatuses para status de produtos agregados.

principais diferenças

Confira as principais melhorias e diferenças no recurso AccountIssue da API Merchant:

  • Recurso dedicado: os problemas da conta são um recurso próprio. Na API Content for Shopping, os problemas no nível da conta eram um campo aninhado no recurso geral AccountStatus. Com a API Merchant, é possível listá-los diretamente usando o método accounts.issues.list.
  • Dados de impacto estruturados: o recurso AccountIssue fornece um campo impactedDestinations detalhado. Esse campo mostra uma análise clara do impacto de um problema, incluindo o destino (por exemplo, anúncios do Shopping), a região específica e a gravidade do problema nessa região.
  • Gravidade como um tipo enumerado: o campo severity agora é um tipo enumerado (com valores como CRITICAL, ERROR, SUGGESTION), o que facilita o processamento programático em comparação com os valores baseados em string na API Content for Shopping.
  • Identificadores padronizados: cada problema de conta tem um name de recurso completo e exclusivo no formato accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Essa abordagem padronizada substitui a string id da API Content for Shopping.
  • Suporte à localização: o método accounts.issues.list permite especificar um language_code para receber detalhes do problema, como o título e a descrição, no idioma de sua preferência. Isso não era possível na API Content for Shopping.
  • Comportamento da conta avançada: quando você chama accounts.issues.list em uma conta avançada, ela retorna apenas os problemas que se aplicam diretamente a essa conta. Ela não retorna problemas de nenhuma das subcontas. Na API Content for Shopping, o método accountstatuses.list retorna os status de todas as subcontas. Para receber problemas de todas as subcontas na API Merchant, chame accounts.listSubaccounts e, em seguida, chame accounts.issues.list para cada subconta individualmente.

Solicitações

Na API Merchant, é possível listar problemas de uma conta específica do Merchant Center.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

Comparação de URLs de solicitação

Descrição da solicitação API Content for Shopping API Merchant
Listar problemas no nível da conta para uma única conta GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Listar problemas no nível da conta para todas as subcontas de uma conta avançada GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses Indisponível. É necessário iterar pelas subcontas.

Identificadores

Os identificadores de contas e problemas mudaram na API Merchant.

Comparação de identificadores

Descrição do identificador API Content for Shopping API Merchant
Identificador da conta {MERCHANT_ID} e {ACCOUNT_ID} como parâmetros de caminho. {ACCOUNT_ID} como um parâmetro de caminho no formato accounts/{ACCOUNT_ID}.
Identificador do problema Campo id no corpo da resposta (por exemplo, "products-that-enable-dishonest-behavior-hacking-policy"). Campo name no corpo da resposta, que é o nome completo do recurso (por exemplo, accounts/12345/issues/example-issue-id).

Métodos

Os métodos para recuperar problemas da conta foram consolidados e simplificados na API Merchant.

Comparação de métodos

API Content for Shopping API Merchant Disponibilidade e observações
accountstatuses.get accounts.issues.list Disponível. Para receber problemas de uma única conta, use accounts.issues.list e especifique o ID da conta. A API Merchant não tem um método get para um único problema.
accountstatuses.list Sem equivalente direto. Indisponível. O método accounts.issues.list na API Merchant só retorna problemas da conta especificada, não das subcontas. Para receber problemas de todas as subcontas, primeiro chame accounts.listSubaccounts e, em seguida, chame accounts.issues.list para cada subconta.
accountstatuses.custombatch Sem equivalente direto. Indisponível. O processamento em lote para problemas na conta não é compatível com a API Merchant. É necessário fazer chamadas list individuais para cada conta.

Mudanças detalhadas nos campos

Os campos do recurso de problema na conta foram atualizados para oferecer mais estrutura e clareza.

Comparação de campos

API Content for Shopping API Merchant Descrição
accountLevelIssues (matriz em AccountStatus) accountIssues (matriz em ListAccountIssuesResponse) Os problemas agora são um recurso dedicado de nível superior, não um campo aninhado.
id (string) name (string) O identificador do problema agora é um nome de recurso completo, por exemplo, accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (string) title (string) Não houve alterações.
detail (string) detail (string) Não houve alterações.
documentation (string) documentationUri (string) O campo foi renomeado para fins de esclarecimento, indicando que é um URL.
severity (string) severity (enum) A gravidade agora é um tipo enumerado estruturado (CRITICAL, ERROR, SUGGESTION) em vez de uma string.
country (string), destination (string) impactedDestinations (mensagem repetida) O impacto agora é estruturado em uma lista, agrupando o destino, a região e a gravidade de cada área afetada. O campo country é substituído por regionCode na mensagem Impact.
(Não disponível) language_code, time_zone (parâmetros de solicitação) Novos parâmetros na solicitação list permitem a localização de campos legíveis por humanos, como title e detail.
Anterior
Migrate account management
Avançar
Migrate accountstatuses to Aggregate Product Statuses