अपने Merchant Center खाते में मौजूद प्रॉडक्ट की स्थिति के बारे में खास जानकारी पाने के लिए, aggregateProductStatuses.list
तरीके का इस्तेमाल किया जा सकता है. यह आपके प्रॉडक्ट डेटा की परफ़ॉर्मेंस को मॉनिटर करने के लिए फ़ायदेमंद है. इसके लिए, आपको हर प्रॉडक्ट का डेटा फ़ेच करने की ज़रूरत नहीं होती. इस तरीके से, आपको अपने सभी प्रॉडक्ट की कुल संख्या के बारे में पता चलता है. साथ ही, यह भी पता चलता है कि कितने प्रॉडक्ट स्वीकार किए गए हैं, कितने को मंज़ूरी मिलना बाकी है, और कितने अस्वीकार किए गए हैं. इसके अलावा, इसमें उन सभी समस्याओं की सूची भी दी जाती है जिनका असर आपके प्रॉडक्ट पर पड़ रहा है.
ध्यान देने वाली खास बातें
aggregateProductStatuses.list
तरीके का इस्तेमाल करते समय, कुछ खास बातों का ध्यान रखना होता है.
- डेटा की उपलब्धता: किसी प्रॉडक्ट को शामिल करने या अपडेट करने और
aggregateProductStatuses
रिस्पॉन्स में उसका स्टेटस दिखने के बीच, 30 मिनट से ज़्यादा का समय लग सकता है. - समस्या की एक जैसी जानकारी:
aggregateProductStatuses.list
तरीके से मिली समस्याओं के टाइटल और ब्यौरे, Products API से मिली समस्याओं के टाइटल और ब्यौरे से मेल खाने चाहिए. हालांकि, ये Merchant Center के यूज़र इंटरफ़ेस में दिखने वाली समस्या की जानकारी से अलग हो सकती हैं.
प्रॉडक्ट की सभी स्थितियों की खास जानकारी पाना
इस उदाहरण में, AggregateProductStatus
संसाधनों की सूची वापस पाने का तरीका दिखाया गया है.
हर संसाधन, डेस्टिनेशन और देश के किसी खास कॉम्बिनेशन के लिए प्रॉडक्ट की स्थिति दिखाता है. कॉलिंग
aggregateProductStatuses.list
बिना किसी पैरामीटर के, आपके खाते के लिए उपलब्ध सभी स्टेटस दिखाती है.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses
यहां कॉल के पूरा होने पर मिलने वाले जवाब का एक उदाहरण दिया गया है:
{
"aggregateProductStatuses": [
{
"name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
"reportingContext": "SHOPPING_ADS",
"countryCode": "US",
"statistics": {
"approvedCount": "1500",
"pendingCount": "50",
"disapprovedCount": "25"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU003"
]
}
]
},
{
"name": "accounts/12345/aggregateProductStatuses/FREE_LISTINGS~US",
"reportingContext": "FREE_LISTINGS",
"countryCode": "US",
"statistics": {
"approvedCount": "1510",
"pendingCount": "50",
"disapprovedCount": "15"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~en~US~SKU002"
]
}
]
}
]
}
किसी देश और डेस्टिनेशन के लिए प्रॉडक्ट की स्थितियां पाना
aggregateProductStatuses.list
तरीके के साथ filter
क्वेरी पैरामीटर का इस्तेमाल करके, किसी देश और डेस्टिनेशन के लिए स्थिति देखी जा सकती है. इसके लिए, नतीजों को फ़िल्टर करें. उदाहरण के लिए: country = "US" AND reportingContext = "SHOPPING_ADS"
.
ज़्यादा जानकारी के लिए, फ़िल्टर सिंटैक्स देखें.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"
यहां कॉल के पूरा होने पर मिलने वाले जवाब का एक उदाहरण दिया गया है:
{
"aggregateProductStatuses": [
{
"name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
"reportingContext": "SHOPPING_ADS",
"countryCode": "US",
"statistics": {
"approvedCount": "1500",
"pendingCount": "50",
"disapprovedCount": "25"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU003"
]
}
]
}
]
}