Estado de la cuenta

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

Los comercios que tienen varias tiendas en línea o marcas 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 los anuncios de Shopping y las fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder según corresponda si detectamos contenido o comportamientos que las infrinjan.

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

accountstatuses.get

Puedes usar accountstatuses.get para ver la información del 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 estados para destination: Shopping.

A continuación, se muestra 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 devuelve problemas a nivel de la cuenta y del elemento. Puedes usar los recursos de los anuncios de Shopping y las fichas gratuitas para corregir el error accountLevelIssues que se devolvió en la respuesta de accountstatuses.get.

Esta es una respuesta de ejemplo para una cuenta secundaria que se suspendió por incumplimiento de la política 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 en todas las cuentas secundarias de tu MCA.

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

A continuación, se muestra 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) devuelve un error 403.

A continuación, se muestra una respuesta de ejemplo para llamar a accountstatuses.list en 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 de lote

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

El JSON de la solicitud incluye el merchantId del número de cuenta de 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

A continuación, se muestra un ejemplo del cuerpo de la solicitud en formato 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 del cuerpo de la 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 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. Obtén merchantId y accountId realizando una 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 que indica que la operación se realizó correctamente y la lista de estados de la cuenta en formato 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 que indica que la operación se realizó correctamente y la lista de estados de la cuenta en formato JSON para el merchantId enviado.

  3. Consulta varias cuentas secundarias de MCA en modo de lote 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 que indica que la operación se realizó correctamente y la lista de estados de la cuenta en formato JSON.