Diese Seite wurde von der Cloud Translation API übersetzt.

Produktstatus

Mit der Ressource Product können Sie den detaillierten Status Ihrer Shopping-Produkte.

Mit der Content API können Sie den Produktstatus abrufen, indem Sie die Methode ProductStatuses.get-Methode. Mit der Merchant API können Sie das Produkt Status durch Abrufen der Accounts.Products-Ressource.

Sie sind für die Einhaltung der Richtlinien für Shopping-Anzeigen anzeigen und kostenlos Richtlinien für Einträge. Shopping-Anzeigen behält sich das Recht vor, diese Richtlinien durchzusetzen und angemessen zu reagieren, wenn Inhalte oder Verhaltensweisen zu finden, 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">
- Das Feld feedLabel.
- Das Feld shipping.
- Auf Feedebene.
- Die Versandeinstellungen Ihres Kontos.

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: 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 Artikelebene zum Zeitpunkt Ihrer Anfrage.

Hier sehen Sie 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

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

Sie können die folgenden Parameter verwenden, um Ihre Abfrage zu verfeinern:

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://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

Hier sehen Sie 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 Produktion getestet werden, Ihre Daten ändern.

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 betroffene Attributname.
reportingContext: Der Berichtskontext, auf den sich das Problem bezieht.
description: Die Beschreibung des Problems.
detail: Liefert weitere Informationen zum Problem.
documentation: Die URL zur Dokumentation zum Problem.
applicableCountries: gibt an, in welchen Ländern das Problem Produkt.