Produktstatus

Sie können die Ressource productstatuses verwenden um den detaillierten Status Ihrer Shopping-Produkte zu sehen.

Produktprobleme finden Sie weitere Informationen zu häufigen Problemen.

Die Händler sind für die Einhaltung der Richtlinien für Shopping-Anzeigen anzeigen und kostenlos Richtlinien für Einträge. Google 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: <ph type="x-smartling-placeholder">
      </ph>
    • Das Feld feedLabel.
    • Das Feld shipping.
    • Auf Feedebene.
    • Die Versandeinstellungen Ihres Kontos.

Status eines Produkts abrufen

Verwenden Sie productstatuses.get, um die Status eines Produkts.

Sie können den Parameter destinations in get- und list-Anfragen verwenden, um Probleme für ein bestimmtes Ziel aufzurufen. Wenn Sie kein Ziel, werden Probleme von allen infrage kommenden 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 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 in den einzelnen Zielorten und Ländern.

Sie sehen nur die itemLevelIssues in der Antwort eingeben, wenn das Produkt zum Zeitpunkt der Aktualisierung 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 ein nextPageToken, 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 productstatuses.list-Aufruf kann ohne Bedenken in der Produktion getestet werden da keine Änderungen an Ihren 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äge
  • shopping: Produkte für Anzeigen für lokales Inventar.

Probleme auf Artikelebene

Jedes Problem auf Artikelebene umfasst die folgenden Felder:

  • code: Der Fehlercode, mit dem das Problem ermittelt wird.
  • servability: Gibt an, ob das Produkt wie folgt angezeigt wird: <ph type="x-smartling-placeholder">
      </ph>
    • 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 Produkt.