Migra de accountstatuses a Account Issues

La forma en que recuperas los problemas a nivel de la cuenta que pueden afectar tus productos y el estado de la cuenta cambió. En comparación con el recurso accountstatuses de Content API for Shopping, Merchant API introduce un recurso AccountIssue dedicado 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 se dividen. También revisa nuestra guía para migrar de accountstatuses a estados agregados de los productos.

Diferencias clave

A continuación, se indican las principales mejoras y diferencias en el recurso AccountIssue de la API de Merchant:

  • Recurso dedicado: Los problemas de la cuenta son su propio recurso. En la API de Content de 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. En este campo, se proporciona un desglose claro del impacto de un problema, incluido el destino (por ejemplo, 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 de forma programática en comparación con los valores basados en cadenas de la API de Content for Shopping.
  • Identificadores estandarizados: Cada problema de la cuenta tiene un recurso name ú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 tu idioma preferido. Esto no era posible en la API de Content for Shopping.
  • Comportamiento avanzado de la cuenta: Cuando llamas a accounts.issues.list en una cuenta avanzada, solo se muestran los problemas que se aplican directamente a esa cuenta. No devuelve problemas para ninguna de sus cuentas secundarias. En Content API for Shopping, el método accountstatuses.list devolvería 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 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 la cuenta {MERCHANT_ID} y {ACCOUNT_ID} como parámetros de ruta de acceso {ACCOUNT_ID} como parámetro de ruta de acceso en el formato accounts/{ACCOUNT_ID}
Identificador del problema 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 del recurso completo (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 de la API de Merchant solo devuelve problemas para la cuenta especificada, no para sus subcuentas. 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. La API de Merchant no admite el procesamiento por lotes de problemas de la cuenta. Debes realizar llamadas list individuales para cada cuenta.

Cambios detallados en los campos

Se actualizaron los campos del recurso de problema de la cuenta para brindar más estructura y claridad.

Comparación de campos

Content API for Shopping API de Merchant Descripción
accountLevelIssues (matriz en AccountStatus) accountIssues (matriz en ListAccountIssuesResponse) Los problemas ahora son un recurso dedicado de nivel superior, no un campo anidado.
id (string) name (string) El identificador del problema ahora es un nombre de recurso completo, por ejemplo, accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (string) title (string) Sin cambios.
detail (string) detail (string) Sin cambios.
documentation (string) documentationUri (string) Se cambió el nombre del campo para mayor claridad y para indicar que es una URL.
severity (string) 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) Ahora, el impacto se estructura 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 la solicitud) Los nuevos parámetros en la solicitud list permiten la localización de campos legibles, como title y detail.
Anterior
Overview
Siguiente
Migrate accountstatuses to Aggregate Product Statuses