Diese Seite wurde von der Cloud Translation API übersetzt.

Kontostatus

Mit der Ressource accountstatuses kannst du den Status deines Merchant Center-Kontos oder eines Mehrfachkundenkontos (MCA) und aller zugehörigen Unterkonten abrufen.

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

Die 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 feststellen, die gegen diese Richtlinien verstoßen.

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

accountstatuses.get

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

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.

Im Folgenden sehen Sie eine Beispielanfrage, bei der merchantId eine MCA-Konto-ID und accountId ein Unterkonto dieses MCA ist:

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

Wenn Sie Kontostatusinformationen für ein eigenständiges Konto abrufen möchten, rufen Sie accountstatuses.get mit derselben Konto-ID für merchantId und accountId auf.

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

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 für alle Unterkonten Ihres Mehrfachkundenkontos 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 zum Abrufen von Kontostatusinformationen für alle Unterkonten im MCA 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"
     }
    }
   ]
  }
 ]
}

Ein Aufruf des accountstatuses.list für ein Nicht-MCA-Konto (z. B. ein eigenständiges Merchant Center-Konto) gibt den Fehler 403 zurück.

Hier sehen Sie 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 die merchantId der MCA-Kontonummer, die accountId des Unterkontos, eine eindeutige batchId und die method, die auf get festgelegt ist.

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

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

Die Ressource „Kontostatus“ testen

Im folgenden Beispiel wird der Status von MCA-Konten, Listen und custombatch.get-Konten abgerufen:

Rufen Sie den Unterkontostatus für ein Mehrfachkundenkonto mit accountstatuses.get ab.
1. Rufen Sie merchantId und accountId ab, indem Sie GET für den API-Endpunkt ausführen:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Für Erfolg sollten Sie den Statuscode HTTP 200 und die Kontostatusliste im JSON-Format erhalten.
Mit accountstatuses.list können Sie den Status aller Unterkonten für ein Mehrfachkundenkonto aufrufen.
1. Führen Sie mit merchantId eine GET-Anfrage zum API-Endpunkt aus:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Wenn der Vorgang erfolgreich war, sollten Sie den Statuscode HTTP 200 und die Kontostatusliste im JSON-Format für die gesendete merchantId erhalten.
Mit accountstatuses.custombatch können Sie mehrere Unterkonten für MCA im Batchmodus aufrufen.
1. Erstellen Sie mit der Methode accountID, merchant ID und einer get-Methode eine gültige JSON-Datei.
2. Führen Sie einen POST an den API-Endpunkt aus:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Für Erfolg sollten Sie den Statuscode HTTP 200 und die Kontostatusliste im JSON-Format erhalten.