Mithilfe der Ressource productstatuses
kannst du den detaillierten Status deiner Shopping-Produkte aufrufen.
Weitere Informationen zu häufigen Problemen finden Sie unter Produktprobleme.
Die 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 feststellen, die gegen diese Richtlinien verstoßen.
Voraussetzungen
So rufen Sie den Produktstatus auf:
- Registrieren Sie Ihr Konto für ein Ziel.
- Geben Sie einen gültigen Ländercode in einem der folgenden Länder an:
- Das Feld
feedLabel
. - Das Feld
shipping
. - Auf Feedebene.
- Die Versandeinstellungen Ihres Kontos.
- Das Feld
Status eines Produkts abrufen
Mit productstatuses.get
kannst du den Status eines Produkts abrufen.
Sie können den Parameter destinations
in get
- und list
-Anfragen verwenden, um Probleme für ein bestimmtes Ziel aufzurufen. Wenn Sie kein Ziel angeben, werden Probleme von allen geeigneten Zielen zurückgegeben.
Hier ist 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 immercontent#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 in den einzelnen Zielorten und Ländern.
Das Feld itemLevelIssues
wird nur dann in der Antwort angezeigt, wenn das Produkt zum Zeitpunkt Ihrer Anfrage Probleme auf Artikelebene hat.
Hier sehen Sie 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
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 der Status abgerufen werden soll.pageToken
: Wird zum Abrufen der nachfolgenden Ergebnisseiten verwendet. Jede Seite hat einnextPageToken
, mit dem 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 sehen Sie 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 Aufruf productstatuses.list
kann ohne Bedenken in der Produktionsumgebung getestet werden, da keine Änderungen an den Daten vorgenommen werden.
Ziele
Folgende Zielanwendungen können für Shopping-Produkte verwendet werden:
shopping ads
: Produkte in Shopping-Anzeigen.ShoppingActions
: Buy on Google-Produkte.surfaces 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 wie folgt angezeigt wird:disapproved
: Das Problem verhindert, dass das Produkt angezeigt wird.unaffected
: Das Produkt wird weiterhin angezeigt.
resolution
: Informiert darüber, ob der Händler das Problem lösen kann.attributeName
: Der betroffene Attributname.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.