Diese Seite wurde von der Cloud Translation API übersetzt.

Kontostatus

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

Händler mit mehreren Onlineshops oder Marken, die auf separaten Websites verkauft werden, können Unterkonten für ein Mehrfachkundenkonto einrichten.

Händler sind für die Einhaltung der Richtlinien für Shopping-Anzeigen und Produkteinträge verantwortlich. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und angemessene Maßnahmen zu ergreifen, wenn Inhalte oder Verhaltensweisen gegen diese Richtlinien verstoßen.

Details zu häufigen Kontoproblemen finden Sie in der Referenz zu Kontoproblemen.

accountstatuses.get

Mit accountstatuses.get kannst du die Kontostatusinformationen für ein einzelnes Händlerkonto ansehen.

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

Hier sehen Sie eine Beispielanfrage, bei der merchantId eine MCA-Konto-ID und accountId ein Unterkonto dieses Mehrfachkundenkontos 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 zu erhalten.

Bei dieser Methode werden Probleme auf Konto- und Artikelebene zurückgegeben. Sie können die Ressourcen Shopping-Anzeigen und Produkteinträge verwenden, um Probleme mit accountLevelIssues zu beheben, der in der Antwort von accountstatuses.get zurückgegeben wurde.

Hier sehen Sie eine Beispielantwort für ein Unterkonto, das aufgrund eines Verstoßes gegen die Richtlinie „Landingpage funktioniert nicht“ 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 Kontostatusinformationen zu allen Unterkonten Ihres Mehrfachkundenkontos aufrufen.

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 ist eine Beispielanfrage zum Abrufen von Kontostatusinformationen für alle Unterkonten im Mehrfachkundenkonto merchantId:

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

Bei einem Aufruf von accountstatuses.list für ein Nicht-MCA-Konto (z. B. ein eigenständiges Merchant Center-Konto) wird der Fehler 403 zurückgegeben.

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

Batchmodus

Ein accountstatuses.custombatch mit der Methode GET gibt Kontostatusinformationen für mehrere Unterkonten in einem Mehrfachkundenkonto zurück.

Die JSON-Anfrage enthält den merchantId der MCA-Kontonummer, den accountId des Unterkontos, eine eindeutige batchId und den auf get festgelegten method.

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

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

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

Hier sehen Sie 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"
      }
     }
    ]
   }
  }
 ]
}

Kontostatus-Ressource testen

Im folgenden Beispiel wird der Kontostatus für MCA-Konten abgerufen, aufgelistet und custombatch.get:

Rufen Sie den Unterkontostatus für ein Mehrfachkundenkonto mit accountstatuses.get ab.
1. Rufen Sie merchantId und accountId ab, indem Sie GET an den API-Endpunkt senden:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Sie sollten den Statuscode HTTP 200 für die erfolgreiche Ausführung und die Kontostatusliste im JSON-Format erhalten.
Rufen Sie den Status aller Unterkonten für ein Mehrfachkundenkonto mit accountstatuses.list auf.
1. Führen Sie mit merchantId einen GET-Vorgang zum API-Endpunkt aus:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Sie sollten den Statuscode HTTP 200 für die erfolgreiche Ausführung und die Kontostatusliste im JSON-Format für die gesendete merchantId erhalten.
Sie können mit accountstatuses.custombatch mehrere Unterkonten für das Mehrfachkundenkonto im Batchmodus aufrufen.
1. Erstellen Sie mit der Methode accountID, merchant ID und get einen gültigen JSON-Code.
2. POST an den API-Endpunkt ausführen:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Sie sollten den Statuscode HTTP 200 für die erfolgreiche Ausführung und die Kontostatusliste im JSON-Format erhalten.