अपने 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/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU003"
]
}
]
},
{
"name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/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/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU003"
]
}
]
}
]
}