Estado de la cuenta

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

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

Los comercios son responsables de cumplir con las políticas de anuncios de Shopping y de fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder de la manera que corresponda si detectamos contenido o conductas que las infrinjan.

Consulta la referencia de 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 del estado de la cuenta de un solo comercio.

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

Esta es una solicitud de ejemplo, en la que merchantId es un ID de cuenta de MCA y accountId es una cuenta secundaria de esa MCA:

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

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

Este método muestra problemas a nivel de la cuenta y del artículo. Puedes usar los recursos de anuncios de Shopping y fichas gratuitas para corregir que se muestran en la respuesta de .accountLevelIssuesaccountstatuses.get

Esta es una respuesta de ejemplo para una cuenta secundaria que se suspendió por una infracción de "página de destino que 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 la cuenta de todas las cuentas secundarias de tu MCA.

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

Esta es una solicitud de ejemplo para obtener información sobre el estado de la cuenta de todas las cuentas secundarias de la MCA merchantId:

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 ejemplo 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

Un accountstatuses.custombatch con un método GET muestra información sobre el estado de la cuenta de varias cuentas secundarias en una cuenta de varios clientes.

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

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

El siguiente es un ejemplo de cuerpo JSON de la solicitud:

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

El siguiente es un ejemplo de cuerpo JSON de la respuesta:

{
 "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 custombatch.get el estado de la cuenta para las cuentas de MCA:

  1. Obtén el estado de la cuenta secundaria de una MCA con accountstatuses.get.

    1. Para obtener el merchantId y el accountId, realiza una solicitud 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 indicar que la operación se realizó correctamente y la lista de estados de la cuenta en JSON.

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

    1. Realiza una solicitud 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 indicar que la operación se realizó correctamente y la lista de estados de la cuenta en JSON para el merchantId enviado.

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

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

    2. Realiza una solicitud 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 indicar que la operación se realizó correctamente y la lista de estados de la cuenta en JSON.