Status produk

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

Lihat masalah produk untuk mengetahui detail masalah umum.

Penjual bertanggung jawab untuk mematuhi Persyaratan iklan dan gratis listingan kami. Kebijakan Privasi Shopping berhak menegakkan kebijakan ini dan merespons dengan sesuai 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 opsi berikut:
    • Kolom feedLabel.
    • Kolom shipping.
    • Di tingkat feed.
    • Setelan pengiriman akun Anda.

Mendapatkan status produk

Gunakan productstatuses.get untuk melihat status suatu produk.

Anda dapat menggunakan parameter destinations di permintaan get dan list guna melihat masalah untuk 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 saat masa berlaku produk habis.
  • productId: ID REST produk.
  • title: Judul produk.
  • link: Link URL produk.
  • destinationStatuses: Status produk di setiap tujuan dan negara.

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

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

Menampilkan daftar 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 akan mengubah data.

Tujuan

Berikut 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:
    • disapproved: Masalah ini mencegah produk yang 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 Google.