Produktstatus

Unter productstatuses können Sie den detaillierten Status Ihrer Shopping-Produkte einsehen.

Weitere Informationen zu häufigen Problemen finden Sie unter Produktprobleme.

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 entsprechend zu reagieren, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.

Voraussetzungen

So rufen Sie den Produktstatus auf:

  • Registrieren Sie Ihr Konto bei einem Ziel.
  • Geben Sie einen gültigen Ländercode in einer der folgenden Sprachen an:
    • Das Feld feedLabel.
    • Das Feld shipping.
    • Auf Feedebene.
    • Versandeinstellungen Ihres Kontos

Status eines Produkts abrufen

Verwenden Sie productstatuses.get, um den Status eines Produkts aufzurufen.

Mit dem Parameter destinations in get- und list-Anfragen können Sie sich Probleme für ein bestimmtes Ziel ansehen. Wenn Sie kein Ziel angeben, werden Probleme aus allen infrage kommenden Zielen zurückgegeben.

Hier eine Beispielanfrage für get mit optionalen Abfrageparametern:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

Alle Antworten von productstatuses.get enthalten die folgenden Felder:

  • kind: Der Wert ist immer content#productStatus.
  • creationDate: Das Datum, an dem das Produkt erstellt wurde.
  • lastUpdateDate: Der Zeitpunkt der letzten Aktualisierung des Produkts.
  • googleExpirationDate: Das Datum, an dem das Produkt abläuft.
  • productId: Die REST-ID des Produkts.
  • title: Der Titel des Produkts.
  • link: Die URL des Produkts.
  • destinationStatuses: Der Status des Produkts in jedem Ziel und Land.

Das Feld itemLevelIssues wird nur in der Antwort angezeigt, wenn zum Zeitpunkt Ihrer Anfrage Probleme auf Artikelebene mit dem Produkt vorliegen.

Hier ist eine Beispiel-JSON-Antwort:

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

Alle Produktstatus auflisten

Mit productstatuses.list können Sie alle Ihre Produkte und deren Status aufrufen.

Sie können die folgenden Parameter verwenden, um Ihre Abfrage zu verfeinern:

  • destinations: Das Ziel, für das Status angezeigt werden sollen.
  • pageToken: Wird verwendet, um nachfolgende Seiten mit Ergebnissen abzurufen. Jede Seite enthält ein nextPageToken, mit dem Sie die nächste Seite in der Sequenz abrufen können.
  • maxResults: Die maximale Anzahl von Ergebnissen pro Seite.

Hier eine Beispielanfrage für list mit optionalen Abfrageparametern:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

Hier ist eine Beispiel-JSON-Antwort:

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

Der productstatuses.list-Aufruf kann in der Produktion getestet werden, da er keine Änderungen an Ihren Daten vornimmt.

Ziele

Hier sind die Zielanwendungen, die Sie für Shopping-Produkte verwenden können:

  • shopping ads: Shopping-Anzeigenprodukte.
  • ShoppingActions: Buy on Google-Produkte
  • surfaces across google: Produkteinträge
  • shopping: Produkte für Anzeigen für lokales Inventar.

Probleme auf Artikelebene

Jedes Problem auf Artikelebene enthält die folgenden Felder:

  • code: Der Fehlercode, mit dem das Problem ermittelt wird.
  • servability: Gibt an, ob das Produkt als Folgendes angezeigt wird:
    • disapproved: Das Problem verhindert, dass das Produkt angezeigt wird.
    • unaffected: Das Produkt wird weiterhin angezeigt.
  • resolution: Gibt an, ob der Händler das Problem beheben kann.
  • attributeName: Der Name des betroffenen Attributs.
  • destination: Das betroffene Ziel.
  • description: Die Beschreibung des Produkts.
  • detail: Enthält weitere Informationen zum Problem.
  • documentation: Gibt an, wo die Dokumentation zum Problem zu finden ist.
  • applicableCountries: Gibt an, in welchen Ländern das Problem das Produkt betrifft.