Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Toplu ürün istatistiklerini ve sorunlarını alma şekliniz değişti. Daha önce Content API for Shopping'deki accountstatuses kaynağında bulunan işlevler artık Merchant API'de özel kaynaklara ayrıldı. Bu kılavuzda, entegrasyonunuzu yeni aggregateProductStatuses kaynağını kullanacak şekilde nasıl taşıyacağınız açıklanmaktadır.
Not: Merchant API'de hesap düzeyindeki sorunlar ve toplu ürün durumları ayrılır. Ayrıca, accountstatuses'dan hesap sorunlarına geçişle ilgili kılavuzumuzu da inceleyin.
Temel farklılıklar
Content API for Shopping ve Merchant API'deki ürün durumu özellikleri arasındaki temel farklar şunlardır:
Özel kaynaklar: Content API for Shopping'deki accountstatuses kaynağı artık bölünmüş durumda. Merchant API'de hesap düzeyindeki sorunlar accountissues kaynağı üzerinden, toplu ürün istatistikleri ve öğe düzeyindeki sorunlar ise yeni aggregateProductStatuses kaynağı üzerinden kullanılabilir.
Yeni kaynak yapısı: AggregateProductStatus, bir raporlama bağlamı ve ülkenin belirli bir kombinasyonuna ait istatistikleri ve sorunları temsil eden yeni bir kaynaktır.
Filtreleme mekanizması: Merchant API, veri seçmek için destinations gibi sorgu parametrelerini kullanmak yerine belirli raporlama bağlamlarını ve ülkeleri sorgulamak için filter dizesi içeren bir list yöntemi kullanır.
Kanal alanı kaldırıldı: channel alanı artık kullanılmıyor. Bu bilgiler artık reportingContext'nın bir parçasıdır.
İstekler
Merchant API, toplu ürün durumlarını almak için GET isteğiyle birlikte filter parametresini kullanır.
GET
https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
İstek URL'si biçimi
İstek açıklaması
Content API for Shopping
Merchant API
Ürün istatistiklerini ve sorunlarını alma
GET /content/v2.1/{merchantId}/accountstatuses/{accountId}
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses
Tanımlayıcılar
Kaynakların tanımlanma şekli, yeni yapıyı destekleyecek şekilde değiştirildi.
Tanımlayıcı biçimi
Tanımlayıcı açıklaması
Content API for Shopping
Merchant API
Kaynak tanımlayıcısı
Kaynak, accountId tarafından tanımlandı. Sorgu parametreleriyle belirli veri dilimleri seçildi.
Kaynak adı, belirli bir raporlama bağlamı ve ülke için verileri benzersiz şekilde tanımlar: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.
Yöntemler
Ürün durumlarını alma yöntemi, filtrelemeyi destekleyen bir list yöntemiyle güncellendi.
Content API for Shopping yöntemi
Merchant API yöntemi
Kullanılabilirlik ve notlar
accountstatuses.get
aggregateProductStatuses.list
accountstatuses.get yöntemi, tüm ürün istatistiklerini içeren tek bir kaynak döndürdü. Yeni aggregateProductStatuses.list yöntemi, her raporlama bağlamı ve ülke kombinasyonu için bir kaynak olmak üzere kaynak listesi döndürür. Belirli verileri almak için filter parametresini kullanın. Hesap düzeyindeki sorunlar için accountissues.list simgesini kullanın.
Ayrıntılı alan değişiklikleri
Ürün istatistikleri ve sorunlarıyla ilgili alanlar, yeni AggregateProductStatus kaynağında güncellendi ve yeniden yapılandırıldı.
Content API for Shopping
Merchant API
Açıklama
products
aggregate_product_statuses
products dizisinin yerini liste yanıtındaki aggregate_product_statuses tekrarlanan alanı alır.
destination
reporting_context
destination alanı, istatistiklerin program bağlamını belirten reporting_context ile değiştirilir.
channel
(eşdeğer alan yok)
channel alanı kaldırılır. Bu bilgiler artık reporting_context'nın bir parçasıdır.
statistics
stats
statistics nesnesi stats olarak yeniden adlandırılır. İçindeki alan adları snake_case'e dönüştürülür. Örneğin, activeCount artık active_count olur.
itemLevelIssues.servability
item_level_issues.severity
Bir sorunun etkisini açıklamak için servability enum'ı yerine severity enum'ı kullanılır.
itemLevelIssues.attributeName
item_level_issues.attribute
attributeName alanı, attribute olarak yeniden adlandırıldı.
itemLevelIssues.documentation
item_level_issues.documentation_uri
documentation alanı, documentation_uri olarak yeniden adlandırıldı.
itemLevelIssues.numItems
item_level_issues.product_count
numItems alanı, product_count olarak yeniden adlandırıldı.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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`. |"]]
