Mit der Ressource Product kannst du den detaillierten Status deiner Shopping-Produkte ansehen.
Mit der Content API können Sie den Produktstatus durch Aufrufen der Methode ProductStatuses.get abrufen. Mit der Merchant API können Sie den Produktstatus abrufen, indem Sie die Ressource Accounts.Products abrufen.
Sie sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Wir behalten uns bei Shopping-Anzeigen das Recht vor, diese Richtlinien durchzusetzen und entsprechende Maßnahmen zu ergreifen, wenn wir Inhalte oder Verhaltensweisen feststellen, die gegen diese Richtlinien verstoßen.
Voraussetzungen
So rufen Sie Produktstatus auf:
- Registrieren Sie Ihr Konto an einem Ziel.
- Geben Sie einen gültigen Ländercode in einer der folgenden Sprachen an:
- Das Feld
feedLabel. - Das Feld
shipping. - Auf Feedebene:
- In den Versandeinstellungen Ihres Kontos.
- Das Feld
Status eines Produkts abrufen
Rufen Sie die Ressource Accounts.Products ab, um den Status eines Produkts anzusehen.
Hier ein Beispiel für eine GET-Anfrage:
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
Alle Antworten von products.get enthalten die folgenden Felder:
creationDate: Das Datum, an dem das Produkt erstellt wurde.lastUpdateDate: Das ist der Zeitpunkt, zu dem das Produkt zuletzt aktualisiert wurde.googleExpirationDate: Das Datum, an dem das Produkt abläuft.destinationStatuses: Die vorgesehenen Ziele für das Produkt.itemLevelIssues: Eine Liste aller Probleme im Zusammenhang mit dem Produkt.
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:
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "288000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
Alle Produktstatus auflisten
Mit products.list können Sie alle Ihre Produkte und deren Status abrufen.
Mit den folgenden Parametern können Sie die Abfrage verfeinern:
pageToken: Wird verwendet, um nachfolgende Ergebnisseiten abzurufen. Jede Seite hat einnextPageToken, mit dem Sie die nächste Seite in der Sequenz abrufen können.maxResults: Die maximale Anzahl von Ergebnissen pro Seite.
Hier ein Beispiel für eine list-Anfrage mit optionalen Abfrageparametern:
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
Hier ist ein Beispiel für eine JSON-Antwort:
{
"nextPageToken": "632fd090c95712c6",
"products": [
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/10355371287",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "28800000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
]
}
Der productstatuses.list-Aufruf kann ohne Bedenken in der Produktionsumgebung getestet werden, da dadurch keine Änderungen an Ihren Daten vorgenommen werden.
Probleme auf Artikelebene
Jedes Problem auf Artikelebene umfasst die folgenden Felder:
code: Der Fehlercode des Problems.severity: Der Schweregrad des Problems.resolution: Informiert darüber, ob der Händler das Problem lösen kann.attribute: Der Attributname, der betroffen ist.reportingContext: Der Berichtskontext, in dem das Problem auftritt.description: Die Beschreibung des Problems.detail: Liefert weitere Informationen zum Problem.documentation: Die URL für die Dokumentation zum Problem.applicableCountries: gibt an, in welchen Ländern das Problem das Produkt betrifft.