प्रॉडक्ट के एग्रीगेट किए गए आंकड़ों और समस्याओं को पाने का तरीका बदल गया है. Content API for Shopping में accountstatuses संसाधन में पहले उपलब्ध फ़ंक्शनैलिटी अब Merchant API में अलग-अलग संसाधनों में बांटी गई है. इस गाइड में, नए aggregateProductStatuses
संसाधन का इस्तेमाल करने के लिए, अपने इंटिग्रेशन को माइग्रेट करने का तरीका बताया गया है.
अहम अंतर
यहां Content API for Shopping और Merchant API में, प्रॉडक्ट के स्टेटस की सुविधाओं के बीच अहम अंतर दिए गए हैं:
- अलग-अलग संसाधन: Content API
for Shopping में मौजूद
accountstatusesसंसाधन को अब अलग-अलग हिस्सों में बांटा गया है. Merchant API में, खाते के लेवल की समस्याएंaccountissuesसंसाधन के ज़रिए उपलब्ध हैं. वहीं, एग्रीगेट किए गए प्रॉडक्ट के आंकड़े और आइटम के लेवल की समस्याएं नएaggregateProductStatusesसंसाधन के ज़रिए उपलब्ध हैं. - संसाधन का नया स्ट्रक्चर:
AggregateProductStatusएक नया संसाधन है. यह रिपोर्टिंग कॉन्टेक्स्ट और देश के किसी खास कॉम्बिनेशन के लिए, आंकड़े और समस्याएं दिखाता है. - फ़िल्टर करने का तरीका: Merchant API में, डेटा चुनने के लिए क्वेरी पैरामीटर जैसे कि
destinationsका इस्तेमाल करने के बजाय,listतरीके का इस्तेमाल किया जाता है. इसमें, खास रिपोर्टिंग कॉन्टेक्स्ट और देशों के लिए क्वेरी करने के लिए,filterस्ट्रिंग का इस्तेमाल किया जाता है. - चैनल फ़ील्ड हटाना:
channelफ़ील्ड का इस्तेमाल अब नहीं किया जाता. यह जानकारी अबreportingContextका हिस्सा है.
अनुरोध
Merchant API में, एग्रीगेट किए गए प्रॉडक्ट के स्टेटस पाने के लिए, filter पैरामीटर के साथ GET अनुरोध का इस्तेमाल किया जाता है.
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
अनुरोध के यूआरएल का फ़ॉर्मैट
| अनुरोध का ब्यौरा | Content API for Shopping | Merchant API |
|---|---|---|
| प्रॉडक्ट के आंकड़े और समस्याएं पाना | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
आइडेंटिफ़ायर
नए स्ट्रक्चर के साथ काम करने के लिए, संसाधनों की पहचान करने का तरीका बदल गया है.
आइडेंटिफ़ायर का फ़ॉर्मैट
| आइडेंटिफ़ायर का ब्यौरा | Content API for Shopping | Merchant API |
|---|---|---|
| संसाधन का आइडेंटिफ़ायर | संसाधन की पहचान accountId से की गई. क्वेरी पैरामीटर की मदद से, डेटा के खास स्लाइस चुने गए. |
संसाधन का नाम, रिपोर्टिंग कॉन्टेक्स्ट और देश के लिए डेटा की यूनीक पहचान करता है: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}. |
तरीके
प्रॉडक्ट के स्टेटस पाने के तरीके को अपडेट किया गया है. अब list तरीके का इस्तेमाल किया जाता है, जिसमें फ़िल्टर करने की सुविधा भी उपलब्ध है.
| Content API for Shopping का तरीका | Merchant API का तरीका | उपलब्धता और अहम जानकारी |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
accountstatuses.get तरीके से, एक ऐसा संसाधन मिलता था जिसमें प्रॉडक्ट के सभी आंकड़े शामिल होते थे. नए aggregateProductStatuses.list तरीके से, संसाधनों की सूची मिलती है. इसमें हर रिपोर्टिंग कॉन्टेक्स्ट और देश के कॉम्बिनेशन के लिए एक संसाधन होता है. खास डेटा पाने के लिए, filter पैरामीटर का इस्तेमाल करें. खाते के लेवल की समस्याओं के लिए, accountissues.list का इस्तेमाल करें. |
फ़ील्ड में हुए बदलावों के बारे में ज़्यादा जानकारी
प्रॉडक्ट के आंकड़ों और समस्याओं के लिए फ़ील्ड को अपडेट किया गया है. साथ ही, नए AggregateProductStatus संसाधन में इन्हें फिर से स्ट्रक्चर किया गया है.
| Content API for Shopping | Merchant API | ब्यौरा |
|---|---|---|
products |
aggregate_product_statuses |
सूची के जवाब में, products कलेक्शन की जगह aggregate_product_statuses दोहराया गया फ़ील्ड इस्तेमाल किया जाता है. |
destination |
reporting_context |
destination फ़ील्ड की जगह reporting_context का इस्तेमाल किया जाता है. इससे आंकड़ों के लिए, प्रोग्राम के कॉन्टेक्स्ट के बारे में पता चलता है. |
channel |
(कोई मिलता-जुलता फ़ील्ड नहीं है) | channel फ़ील्ड हटा दिया गया है. यह जानकारी अब reporting_context का हिस्सा है. |
statistics |
stats |
statistics ऑब्जेक्ट का नाम बदलकर stats कर दिया गया है. इसके अंदर मौजूद फ़ील्ड के नामों को snake_case में बदल दिया गया है. उदाहरण के लिए, activeCount अब active_count है. |
itemLevelIssues.servability |
item_level_issues.severity |
किसी समस्या के असर के बारे में बताने के लिए, servability enum की जगह severity enum का इस्तेमाल किया जाता है. |
itemLevelIssues.attributeName |
item_level_issues.attribute |
फ़ील्ड attributeName का नाम बदलकर attribute कर दिया गया है. |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
`documentation` फ़ील्ड का नाम बदलकर `documentation_uri` कर दिया गया है. |
itemLevelIssues.numItems |
item_level_issues.product_count |
numItems फ़ील्ड का नाम बदलकर product_count कर दिया गया है. |