Ressource Account Statuses

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 utiliser 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 que MC (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'."
 }
}

Requêtes par lot

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

La requête JSON comporte le paramètre merchantId du numéro de multicompte, le paramètre accountId du sous-compte, un paramètre batchId unique et le paramètre method défini 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 des sous-comptes d'un multicompte à 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 devez 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 le paramètre merchantId :

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      
    2. Vous devez recevoir un code d'état HTTP 200 en cas de réussite, ainsi que la liste des états des comptes 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 devez recevoir un code d'état HTTP 200 en cas de réussite, ainsi que la liste des états des comptes au format JSON.