Migra accountstatuses a Aggregate Product Statuses

La forma en que recuperas las estadísticas y los problemas agregados de los productos cambió. La funcionalidad que antes estaba disponible en el recurso accountstatuses de Content API for Shopping ahora se divide en recursos dedicados en la API de Merchant. En esta guía, se explica cómo migrar tu integración para usar el nuevo aggregateProductStatuses recurso.

Nota: En la API de Merchant, los problemas a nivel de la cuenta y los estados agregados de los productos están separados. También consulta nuestra guía para migrar de accountstatuses a problemas de la cuenta.

Diferencias clave

Estas son las principales diferencias entre las funciones de estado de los productos en Content API for Shopping y la API de Merchant:

  • Recursos dedicados: El recurso accountstatuses de Content API for Shopping ahora está dividido. En la API de Merchant, los problemas a nivel de la cuenta están disponibles a través del accountissues recurso, mientras que las estadísticas agregadas de los productos y los problemas a nivel del artículo están disponibles a través del nuevo aggregateProductStatuses recurso.
  • Nueva estructura de recursos: AggregateProductStatus es un recurso nuevo que representa las estadísticas y los problemas de una combinación específica de un contexto de informes y un país.
  • Mecanismo de filtrado: En lugar de usar parámetros de consulta como destinations para seleccionar datos, la API de Merchant usa un método list con una filter cadena para consultar contextos de informes y países específicos.
  • Eliminación del campo de canal: El campo channel ya no se usa. Esta información ahora forma parte implícitamente de reportingContext.

Solicitudes

La API de Merchant usa una solicitud GET con un parámetro filter para recuperar los estados agregados de los productos.

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

Formato de URL de solicitud

Descripción de la solicitud Content API for Shopping API de Merchant
Obtén estadísticas y problemas de los productos GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identificadores

La forma en que se identifican los recursos cambió para admitir la nueva estructura.

Formato del identificador

Descripción del identificador Content API for Shopping API de Merchant
Identificador de recursos El recurso se identificó con accountId. Se seleccionaron segmentos de datos específicos con parámetros de consulta. El nombre del recurso identifica de forma única los datos de un contexto de informes y un país específicos: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Métodos

El método para recuperar los estados de los productos se actualizó a un método list que admite el filtrado.

Método de Content API for Shopping Método de la API de Merchant Disponibilidad y notas
accountstatuses.get aggregateProductStatuses.list El método accountstatuses.get devolvió un solo recurso que contenía todas las estadísticas de los productos. El nuevo método aggregateProductStatuses.list devuelve una lista de recursos, uno para cada combinación de contexto de informes y país. Usa el parámetro filter para recuperar datos específicos. Para los problemas a nivel de la cuenta, usa accountissues.list.

Cambios detallados en los campos

Los campos de estadísticas y problemas de los productos se actualizaron y reestructuraron en el nuevo recurso AggregateProductStatus.

Content API for Shopping API de Merchant Descripción
products aggregate_product_statuses El array products se reemplaza por el campo repetido aggregate_product_statuses en la respuesta de la lista.
destination reporting_context El campo destination se reemplaza por reporting_context, que especifica el contexto del programa para las estadísticas.
channel (sin campo equivalente) Se quitó el campo channel. Esta información ahora forma parte de reporting_context.
statistics stats El objeto statistics cambió de nombre a stats. Los nombres de los campos dentro de se convierten a snake_case. Por ejemplo, activeCount ahora es active_count.
itemLevelIssues.servability item_level_issues.severity El enum servability se reemplaza por el enum severity para describir el impacto de un problema.
itemLevelIssues.attributeName item_level_issues.attribute El campo attributeName cambió de nombre a attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri El campo documentation cambió de nombre a documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count El campo numItems cambió de nombre a product_count.
Anterior
Migrate accountstatuses to Account Issues
Siguiente
Migrate user and access management