État du compte

La ressource accountstatuses vous permet de consulter l'état de votre compte Merchant Center ou d'un MC (multicompte) et de tous les sous-comptes qui lui sont associés.

Les marchands possédant plusieurs boutiques en ligne ou marques vendues sur des sites Web distincts peuvent choisir de disposer de sous-comptes dans un MC.

Les marchands sont tenus de respecter les règles concernant les annonces Shopping et les fiches gratuites. Google Shopping se réserve le droit de faire appliquer ces règles et de prendre les mesures appropriées si nous détectons un contenu ou un comportement qui n'y est pas conforme.

Pour en savoir plus sur les problèmes courants liés aux comptes, consultez cette page.

accountstatuses.get

accountstatuses.get vous permet d'afficher les informations sur l'état d'un seul compte marchand.

Vous pouvez utiliser le paramètre destination pour contrôler quels problèmes liés aux produits sont renvoyés. Lorsqu'une destination n'est pas spécifiée, la réponse par défaut inclut les états pour destination: Shopping.

Voici un exemple de requête dans laquelle merchantId est l'ID d'un MC et accountId est un sous-compte de ce MC :

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

Pour obtenir des informations sur l'état d'un compte individuel, appelez accountstatuses.get avec le même ID de compte pour merchantId et accountId.

Cette méthode renvoie les problèmes au niveau du compte et des articles. Vous pouvez vous reporter aux ressources sur les annonces Shopping et les fiches gratuites pour résoudre les accountLevelIssues renvoyés dans la réponse de accountstatuses.get.

Voici un exemple de réponse pour un sous-compte qui a été suspendu pour une violation de type "page de destination qui ne fonctionne pas".

{
 "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

accountstatuses.list vous permet d'afficher l'état de tous les sous-comptes de votre MC.

Avec accountstatuses.list, vous pouvez filtrer les problèmes liés aux produits par destination. Lorsqu'une destination n'est pas spécifiée, la réponse inclut les états pour destination: Shopping.

Voici un exemple de requête permettant d'obtenir des informations sur l'état de tous les sous-comptes du MC merchantId :

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

Voici un exemple de réponse :

{
 "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"
     }
    }
   ]
  }
 ]
}

Un appel d'API accountstatuses.list pour un compte autre qu'un multicompte (par exemple, un compte Merchant Center individuel) renvoie une erreur 403.

Voici un exemple de réponse permettant d'appeler accountstatuses.list pour un compte individuel :

{
 "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'."
 }
}

Mode batch

Un appel d'API accountstatuses.custombatch avec une méthode GET renvoie des informations sur l'état du compte pour plusieurs sous-comptes liés à un multicompte.

La requête JSON comporte le merchantId du numéro de compte multicompte, l'accountId du sous-compte, un batchId unique et la method définie sur get.

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

Voici un exemple de corps de requête JSON :

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

Voici un exemple de corps de réponse 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"
      }
     }
    ]
   }
  }
 ]
}

Tester la ressource Account Statuses

Dans l'exemple suivant, nous récupérons l'état des comptes d'un multicompte à l'aide de la méthode custombatch.get :

  1. Obtenez l'état d'un sous-compte d'un MC à l'aide de accountstatuses.get.

    1. Les paramètres merchantId et accountId peuvent être obtenus en exécutant GET au point de terminaison de l'API :

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

    2. Vous devriez recevoir un code d'état HTTP 200 en cas de réussite, ainsi que la liste des états des comptes au format JSON.

  2. Affichez l'état de tous les sous-comptes d'un multicompte à l'aide de accountstatuses.list.

    1. Exécutez une commande GET au point de terminaison de l'API avec votre merchantId :

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

    2. Vous devriez recevoir un code d'état HTTP 200 en cas de réussite, ainsi que la liste des états du compte au format JSON pour le paramètre merchantId envoyé.

  3. Affichez les sous-comptes d'un multicompte à l'aide de accountstatuses.custombatch.

    1. Créez un corps de requête JSON valide à l'aide des paramètres accountID et merchant ID, et de la méthode get.

    2. Exécutez une commande POST au point de terminaison de l'API :

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

    3. Vous devriez recevoir un code d'état HTTP 200 en cas de réussite, ainsi que la liste des états des comptes au format JSON.