Status produk

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

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

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

Persyaratan

Untuk melihat status produk, Anda harus melakukan hal berikut:

  • Daftarkan akun Anda di tujuan.
  • Masukkan 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 habis masa berlaku produk.
  • destinationStatuses: Tujuan yang ditujukan untuk produk.
  • itemLevelIssues: Daftar semua masalah yang terkait dengan produk.

Anda hanya akan melihat kolom itemLevelIssues dalam respons jika produk memiliki masalah 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"
}

Mencantumkan 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 apa pun 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 tersebut.
  • attribute: Nama atribut yang terpengaruh.
  • reportingContext: Konteks pelaporan yang terkait dengan masalah.
  • description: Deskripsi masalah.
  • detail: Memberikan informasi selengkapnya tentang masalah.
  • documentation: URL untuk dokumentasi tentang masalah.
  • applicableCountries: Menunjukkan di negara mana masalah memengaruhi produk.