Produktstatus

Mit der productstatuses-Ressource 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 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 finden, die gegen diese Richtlinien verstoßen.

Voraussetzungen

So rufen Sie Produktstatus auf:

  • Registrieren Sie Ihr Konto für ein Ziel.
  • Geben Sie einen gültigen Ländercode in einem der folgenden Formate 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 Parameter destinations in get- und list-Anfragen können Sie Probleme für ein bestimmtes Zielvorhaben aufrufen. Wenn Sie kein Ziel angeben, werden Probleme von allen infrage kommenden Zielen zurückgegeben.

Hier sehen Sie 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: Der URL-Link 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 hat.

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 Anfrage zu 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 sehen Sie ein Beispiel für eine list-Anfrage 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.

Reiseziele

Hier finden Sie die Zielanwendungen, 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, der zur Bestimmung des Problems verwendet 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 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.