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 la API de Content para Shopping, la API de Merchant presenta 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 de productos agregados se dividen. También revisa nuestra guía para migrar de accountstatuses a estados de productos agregados.

Diferencias clave

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

  • Recurso dedicado: 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, anuncios de Shopping), la región específica y la gravedad del problema en esa región.
  • Gravedad como una enumeración: El campo severity ahora es una enumeración (con valores como CRITICAL, ERROR y SUGGESTION), lo que facilita el procesamiento de manera programática en comparación con los valores basados en cadenas de la API de Content para Shopping.
  • Identificadores estandarizados: Cada problema de la cuenta tiene un recurso completo y único name 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 Content API for Shopping.
  • Comportamiento de la cuenta avanzada: Cuando llamas a accounts.issues.list en una cuenta avanzada, solo se devuelven los problemas que se aplican directamente a esa cuenta avanzada. 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 los 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 una cuenta de Merchant Center específica.

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 por las cuentas secundarias.

Identificadores

Los identificadores de cuentas y 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 un parámetro de ruta de acceso 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 los 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 los 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 los problemas de la cuenta especificada, no de sus cuentas secundarias. Para obtener los 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. El procesamiento por lotes de los problemas de la cuenta no se admite en la API de Merchant. Debes realizar llamadas list individuales para cada cuenta.

Cambios detallados de los campos

Se actualizaron los campos 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) Ahora, los problemas 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 solicitud) Los nuevos parámetros de la solicitud list permiten la localización de campos legibles por humanos, como title y detail.
Anterior
Migrate account management
Siguiente
Migrate accountstatuses to Aggregate Product Statuses