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
- Das Feld
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 immercontent#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 einnextPageToken
, 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-Produktesurfaces across google
: Produkteinträgeshopping
: 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.