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.
- Kolom
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 memilikinextPageToken
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.