Migra de accountstatuses a Account Issues

Cambió la forma en que recuperas los problemas a nivel de la cuenta que pueden afectar tus productos y el estado de la cuenta. En comparación con el recurso accountstatuses de Content API for Shopping, la API de Merchant presenta un recurso AccountIssue exclusivo que proporciona información más estructurada y detallada.

Para obtener más información sobre cómo usar la nueva función, consulta la guía para ver los problemas de la cuenta.

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 revisa nuestra guía para migrar de accountstatuses a los estados agregados de los productos.

Diferencias clave

Estas son las principales mejoras y diferencias en el recurso AccountIssue de la API de Merchant:

• Recurso exclusivo: Los problemas de la cuenta son su propio recurso. En Content API for Shopping, los problemas a nivel de la cuenta eran un campo anidado dentro del recurso general AccountStatus. Con la API de Merchant, puedes enumerarlos directamente con el método accounts.issues.list.
• Datos de impacto estructurados: El recurso AccountIssue proporciona un campo impactedDestinations detallado. Este campo te brinda un desglose claro del impacto de un problema, incluido el destino (por ejemplo, los anuncios de Shopping), la región específica y la gravedad del problema en esa región.
• Gravedad como enumeración: El campo severity ahora es una enumeración (con valores como CRITICAL, ERROR, SUGGESTION), lo que facilita el procesamiento programático en comparación con los valores basados en cadenas de Content API for Shopping.
• Identificadores estandarizados: Cada problema de la cuenta tiene un name de recurso único y completo en el formato accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Este enfoque estandarizado reemplaza la cadena id de Content API for Shopping.
• Compatibilidad con la localización: El método accounts.issues.list te permite especificar un language_code para recibir detalles del problema, como el título y la descripción, en el idioma que prefieras. Esto no era posible en Content API for Shopping.
• Comportamiento avanzado de la cuenta: Cuando llamas a accounts.issues.list en una cuenta avanzada, solo muestra los problemas que se aplican directamente a esa cuenta avanzada. No muestra problemas de ninguna de sus cuentas secundarias. En Content API for Shopping, el método accountstatuses.list mostraba los estados de todas las cuentas secundarias. Para obtener problemas de todas las cuentas secundarias en la API de Merchant, debes llamar a accounts.listSubaccounts y, luego, a accounts.issues.list para cada cuenta secundaria de forma individual.

Solicitudes

En la API de Merchant, puedes enumerar los problemas de la cuenta para una cuenta específica de Merchant Center.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

Comparación de URLs de solicitud

Descripción de la solicitud	Content API for Shopping	API de Merchant
Enumera los problemas a nivel de la cuenta para una sola cuenta	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Enumera los problemas a nivel de la cuenta para todas las cuentas secundarias de una cuenta avanzada	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	No disponible. Debes iterar a través de las cuentas secundarias.

Identificadores

Los identificadores de las cuentas y los problemas cambiaron en la API de Merchant.

Comparación de identificadores

Descripción del identificador	Content API for Shopping	API de Merchant
Identificador de cuenta	{MERCHANT_ID} y {ACCOUNT_ID} como parámetros de ruta	{ACCOUNT_ID} como parámetro de ruta en el formato accounts/{ACCOUNT_ID}.
Identificador de edición	Campo id en el cuerpo de la respuesta (por ejemplo, "products-that-enable-dishonest-behavior-hacking-policy")	Campo name en el cuerpo de la respuesta, que es el nombre completo del recurso (por ejemplo, accounts/12345/issues/example-issue-id)

Métodos

Los métodos para recuperar problemas de la cuenta se consolidaron y simplificaron en la API de Merchant.

Comparación de métodos

Content API for Shopping	API de Merchant	Disponibilidad y notas
accountstatuses.get	accounts.issues.list	Disponible. Para obtener problemas de una sola cuenta, usa accounts.issues.list y especifica el ID de la cuenta. La API de Merchant no tiene un método get para un solo problema.
accountstatuses.list	Sin equivalente directo.	No disponible. El método accounts.issues.list en la API de Merchant solo muestra los problemas de la cuenta especificada, no de sus cuentas secundarias. Para obtener problemas de todas las cuentas secundarias, primero debes llamar a accounts.listSubaccounts y, luego, a accounts.issues.list para cada cuenta secundaria.
accountstatuses.custombatch	Sin equivalente directo.	No disponible. No se admite el procesamiento por lotes para los problemas de la cuenta en la API de Merchant. Debes realizar llamadas list individuales para cada cuenta.

Cambios detallados en los campos

Se actualizaron los campos dentro del recurso de problemas de la cuenta para proporcionar más estructura y claridad.

Comparación de campos

Content API for Shopping	API de Merchant	Descripción
accountLevelIssues (array en AccountStatus)	accountIssues (array en ListAccountIssuesResponse)	Los problemas ahora son un recurso exclusivo de nivel superior, no un campo anidado.
id (cadena)	name (cadena)	El identificador de edición ahora es un nombre de recurso completo, por ejemplo, accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (cadena)	title (cadena)	Sin cambios.
detail (cadena)	detail (cadena)	Sin cambios.
documentation (cadena)	documentationUri (cadena)	Se cambió el nombre del campo para mayor claridad para indicar que es una URL.
severity (cadena)	severity (enumeración)	La gravedad ahora es una enumeración estructurada (CRITICAL, ERROR, SUGGESTION) en lugar de una cadena.
country (cadena), destination (cadena)	impactedDestinations (mensaje repetido)	El impacto ahora está estructurado en una lista, que agrupa el destino, la región y la gravedad de cada área afectada. El campo country se reemplaza por regionCode dentro del mensaje Impact.
(No disponible)	language_code, time_zone (parámetros de solicitud)	Los parámetros nuevos en la solicitud list permiten la localización de campos legibles por humanos como title y detail.