Migrar "accountstatuses" para "Aggregate Product Statuses"

A maneira de recuperar estatísticas e problemas agregados de produtos mudou. A funcionalidade que estava disponível no recurso accountstatuses da API Content for Shopping agora está dividida em recursos dedicados na API Merchant. Este guia explica como migrar sua integração para usar o novo aggregateProductStatuses recurso.

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 problemas da conta.

principais diferenças

Confira as principais diferenças entre os recursos de status do produto na API Content for Shopping e na API Merchant:

  • Recursos dedicados: o recurso accountstatuses da API Content for Shopping agora está dividido. Na API Merchant, os problemas no nível da conta estão disponíveis no recurso accountissues, enquanto as estatísticas agregadas de produtos e os problemas no nível do item estão disponíveis no novo recurso aggregateProductStatuses.
  • Nova estrutura de recursos: AggregateProductStatus é um novo recurso que representa as estatísticas e os problemas de uma combinação específica de contexto de relatórios e país.
  • Mecanismo de filtragem: em vez de usar parâmetros de consulta como destinations para selecionar dados, a API Merchant usa um método list com uma filter string para consultar contextos de relatórios e países específicos.
  • Remoção do campo de canal: o campo channel não é mais usado. Agora, essas informações fazem parte implicitamente do reportingContext.

Solicitações

A API Merchant usa uma solicitação GET com um parâmetro filter para recuperar os status agregados dos produtos.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

Formato do URL da solicitação

Descrição da solicitação API Content for Shopping API Merchant
Receber estatísticas e problemas do produto GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identificadores

A maneira como os recursos são identificados mudou para oferecer suporte à nova estrutura.

Formato do identificador

Descrição do identificador API Content for Shopping API Merchant
Identificador de recursos O recurso foi identificado por accountId. Fatias de dados específicas foram selecionadas com parâmetros de consulta. O nome do recurso identifica exclusivamente os dados de um contexto de relatórios e país específicos: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Métodos

O método para recuperar os status dos produtos foi atualizado para um método list que oferece suporte à filtragem.

Método da API Content for Shopping Método da API Merchant Disponibilidade e observações
accountstatuses.get aggregateProductStatuses.list O método accountstatuses.get retornou um único recurso contendo todas as estatísticas do produto. O novo método aggregateProductStatuses.list retorna uma lista de recursos, um para cada combinação de contexto de relatórios e país. Use o parâmetro filter para recuperar dados específicos. Para problemas no nível da conta, use accountissues.list.

Mudanças detalhadas nos campos

Os campos de estatísticas e problemas do produto foram atualizados e reestruturados no novo recurso AggregateProductStatus.

API Content for Shopping API Merchant Descrição
products aggregate_product_statuses A matriz products é substituída pelo campo repetido aggregate_product_statuses na resposta da lista.
destination reporting_context O campo destination é substituído por reporting_context, que especifica o contexto do programa para as estatísticas.
channel (nenhum campo equivalente) O campo channel é removido. Agora, essas informações fazem parte do reporting_context.
statistics stats O objeto statistics é renomeado para stats. Os nomes dos campos são convertidos para snake_case. Por exemplo, activeCount agora é active_count.
itemLevelIssues.servability item_level_issues.severity O enum servability é substituído pelo enum severity para descrever o impacto de um problema.
itemLevelIssues.attributeName item_level_issues.attribute O campo attributeName é renomeado para attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri O campo documentation é renomeado para documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count O campo numItems é renomeado para product_count.
Anterior
Migrate accountstatuses to Account Issues
Avançar
Migrate user and access management