Produktstatus

Mit der Ressource productstatuses können Sie den detaillierten Status Ihrer Shopping-Produkte aufrufen.

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

Händler sind dafür verantwortlich, die Shopping Anzeigen und kostenlosen Einträge Richtlinien 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.

Voraussetzungen

Sie müssen Folgendes tun, um Produktstatus zu sehen:

  • Registrieren Sie Ihr Konto für ein Ziel.
  • Geben Sie einen gültigen Ländercode in einem der folgenden Felder an:
    • Das Feld feedLabel.
    • Das Feld shipping.
    • Auf Feedebene.
    • Die Versandeinstellungen Ihres Kontos.

Status eines Produkts abrufen

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

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

Hier ist 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: Das Datum, an dem das Produkt zuletzt aktualisiert wurde.
  • 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 in der Antwort nur angezeigt, wenn das Produkt zum Zeitpunkt Ihrer Anfrage Probleme auf Artikelebene aufweist.

Hier ist eine JSON-Beispielantwort:

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

Mit den folgenden Parametern können Sie Ihre Abfrage verfeinern:

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

Hier ist 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 JSON-Beispielantwort:

{
"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 Aufruf productstatuses.list kann gefahrlos in der Produktion getestet werden, da er keine Änderungen an Ihren Daten vornimmt.

Ziele

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

  • shopping ads: Produkte für Shopping-Anzeigen.
  • 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 so 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 betroffene Attributname.
  • destination: Das betroffene Ziel.
  • description: Die Beschreibung des Produkts.
  • detail: Weitere Informationen zum Problem.
  • documentation: Gibt an, wo die Dokumentation zum Problem zu finden ist.
  • applicableCountries: Gibt an, in welchen Ländern sich das Problem auf das Produkt auswirkt.