Kontostatus

Mit der Ressource accountstatuses können Sie den Status Ihres Merchant Center-Kontos oder eines Mehrfachkundenkontos (Multi-Client Account, MCA) und aller damit verknüpften Unterkonten abrufen.

Händler mit mehreren Onlineshops oder Marken, die auf separaten Websites verkauft werden, können Unterkonten unter einem MCA einrichten.

Händler sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und angemessen zu reagieren, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.

Weitere Informationen zu häufigen Kontoproblemen finden Sie unter Kontoprobleme.

accountstatuses.get

Mit accountstatuses.get können Sie sich die Kontostatusinformationen für ein einzelnes Händlerkonto ansehen.

Mit dem Parameter destination können Sie festlegen, welche Produktprobleme zurückgegeben werden. Wenn kein Ziel angegeben ist, enthält die Standardantwort Status für destination: Shopping.

Hier sehen Sie eine Beispielanfrage, in der merchantId eine MCA-Konto-ID und accountId ein Unterkonto dieses MCAs ist:

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

Rufen Sie accountstatuses.get mit derselben Konto-ID für merchantId und accountId auf, um Informationen zum Kontostatus für ein eigenständiges Konto abzurufen.

Diese Methode gibt Probleme auf Konto- und Artikelebene zurück. Mit den Ressourcen Shopping-Anzeigen und Produkteinträge können Sie accountLevelIssues beheben, das in der Antwort von accountstatuses.get zurückgegeben wird.

Hier ist eine Beispielantwort für ein untergeordnetes Konto, das aufgrund eines Verstoßes gegen die Richtlinie „Nicht funktionierende Landingpage“ gesperrt wurde.

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

Mit accountstatuses.list können Sie sich Informationen zum Kontostatus aller Unterkonten Ihres MCA ansehen.

Sie können Filter mit accountstatuses.list verwenden, um Produktprobleme nach Ziel zu filtern. Wenn kein Ziel angegeben ist, enthält die Antwort Status für destination: Shopping.

Hier sehen Sie eine Beispielanfrage, mit der Sie Kontostatusinformationen für alle Unterkonten unter dem MCA merchantId abrufen:

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

Sie sehen hier ein Beispiel:

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

Ein Aufruf von accountstatuses.list für ein Konto, das kein MCA ist (z. B. ein eigenständiges Merchant Center-Konto), gibt einen 403-Fehler zurück.

Hier ist eine Beispielantwort für den Aufruf von accountstatuses.list für ein eigenständiges Konto:

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

Batch-Modus

Eine accountstatuses.custombatch mit einer GET-Methode gibt Kontostatusinformationen für mehrere Unterkonten in einem Mehrfachkundenkonto zurück.

Das Anfrage-JSON enthält die merchantId der MCA-Kontonummer, die accountId des Unterkontos, eine eindeutige batchId und die auf get festgelegte method.

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

Das folgende Beispiel zeigt einen JSON-Anfragetext:

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

Hier ist ein Beispiel für einen JSON-Antworttext:

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

Ressource „Account Statuses“ testen

Im folgenden Beispiel rufen wir den Kontostatus für MCA-Konten ab, listen ihn auf und custombatch.get:

  1. Mit accountstatuses.get können Sie den Status von Unterkonten für ein MCA abrufen.

    1. Rufen Sie merchantId und accountId ab, indem Sie eine GET an den API-Endpunkt senden:

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

    2. Sie sollten einen HTTP 200-Statuscode für den Erfolg und die Kontostatusliste in JSON erhalten.

  2. Mit accountstatuses.list können Sie den Status aller Unterkonten eines MCA aufrufen.

    1. Führen Sie einen GET-Vorgang für den API-Endpunkt mit Ihrem merchantId aus:

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

    2. Sie sollten einen HTTP 200-Statuscode für den Erfolg und die Kontostatusliste in JSON für das eingereichte merchantId erhalten.

  3. Sie können mehrere Unterkonten für ein MCA im Batchmodus mit accountstatuses.custombatch aufrufen.

    1. Erstellen Sie gültiges JSON mit accountID, merchant ID und der Methode get.

    2. Führen Sie einen POST-Vorgang für den API-Endpunkt aus:

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

    3. Sie sollten einen HTTP 200-Statuscode für den Erfolg und die Kontostatusliste in JSON erhalten.