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

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

ध्यान दें: Merchant API में, खाते के लेवल की समस्याओं और प्रॉडक्ट की कुल स्थितियों को अलग-अलग किया जाता है. accountstatuses से खाते से जुड़ी समस्याओं पर माइग्रेट करने के लिए, हमारी गाइड भी देखें.

मुख्य अंतर

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

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

अनुरोध का ब्यौरा	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 कर दिया गया है.