Produktstatus

Mit der Ressource productstatuses kannst du den detaillierten Status deiner Shopping-Produkte ansehen.

Unter Produktprobleme finden Sie Details zu häufigen Problemen.

Händler sind für die Einhaltung der Richtlinien für Shopping-Anzeigen und Produkteinträge verantwortlich. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und angemessene Maßnahmen zu ergreifen, wenn Inhalte oder Verhaltensweisen gegen diese Richtlinien verstoßen.

Voraussetzungen

Führen Sie die folgenden Schritte aus, damit Produktstatus angezeigt werden:

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

Status eines Produkts abrufen

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

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

Hier ein Beispiel für eine get-Anfrage 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, zu 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: der URL-Link des Produkts.
  • destinationStatuses: Der Status des Produkts für die einzelnen Ziele und Länder.

Das Feld itemLevelIssues wird nur dann in der Antwort angezeigt, wenn das Produkt zum Zeitpunkt Ihrer Anfrage Probleme auf Artikelebene hat.

Hier ist ein Beispiel für eine 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

Verwenden Sie productstatuses.list, um alle Ihre Produkte und deren Status anzusehen.

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

  • destinations: Das Ziel, für das der Status abgerufen werden soll.
  • pageToken: Dient zum Abrufen nachfolgender Ergebnisseiten. Jede Seite hat eine nextPageToken, mit der Sie zur nächsten Seite in der Sequenz wechseln können.
  • maxResults: Die maximale Anzahl von Ergebnissen pro Seite.

Hier 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 ein Beispiel für eine 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 bedenkenlos in der Produktion getestet werden, da dadurch keine Änderungen an Ihren Daten vorgenommen werden.

Ziele

Dies sind 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 für Produkte.
  • shopping: Produkte für Anzeigen für lokales Inventar.

Probleme auf Artikelebene

Jedes Problem auf Artikelebene umfasst die folgenden Felder:

  • code: Der Fehlercode, der zur Ermittlung des Problems verwendet wird.
  • servability: gibt an, ob das Produkt angezeigt wird als:
    • disapproved: Das Problem verhindert, dass das Produkt angezeigt wird.
    • unaffected: Das Produkt wird weiterhin angezeigt.
  • resolution: Informiert Sie darüber, ob der Händler das Problem lösen kann.
  • attributeName: Der Name des betroffenen Attributs.
  • destination: Das betroffene Ziel.
  • description: Die Beschreibung des Produkts.
  • detail: liefert 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.