खाते के स्टेटस को एग्रीगेट किए गए प्रॉडक्ट के स्टेटस में माइग्रेट करना
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
प्रॉडक्ट के एग्रीगेट किए गए आंकड़ों और समस्याओं को पाने का तरीका बदल गया है. 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 कर दिया गया है.
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2025-08-08 (UTC) को अपडेट किया गया."],[],[],null,["# Migrate accountstatuses to Aggregate Product Statuses\n\nThe way you retrieve aggregated product statistics and issues has changed. The\nfunctionality previously available in the `accountstatuses` resource in the\nContent API for Shopping is now split into dedicated resources in the Merchant\nAPI. This guide explains how to migrate your integration to use the new\n[`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses)\nresource.\n\n**Note** : In Merchant API, account-level issues and aggregate product statuses\nare split. Also review our guide to migrate from `accountstatuses` to\n[account issues](/merchant/api/guides/compatibility/migrate-view-issues).\n\nKey differences\n---------------\n\nHere are the key differences between the product status features in Content\nAPI for Shopping and Merchant API:\n\n- **Dedicated resources** : The `accountstatuses` resource from Content API for Shopping is now split. In Merchant API, account-level issues are available through the [`accountissues`](/merchant/api/reference/rest/accounts_v1/accounts.issues) resource, while aggregated product statistics and item-level issues are available through the new [`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses) resource.\n- **New resource structure** : `AggregateProductStatus` is a new resource that represents the statistics and issues for a specific combination of a reporting context and a country.\n- **Filtering mechanism** : Instead of using query parameters like `destinations` to select data, Merchant API uses a `list` method with a `filter` string to query for specific reporting contexts and countries.\n- **Channel field removal** : The `channel` field is no longer used. This information is now implicitly part of the `reportingContext`.\n\nRequests\n--------\n\nMerchant API uses a `GET` request with a `filter` parameter to retrieve\naggregated product statuses.\n\n`GET\nhttps://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses`\n\n### Request URL format\n\n| Request description | Content API for Shopping | Merchant API |\n|-----------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------|\n| Get product statistics and issues | `GET /content/v2.1/{merchantId}/accountstatuses/{accountId}` | `GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses` |\n\nIdentifiers\n-----------\n\nThe way resources are identified has changed to support the new structure.\n\n### Identifier format\n\n| Identifier description | Content API for Shopping | Merchant API |\n|------------------------|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Resource Identifier | The resource was identified by `accountId`. Specific data slices were selected with query parameters. | The resource name uniquely identifies the data for a specific reporting context and country: `accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}`. |\n\nMethods\n-------\n\nThe method for retrieving product statuses has been updated to a `list` method\nthat supports filtering.\n\n| Content API for Shopping method | Merchant API method | Availability \\& notes |\n|---------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountstatuses.get` | `aggregateProductStatuses.list` | The `accountstatuses.get` method returned a single resource containing all product statistics. The new `aggregateProductStatuses.list` method returns a list of resources, one for each reporting context and country combination. Use the `filter` parameter to retrieve specific data. For account-level issues, use `accountissues.list`. |\n\nDetailed field changes\n----------------------\n\nThe fields for product statistics and issues have been updated and restructured\nin the new `AggregateProductStatus` resource.\n\n| Content API for Shopping | Merchant API | Description |\n|---------------------------------|---------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `products` | `aggregate_product_statuses` | The `products` array is replaced by the `aggregate_product_statuses` repeated field in the list response. |\n| `destination` | `reporting_context` | The `destination` field is replaced by `reporting_context`, which specifies the program context for the stats. |\n| `channel` | (no equivalent field) | The `channel` field is removed. This information is now part of the `reporting_context`. |\n| `statistics` | `stats` | The `statistics` object is renamed to `stats`. Field names within are converted to snake_case, for example, `activeCount` is now `active_count`. |\n| `itemLevelIssues.servability` | `item_level_issues.severity` | The `servability` enum is replaced by the `severity` enum to describe the impact of an issue. |\n| `itemLevelIssues.attributeName` | `item_level_issues.attribute` | The field `attributeName` is renamed to `attribute`. |\n| `itemLevelIssues.documentation` | `item_level_issues.documentation_uri` | The field `documentation` is renamed to `documentation_uri`. |\n| `itemLevelIssues.numItems` | `item_level_issues.product_count` | The field `numItems` is renamed to `product_count`. |"]]
