Migrar "accountstatuses" para "Aggregate Product Statuses"
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Mudamos a forma de recuperar estatísticas e problemas agregados de produtos. A funcionalidade antes 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 recurso
aggregateProductStatuses.
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 com a conta.
principais diferenças
Estas são as principais diferenças entre os recursos de status do produto na API Content do 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 um contexto de relatório e um 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 string filter para consultar contextos e países específicos de geração de relatórios.
Remoção do campo "Canal": o campo channel não é mais usado. Essas informações agora fazem parte implicitamente do reportingContext.
Solicitações
A API Merchant usa uma solicitação GET com um parâmetro filter para recuperar
status de produtos agregados.
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 de produtos
GET /content/v2.1/{merchantId}/accountstatuses/{accountId}
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses
Identificadores
A forma 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. Segmentos de dados específicos foram selecionados 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 status de produtos foi atualizado para um método list
que aceita 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 com todas as estatísticas de produtos. O novo método aggregateProductStatuses.list retorna uma lista de recursos, um para cada combinação de contexto de relatório 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 de produtos 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 foi substituído por reporting_context, que especifica o contexto do programa para as estatísticas.
channel
(nenhum campo equivalente)
O campo channel é removido. Essas informações agora fazem parte do reporting_context.
statistics
stats
O objeto statistics foi renomeado como stats. Os nomes dos campos são convertidos para snake_case. Por exemplo, activeCount agora é active_count.
itemLevelIssues.servability
item_level_issues.severity
A enumeração servability foi substituída pela enumeração severity para descrever o impacto de um problema.
itemLevelIssues.attributeName
item_level_issues.attribute
O campo attributeName foi renomeado como attribute.
itemLevelIssues.documentation
item_level_issues.documentation_uri
O campo documentation foi renomeado como documentation_uri.
itemLevelIssues.numItems
item_level_issues.product_count
O campo numItems foi renomeado como product_count.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-08 UTC."],[],[],null,["# Migrate accountstatuses to Aggregate Product Statuses\n\nThe way you retrieve aggregated product statistics and issues has changed. The\nfunctionality previously available in the `accountstatuses` resource in the\nContent API for Shopping is now split into dedicated resources in the Merchant\nAPI. This guide explains how to migrate your integration to use the new\n[`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses)\nresource.\n\n**Note** : In Merchant API, account-level issues and aggregate product statuses\nare split. Also review our guide to migrate from `accountstatuses` to\n[account issues](/merchant/api/guides/compatibility/migrate-view-issues).\n\nKey differences\n---------------\n\nHere are the key differences between the product status features in Content\nAPI for Shopping and Merchant API:\n\n- **Dedicated resources** : The `accountstatuses` resource from Content API for Shopping is now split. In Merchant API, account-level issues are available through the [`accountissues`](/merchant/api/reference/rest/accounts_v1/accounts.issues) resource, while aggregated product statistics and item-level issues are available through the new [`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses) resource.\n- **New resource structure** : `AggregateProductStatus` is a new resource that represents the statistics and issues for a specific combination of a reporting context and a country.\n- **Filtering mechanism** : Instead of using query parameters like `destinations` to select data, Merchant API uses a `list` method with a `filter` string to query for specific reporting contexts and countries.\n- **Channel field removal** : The `channel` field is no longer used. This information is now implicitly part of the `reportingContext`.\n\nRequests\n--------\n\nMerchant API uses a `GET` request with a `filter` parameter to retrieve\naggregated product statuses.\n\n`GET\nhttps://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses`\n\n### Request URL format\n\n| Request description | Content API for Shopping | Merchant API |\n|-----------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------|\n| Get product statistics and issues | `GET /content/v2.1/{merchantId}/accountstatuses/{accountId}` | `GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses` |\n\nIdentifiers\n-----------\n\nThe way resources are identified has changed to support the new structure.\n\n### Identifier format\n\n| Identifier description | Content API for Shopping | Merchant API |\n|------------------------|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Resource Identifier | The resource was identified by `accountId`. Specific data slices were selected with query parameters. | The resource name uniquely identifies the data for a specific reporting context and country: `accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}`. |\n\nMethods\n-------\n\nThe method for retrieving product statuses has been updated to a `list` method\nthat supports filtering.\n\n| Content API for Shopping method | Merchant API method | Availability \\& notes |\n|---------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountstatuses.get` | `aggregateProductStatuses.list` | The `accountstatuses.get` method returned a single resource containing all product statistics. The new `aggregateProductStatuses.list` method returns a list of resources, one for each reporting context and country combination. Use the `filter` parameter to retrieve specific data. For account-level issues, use `accountissues.list`. |\n\nDetailed field changes\n----------------------\n\nThe fields for product statistics and issues have been updated and restructured\nin the new `AggregateProductStatus` resource.\n\n| Content API for Shopping | Merchant API | Description |\n|---------------------------------|---------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `products` | `aggregate_product_statuses` | The `products` array is replaced by the `aggregate_product_statuses` repeated field in the list response. |\n| `destination` | `reporting_context` | The `destination` field is replaced by `reporting_context`, which specifies the program context for the stats. |\n| `channel` | (no equivalent field) | The `channel` field is removed. This information is now part of the `reporting_context`. |\n| `statistics` | `stats` | The `statistics` object is renamed to `stats`. Field names within are converted to snake_case, for example, `activeCount` is now `active_count`. |\n| `itemLevelIssues.servability` | `item_level_issues.severity` | The `servability` enum is replaced by the `severity` enum to describe the impact of an issue. |\n| `itemLevelIssues.attributeName` | `item_level_issues.attribute` | The field `attributeName` is renamed to `attribute`. |\n| `itemLevelIssues.documentation` | `item_level_issues.documentation_uri` | The field `documentation` is renamed to `documentation_uri`. |\n| `itemLevelIssues.numItems` | `item_level_issues.product_count` | The field `numItems` is renamed to `product_count`. |"]]
