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 con ella.

Los comercios que tienen varias tiendas en línea o marcas 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 de responder de forma adecuada si encontramos contenido o comportamientos que las infrinjan.

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 del estado de la cuenta de una sola cuenta de comerciante.

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

A continuación, se incluye una solicitud de muestra, en la que merchantId es un 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

Para obtener información sobre el estado de la cuenta 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 el accountLevelIssues que se muestra en la respuesta de accountstatuses.get.

A continuación, se incluye una respuesta de muestra para una cuenta secundaria que se suspendió por un incumplimiento de que 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 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. Si no se especifica un destino, la respuesta incluye estados para destination: Shopping.

Esta es una solicitud de muestra para obtener información sobre el estado de la cuenta de todas las cuentas secundarias en 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.

A continuación, se incluye 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 por lotes

Un elemento 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 cuerpo JSON de solicitud de ejemplo:

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

El siguiente es un cuerpo de respuesta JSON de muestra:

{
 "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 de estados de la cuenta

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

  1. Obtén el estado de las cuentas secundarias de una MCA con accountstatuses.get.

    1. Obtén merchantId y accountId mediante una GET en el 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 comprobarlo y la lista de estados de la cuenta en JSON.

  2. Consulta todos los estados de 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 confirmar la acción y la lista de estados de la cuenta en JSON para el merchantId enviado.

  3. Consulta varias cuentas secundarias de 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 en el 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 comprobarlo y la lista de estados de la cuenta en JSON.