Ta strona została przetłumaczona przez Cloud Translation API.

Stany produktów

Aby wyświetlić szczegółowy stan swojego konta, możesz skorzystać z materiału Product. Produkty w ramach Zakupów.

Za pomocą Content API możesz pobrać stan produktu, wywołując metodę Metoda ProductStatuses.get. Za pomocą interfejsu Merchant API możesz pobrać produkt stanu, pobierając zasób Accounts.Products.

Ponosisz odpowiedzialność za przestrzeganie zasad Zakupów Google reklam i bezpłatnej informacji o produktach. Reklamy produktowe zastrzega sobie prawo do egzekwowania tych zasad i podejmowania odpowiednich działań, jeśli znaleźć treści lub zachowań, które naruszają te zasady.

Wymagania

Aby zobaczyć stany produktów:

Zarejestruj konto w miejscu docelowym.
Podaj prawidłowy kod kraju w jednym z tych miejsc:
- Pole feedLabel.
- Pole shipping.
- Na poziomie pliku danych.
- Ustawienia dostawy na Twoim koncie.

Sprawdzanie stanu produktu

Pobierz zasób Accounts.Products, aby wyświetlić stan usługi.

Oto przykładowe żądanie GET:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

Wszystkie odpowiedzi z formularza products.get zawierają te pola:

creationDate: data utworzenia produktu.
lastUpdateDate: czas ostatniej aktualizacji produktu.
googleExpirationDate: data wygaśnięcia ważności produktu.
destinationStatuses: zamierzone miejsca docelowe produktu.
itemLevelIssues: lista wszystkich problemów związanych z produktem.

Pole itemLevelIssues jest widoczne w odpowiedzi tylko wtedy, gdy produkt ma na poziomie produktu.

Przykładowa odpowiedź JSON:

{
"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"
}

Wyświetl wszystkie stany produktów

Użyj products.list, aby wyświetlić wszystkie produkty i ich stan.

Aby zawęzić zapytanie, możesz użyć tych parametrów:

pageToken: umożliwia wyświetlenie kolejnych stron z wynikami. Każda strona ma nextPageToken służy do przejścia na następną stronę w sekwencji.
maxResults: maksymalna liczba wyników na stronie.

Oto przykładowe żądanie list z opcjonalnymi parametrami zapytania:

GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

Przykładowa odpowiedź JSON:

{
"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"
  }
]
}

Wywołanie productstatuses.list można bezpiecznie przetestować w środowisku produkcyjnym, ponieważ nie jest wprowadzić zmiany w danych.

Problemy na poziomie produktu

Każdy problem na poziomie produktu obejmuje te pola:

code: kod błędu problemu.
severity: wagę problemu.
resolution: informuje, czy sprzedawca może rozwiązać problem.
attribute: nazwa atrybutu, którego dotyczy problem.
reportingContext: kontekst raportowania, którego dotyczy problem.
description: opis problemu.
detail: podaje więcej informacji o problemie.
documentation: adres URL dokumentacji dotyczącej problemu.
applicableCountries: wskazuje kraje, w których występuje problem. usługi.