Status produk

Anda dapat menggunakan referensi productstatuses untuk melihat status mendetail produk Shopping Anda.

Lihat masalah produk untuk mengetahui detail tentang masalah umum.

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

Persyaratan

Anda harus melakukan tindakan berikut untuk melihat status produk:

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

Mendapatkan status produk

Gunakan productstatuses.get untuk melihat status produk.

Anda dapat menggunakan parameter destinations di permintaan get dan list untuk melihat masalah tujuan tertentu. Jika Anda tidak menentukan tujuan, masalah dari semua tujuan yang memenuhi syarat akan ditampilkan.

Berikut adalah contoh permintaan get, dengan parameter kueri opsional:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

Semua respons dari productstatuses.get mencakup kolom berikut:

  • kind: Nilai selalu content#productStatus.
  • creationDate: Tanggal produk dibuat.
  • lastUpdateDate: Terakhir kali produk diperbarui.
  • googleExpirationDate: Tanggal habis masa berlaku produk.
  • productId: ID REST produk.
  • title: Judul produk.
  • link: Link URL produk.
  • destinationStatuses: Status produk di setiap tujuan dan negara.

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

Berikut adalah contoh respons JSON:

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

Mencantumkan semua status produk

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

Anda dapat menggunakan parameter berikut untuk menyaring kueri:

  • destinations: Tujuan untuk melihat statusnya.
  • 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://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

Berikut adalah contoh respons JSON:

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

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

Tujuan

Berikut adalah tujuan yang dapat Anda gunakan untuk produk Shopping:

  • shopping ads: Produk Iklan Shopping.
  • ShoppingActions: Produk Beli dengan Google.
  • surfaces across google: Produk listingan gratis.
  • shopping: Produk Iklan Inventaris Lokal.

Masalah tingkat item

Setiap masalah tingkat item mencakup kolom berikut:

  • code: Kode error yang digunakan untuk menentukan masalah.
  • servability: Menunjukkan apakah produk ditampilkan sebagai:
      atau tidak
    • disapproved: Masalah ini mencegah produk ditampilkan.
    • unaffected: Produk masih ditampilkan.
  • resolution: Memberi tahu apakah penjual dapat menyelesaikan masalah.
  • attributeName: Nama atribut yang terpengaruh.
  • destination: Tujuan yang terpengaruh.
  • description: Deskripsi produk.
  • detail: Memberikan informasi selengkapnya tentang masalah.
  • documentation: Menunjukkan tempat menemukan dokumentasi tentang masalah.
  • applicableCountries: Menunjukkan di negara mana masalah tersebut memengaruhi produk.