Migrar de "accountstatuses" para "Account Issues"

Mudou a forma de recuperar problemas no nível da conta que podem afetar seus produtos e a integridade da conta. 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 "Ver problemas da 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 agregados de produtos.

principais diferenças

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

  • Recurso dedicado:os problemas da conta são um recurso próprio. Na API Content para Shopping, os problemas no nível da conta eram um campo aninhado no recurso geral AccountStatus. Com a API Merchant, é possível listar os produtos diretamente usando o método accounts.issues.list.
  • Dados estruturados de impacto:o recurso AccountIssue fornece um campo impactedDestinations detalhado. Esse campo oferece 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 uma enumeração:o campo severity agora é uma enumeração (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 da conta tem um recurso name exclusivo e completo 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 título e descrição, no seu idioma preferido. Isso não era possível na API Content for Shopping.
  • Comportamento avançado da conta:quando você chama accounts.issues.list em uma conta avançada, ela só retorna problemas que se aplicam diretamente a essa conta. Ela não retorna problemas de nenhuma das subcontas. Na API Content para Shopping, o método accountstatuses.list retornaria os status de todas as subcontas. Para receber problemas de todas as subcontas na API Merchant, chame accounts.listSubaccounts e 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 depois 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. É preciso fazer chamadas list individuais para cada conta.

Mudanças detalhadas nos campos

Os campos no recurso "problema da 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) Agora, os problemas 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 completo de recurso, 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 indicar que é um URL.
severity (string) severity (enum) A gravidade agora é um enum 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
Overview
Avançar
Migrate accountstatuses to Aggregate Product Statuses