खाते के स्टेटस को एग्रीगेट किए गए प्रॉडक्ट के स्टेटस में माइग्रेट करना

प्रॉडक्ट के एग्रीगेट किए गए आंकड़ों और समस्याओं को वापस पाने का तरीका बदल गया है. Content API for Shopping के accountstatuses रिसॉर्स में पहले उपलब्ध फ़ंक्शन, अब Merchant API में अलग-अलग रिसॉर्स में बांट दिए गए हैं. इस गाइड में, नए aggregateProductStatuses रिसॉर्स का इस्तेमाल करने के लिए, इंटिग्रेशन को माइग्रेट करने का तरीका बताया गया है.

मुख्य अंतर

Content API for Shopping और Merchant API में, प्रॉडक्ट की स्थिति बताने वाली सुविधाओं के बीच मुख्य अंतर यहां दिए गए हैं:

  • खास संसाधन: Content API for Shopping के accountstatuses संसाधन को अब अलग-अलग हिस्सों में बांट दिया गया है. Merchant API में, खाते के लेवल की समस्याएं accountissues रिसॉर्स के ज़रिए उपलब्ध होती हैं. वहीं, प्रॉडक्ट के एग्रीगेट किए गए आंकड़े और सामान के लेवल की समस्याएं, नए aggregateProductStatuses रिसॉर्स के ज़रिए उपलब्ध होती हैं.
  • नया संसाधन स्ट्रक्चर: AggregateProductStatus एक नया संसाधन है, जो रिपोर्टिंग कॉन्टेक्स्ट और देश के खास कॉम्बिनेशन के आंकड़े और समस्याएं दिखाता है.
  • फ़िल्टर करने का तरीका: डेटा चुनने के लिए, destinations जैसे क्वेरी पैरामीटर इस्तेमाल करने के बजाय, Merchant API list तरीके का इस्तेमाल करता है. इसमें filter स्ट्रिंग का इस्तेमाल करके, रिपोर्टिंग के खास कॉन्टेक्स्ट और देशों के लिए क्वेरी की जाती है.
  • चैनल फ़ील्ड को हटाना: channel फ़ील्ड का इस्तेमाल अब नहीं किया जाता. यह जानकारी अब reportingContext का हिस्सा है.

अनुरोध

Merchant API, एग्रीगेट किए गए प्रॉडक्ट स्टेटस को वापस पाने के लिए, filter पैरामीटर के साथ GET अनुरोध का इस्तेमाल करता है. फ़िल्टर के सिंटैक्स के बारे में ज़्यादा जानकारी के लिए, फ़िल्टर का सिंटैक्स देखें.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

अनुरोध के यूआरएल का फ़ॉर्मैट

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
प्रॉडक्ट के आंकड़े और समस्याएं देखना GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

आइडेंटिफ़ायर

नए स्ट्रक्चर के हिसाब से, संसाधनों की पहचान करने का तरीका बदल गया है.

आइडेंटिफ़ायर का फ़ॉर्मैट

आइडेंटिफ़ायर की जानकारी Shopping के लिए Content API 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 रिसॉर्स में अपडेट और फिर से व्यवस्थित किया गया है.

Shopping के लिए Content API 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 कर दिया गया है.
पीछे जाएं
Migrate accountstatuses to Account Issues
आगे बढ़ें
Migrate user and access management