Merchant Center खाते में मौजूद प्रॉडक्ट की स्थिति की खास जानकारी पाने के लिए,
aggregateProductStatuses.list
तरीके का इस्तेमाल किया जा सकता है. यह तरीका, प्रॉडक्ट डेटा की पूरी जानकारी की निगरानी करने के लिए काम का है. इससे आपको हर प्रॉडक्ट की जानकारी अलग-अलग फ़ेच करने की ज़रूरत नहीं पड़ती. इस तरीके से, आपको अपने प्रॉडक्ट की कुल संख्या मिलती है. इसे स्टेटस के हिसाब से बांटा जाता है. जैसे, स्वीकार किए गए, समीक्षा के लिए भेजे गए, और अस्वीकार किए गए. साथ ही, इससे उन समस्याओं की सूची भी मिलती है जो आपके प्रॉडक्ट पर असर डाल रही हैं.
ध्यान देने वाली खास बातें
aggregateProductStatuses.list तरीके का इस्तेमाल करते समय, कुछ बातों का ध्यान रखना ज़रूरी है.
- डेटा की उपलब्धता: किसी प्रॉडक्ट को जोड़ने या अपडेट करने और
aggregateProductStatusesके जवाब में उसका स्टेटस दिखने के बीच, 30 मिनट से ज़्यादा का समय लग सकता है. - समस्या की जानकारी में एकरूपता:
aggregateProductStatuses.listतरीके से मिलने वाले, समस्या के टाइटल और ब्यौरे, प्रॉडक्ट एपीआई से मिलने वाली समस्याओं के मुताबिक होने चाहिए. हालांकि, ये 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/online~en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/online~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/online~en~US~SKU001",
"accounts/{ACCOUNT_ID}/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/{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/online~en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
]
}
]
}
]
}