Kontostatus

Sie können die accountstatuses um den Status Ihres Händlers Center-Konto oder ein Mehrfachkundenkonto und alle zugehörigen Unterkonten damit nichts.

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

Die Händler sind für die Einhaltung der Richtlinien für Shopping-Anzeigen anzeigen und kostenlos Richtlinien für Einträge. Google 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 finden Sie in der Referenz zu Kontoproblemen. .

accountstatuses.get

Mit accountstatuses.get können Sie die Kontostatusinformationen für eine mit nur einem Händlerkonto.

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

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

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

Informationen zum Kontostatus für ein eigenständiges Konto erhalten Sie unter accountstatuses.get mit derselben Konto-ID für merchantId und accountId.

Diese Methode gibt Probleme auf Konto- und Artikelebene zurück. Sie können die Shopping-Kampagnen ads und Free zu korrigierende Ressourcen accountLevelIssues wurde in der Antwort von accountstatuses.get zurückgegeben.

Hier sehen Sie eine Beispielantwort für ein Unterkonto, das aufgrund einer „Landingpage“ Seite funktioniert nicht“ verstoßen.

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

Du kannst Filter mit accountstatuses.list verwenden, um Produktprobleme nach Ziel. 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. unter dem 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 Konto, das kein MCA-Konto ist (z. B. ein Merchant Center-Konto) gibt den Fehler 403 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'."
 }
}

Batchmodus

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

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

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 des custombatch.get-Kontos für MCA-Konten:

  1. Rufen Sie den Unterkontostatus für ein Mehrfachkundenkonto mit accountstatuses.get ab.

    1. Rufen Sie merchantId und accountId ab, indem Sie GET für die API ausführen Endpunkt:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      
    2. Sie sollten den Statuscode HTTP 200 erhalten, wenn der Vorgang erfolgreich war und das Konto Statusliste im JSON-Format.

  2. 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. Sie sollten den Statuscode HTTP 200 erhalten, wenn der Vorgang erfolgreich war und das Konto Statusliste im JSON-Format für die gesendeten merchantId.

  3. Mehrere Unterkonten für MCA im Batchmodus mit accountstatuses.custombatch

    1. Gültigen JSON-Code mit accountID, merchant ID und get erstellen .

    2. Führen Sie einen POST an den API-Endpunkt aus:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
      
    3. Sie sollten den Statuscode HTTP 200 erhalten, wenn der Vorgang erfolgreich war und das Konto Statusliste im JSON-Format.