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 específicos en la Merchant API. En esta guía, se explica cómo migrar tu integración para usar el nuevo recurso aggregateProductStatuses.

Nota: En la API de Merchant, los problemas a nivel de la cuenta y los estados agregados de los productos se dividen. También puedes revisar nuestra guía para migrar de accountstatuses a problemas de la cuenta.

Diferencias clave

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

• 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 agregadas de los productos 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 búsqueda 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.
• Se quitó el campo Channel: Ya no se usa el campo channel. Esta información ahora forma parte implícita del reportingContext.

Solicitudes

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

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	accountId identificó el recurso. Se seleccionaron segmentos de datos específicos con parámetros de consulta.	El nombre del recurso identifica de forma única los datos para un contexto de informes y un país específicos: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Métodos

Se actualizó el método para recuperar los estados de los productos 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 del producto. 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 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 campo repetido aggregate_product_statuses reemplaza el array products 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 del reporting_context.
statistics	stats	Se cambió el nombre del objeto statistics por stats. Los nombres de los campos internos se convierten a snake_case, por ejemplo, activeCount ahora es active_count.
itemLevelIssues.servability	item_level_issues.severity	Se reemplazó la enumeración servability 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 a attribute.
itemLevelIssues.documentation	item_level_issues.documentation_uri	Se cambió el nombre del campo documentation a documentation_uri.
itemLevelIssues.numItems	item_level_issues.product_count	Se cambió el nombre del campo numItems a product_count.