Migra accountstatuses a Aggregate Product Statuses

Cambió la forma en que recuperas las estadísticas y los problemas agregados de los productos. La funcionalidad que antes estaba disponible en el recurso accountstatuses de la 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 recurso aggregateProductStatuses.

Diferencias clave

Estas son las diferencias clave entre las funciones de estado del producto 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 recurso accountissues, mientras que las estadísticas de productos agregadas y los problemas a nivel del artículo están disponibles a través del nuevo recurso aggregateProductStatuses.
  • 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 cadena filter para consultar contextos de informes y países específicos.
  • Eliminación del campo de canal: Ya no se usa el campo channel. Esta información ahora forma parte de forma implícita de reportingContext.

Solicitudes

La API de Merchant usa una solicitud GET con un parámetro filter para recuperar los estados de productos agregados. Para obtener información más detallada sobre la sintaxis de los filtros, consulta Sintaxis de los filtros.

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

Formato de la 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 accountId identificó el recurso. Se seleccionaron segmentos de datos específicos con parámetros de consulta. El nombre del recurso identifica de forma inequívoca 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 contiene todas las estadísticas de 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 de los campos

Los campos de las estadísticas y los 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 quita el campo channel. Esta información ahora forma parte de la reporting_context.
statistics stats Se cambió el nombre del objeto statistics por stats. Los nombres de los campos se convierten a minúsculas con guiones bajos, por ejemplo, activeCount ahora es active_count.
itemLevelIssues.servability item_level_issues.severity La enumeración servability se reemplaza por la enumeración severity para describir el impacto de un problema.
itemLevelIssues.attributeName item_level_issues.attribute Se cambió el nombre del campo attributeName por attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri Se cambió el nombre del campo documentation por documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count Se cambió el nombre del campo numItems por product_count.
Anterior
Migrate accountstatuses to Account Issues
Siguiente
Migrate user and access management