Estado de la cuenta

Puedes usar el recurso accountstatuses para ver el estado de tu cuenta de Merchant Center o una MCA (cuenta de varios clientes) y todas las cuentas secundarias asociadas a ella.

Los comercios que tienen varias tiendas o marcas en línea que se venden en sitios web diferentes pueden optar por tener cuentas secundarias en una MCA.

Los comercios son responsables de cumplir con las políticas de anuncios de Shopping y fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder adecuadamente si detectamos contenido o comportamiento que las infringe.

Consulta la referencia Problemas de la cuenta para obtener detalles sobre los problemas comunes de la cuenta.

accountstatuses.get

Puedes usar accountstatuses.get para ver la información de estado de una sola cuenta de comerciante.

Puedes usar el parámetro destination para controlar qué problemas del producto se muestran. Cuando no se especifica un destino, la respuesta predeterminada incluye los estados de destination: Shopping.

A continuación, se muestra una solicitud de ejemplo, en la que merchantId es el ID de la cuenta de MCA y accountId es una cuenta secundaria de esa MCA:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

Si deseas obtener información sobre el estado de una cuenta independiente, llama a accountstatuses.get con el mismo ID de la cuenta para merchantId y accountId.

Este método devuelve problemas a nivel de la cuenta y del artículo. Puedes usar los recursos de anuncios de Shopping y Fichas gratuitas para corregir el error accountLevelIssues que se muestra en la respuesta de accountstatuses.get.

A continuación, se incluye una respuesta de ejemplo para una cuenta secundaria que se suspendió por un incumplimiento de “la página de destino no funciona”.

{
 "kind": "content#accountStatus",
 "accountId": "123456789",
 "websiteClaimed": true,
 "accountLevelIssues": [
  {
   "id": "editorial_and_professional_standards_destination_url_down_policy",
   "title": "Account suspended due to policy violation: landing page not working",
   "country": "US",
   "severity": "critical",
   "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
  },
  {
   "id": "missing_ad_words_link",
   "title": "No Google Ads account linked",
   "severity": "error",
   "documentation": "https://support.google.com/merchants/answer/6159060"
  }
 ],
 "products": [
  {
   "channel": "online",
   "destination": "Shopping",
   "country": "US",
   "statistics": {
    "active": "0",
    "pending": "0",
    "disapproved": "5",
    "expiring": "0"
   },
   "itemLevelIssues": [
    {
     "code": "image_link_broken",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "image link",
     "description": "Invalid image [image link]",
     "detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
     "documentation": "https://support.google.com/merchants/answer/6098289",
     "numItems": "2"
    },
    {
     "code": "landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable desktop landing page",
     "detail": "Update your website or landing page URL to enable access from desktop devices",
     "documentation": "https://support.google.com/merchants/answer/6098155",
     "numItems": "5"
    },
    {
     "code": "missing_condition_microdata",
     "servability": "unaffected",
     "resolution": "merchant_action",
     "description": "Missing or invalid data [condition]",
     "detail": "Add valid structured data markup to your landing page",
     "documentation": "https://support.google.com/merchants/answer/6183460",
     "numItems": "5"
    },
    {
     "code": "mobile_landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable mobile landing page",
     "detail": "Update your website or landing page URL to enable access from mobile devices",
     "documentation": "https://support.google.com/merchants/answer/6098296",
     "numItems": "3"
    }
   ]
  }
 ]
}

accountstatuses.list

Puedes usar accountstatuses.list para ver la información del estado de todas las cuentas secundarias de tu MCA.

Puedes usar filtros con accountstatuses.list para filtrar los problemas de los productos por destino. Si no se especifica un destino, la respuesta incluye estados para destination: Shopping.

A continuación, se incluye una solicitud de ejemplo para obtener información del estado de todas las cuentas secundarias en el merchantId de la MCA:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

Esta es una respuesta de ejemplo:

{
 "kind": "content#accountstatusesListResponse",
 "resources": [
  {
   "kind": "content#accountStatus",
   "accountId": "1234567",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "editorial_and_professional_standards_destination_url_down_policy",
     "title": "Account suspended due to policy violation: landing page not working",
     "country": "US",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  },
  {
   "kind": "content#accountStatus",
   "accountId": "123456789",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "home_page_issue",
     "title": "Website URL not provided",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/176793"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  }
 ]
}

Una llamada a accountstatuses.list para una cuenta que no es de MCA (por ejemplo, una cuenta independiente de Merchant Center) muestra un error 403.

Esta es una respuesta de muestra para llamar a accountstatuses.list para una cuenta independiente:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "111111111 is not a multi-client account (MCA). The only account
                service operations allowed on non-MCAs are 'get', 'update',
                'authinfo' and 'claimwebsite'."
   }
  ],
  "code": 403,
  "message": "111111111 is not a multi-client account (MCA). The only account
              service operations allowed on non-MCAs are 'get', 'update',
              'authinfo' and 'claimwebsite'."
 }
}

Modo por lotes

Una accountstatuses.custombatch con un método GET muestra información del estado de varias cuentas secundarias en una cuenta de varios clientes.

El JSON de solicitud incluye el merchantId del número de cuenta de la MCA, el accountId de la cuenta secundaria, un batchId único y el method configurado como get.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

A continuación, se muestra un ejemplo de cuerpo de solicitud JSON:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

A continuación, se muestra un ejemplo de cuerpo de respuesta JSON:

{
 "kind": "content#accountstatusesCustomBatchResponse",
 "entries": [
  {
   "batchId": 9,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1212121212",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "home_page_issue",
      "title": "Website URL not provided",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/176793"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  },
  {
   "batchId": 99,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1313131313",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "editorial_and_professional_standards_destination_url_down_policy",
      "title": "Account suspended due to policy violation: landing page not working",
      "country": "US",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  }
 ]
}

Prueba el recurso Account Statuses

En el siguiente ejemplo, obtenemos, enumeramos y el estado de las cuentas custombatch.get para las cuentas de MCA:

  1. Obtener el estado de las cuentas secundarias para una MCA mediante accountstatuses.get

    1. Para obtener merchantId y accountId, realiza un GET al extremo de la API:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      
    2. Deberías recibir un código de estado HTTP 200 para garantizar la ejecución correcta y la lista de estado de la cuenta en JSON.

  2. Consultar el estado de todas las cuentas secundarias de una MCA con accountstatuses.list.

    1. Realiza un GET al extremo de la API con tu merchantId:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      
    2. Deberías recibir un código de estado HTTP 200 para garantizar la ejecución correcta y la lista de estado de la cuenta en JSON para los merchantId enviados.

  3. Consulta varias cuentas secundarias de MCA en modo por lotes con accountstatuses.custombatch.

    1. Crea un JSON válido con accountID, merchant ID y un método get.

    2. Realiza un POST al extremo de la API:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
      
    3. Deberías recibir un código de estado HTTP 200 para garantizar la ejecución correcta y la lista de estado de la cuenta en JSON.