Status produk

Anda dapat menggunakan resource Product untuk melihat status mendetail Produk Shopping.

Dengan Content API, Anda dapat mengambil status produk dengan memanggil Metode ProductStatuses.get. Dengan Merchant API, Anda dapat mengambil produk dengan mengambil resource Accounts.Products.

Anda bertanggung jawab untuk mematuhi Belanja iklan dan gratis listingan kami. Iklan Shopping berhak menegakkan kebijakan ini dan menanggapi dengan sesuai jika kami menemukan konten atau perilaku yang melanggar kebijakan tersebut.

Persyaratan

Untuk melihat status produk, Anda harus melakukan tindakan berikut:

  • Daftarkan akun Anda di tujuan.
  • Berikan kode negara yang valid di salah satu opsi berikut:
    • Kolom feedLabel.
    • Kolom shipping.
    • Di tingkat feed.
    • Setelan pengiriman akun Anda.

Mendapatkan status produk

Ambil resource Accounts.Products untuk melihat status produk.

Berikut adalah contoh permintaan GET:

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

Semua respons dari products.get mencakup kolom berikut:

  • creationDate: Tanggal produk dibuat.
  • lastUpdateDate: Terakhir kali produk diperbarui.
  • googleExpirationDate: Tanggal saat masa berlaku produk habis.
  • destinationStatuses: Tujuan yang dimaksudkan untuk produk.
  • itemLevelIssues: Daftar semua masalah yang terkait dengan produk.

Anda hanya melihat kolom itemLevelIssues dalam respons jika produk memiliki tingkat item pada saat permintaan Anda.

Berikut adalah contoh respons 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"
}

Menampilkan daftar semua status produk

Gunakan products.list untuk melihat semua produk Anda dan statusnya.

Anda dapat menggunakan parameter berikut untuk menyaring kueri:

  • pageToken: Digunakan untuk mendapatkan halaman hasil berikutnya. Setiap halaman memiliki nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman berikutnya dalam urutan.
  • maxResults: Jumlah hasil maksimum per halaman.

Berikut adalah contoh permintaan list dengan parameter kueri opsional:

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

Berikut adalah contoh respons 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"
  }
]
}

Panggilan productstatuses.list aman untuk diuji dalam produksi karena tidak membuat perubahan pada data Anda.

Masalah tingkat item

Setiap masalah tingkat item mencakup kolom berikut:

  • code: Kode error masalah.
  • severity: Tingkat keparahan masalah.
  • resolution: Memberi tahu apakah penjual dapat menyelesaikan masalah.
  • attribute: Nama atribut yang terpengaruh.
  • reportingContext: Konteks pelaporan tempat masalah terjadi.
  • description: Deskripsi masalah.
  • detail: Memberikan informasi selengkapnya tentang masalah.
  • documentation: URL untuk dokumentasi tentang masalah.
  • applicableCountries: Menunjukkan di negara mana masalah tersebut memengaruhi Google.