Merchant Center hesabınızdaki ürünlerin durumuna dair üst düzey bir genel bakış için aggregateProductStatuses.list yöntemini kullanın. Bu sayede, her bir ürünü ayrı ayrı getirmenize gerek kalmadan ürün verilerinizin genel durumunu izleyebilirsiniz. Bu yöntem, sahip olduğunuz toplam ürün sayısını duruma göre (onaylandı, beklemede, reddedildi) dökümüyle birlikte sağlar ve ürünlerinizi etkileyen sorunları listeler.
Dikkat edilmesi gereken noktalar
aggregateProductStatuses.list yöntemini kullanırken dikkat edilmesi gereken özel noktalar vardır.
- Veri kullanılabilirliği: Bir ürünün eklenmesi veya güncellenmesi ile durumunun
aggregateProductStatusesyanıtına yansıtılması arasında 30 dakikadan uzun bir gecikme olabilir. - Sorun tutarlılığı:
aggregateProductStatuses.listyöntemi tarafından döndürülen sorun başlıkları ve açıklamaları, Products API tarafından döndürülen sorunlarla tutarlı olacak şekilde tasarlanmıştır. Ancak bu açıklamalar, Merchant Center kullanıcı arayüzünde gösterilen sorun açıklamalarından farklı olabilir.
Tüm ürün durumlarına genel bakış
Bu örnekte, AggregateProductStatus kaynaklarının listesinin nasıl alınacağı gösterilmektedir.
Her kaynak, belirli bir hedef ve ülke kombinasyonu için ürünlerin durumunu temsil eder. aggregateProductStatuses.list yöntemini herhangi bir parametre olmadan çağırdığınızda hesabınız için kullanılabilir tüm durumlar döndürülür.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses
Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:
{
"aggregateProductStatuses": [
{
"name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
"reportingContext": "SHOPPING_ADS",
"countryCode": "US",
"statistics": {
"approvedCount": "1500",
"pendingCount": "50",
"disapprovedCount": "25"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU003"
]
}
]
},
{
"name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/FREE_LISTINGS~US",
"reportingContext": "FREE_LISTINGS",
"countryCode": "US",
"statistics": {
"approvedCount": "1510",
"pendingCount": "50",
"disapprovedCount": "15"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
}
]
}
]
}
Belirli bir ülke ve hedef için ürün durumlarını alma
aggregateProductStatuses.list yöntemiyle filter sorgu parametresini kullanarak sonuçları filtreleyip belirli bir ülke ve hedef için durumu görebilirsiniz. Örneğin:
country = "US" AND reportingContext = "SHOPPING_ADS".
Filtre söz dizimi hakkında daha ayrıntılı bilgi için Filtre söz dizimi başlıklı makaleyi inceleyin.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"
Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:
{
"aggregateProductStatuses": [
{
"name": "accounts/{ACCOUNT_ID}/aggregateProductStatuses/SHOPPING_ADS~US",
"reportingContext": "SHOPPING_ADS",
"countryCode": "US",
"statistics": {
"approvedCount": "1500",
"pendingCount": "50",
"disapprovedCount": "25"
},
"issues": [
{
"issueType": "missing_image",
"severity": "ERROR",
"numProducts": "15",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU001",
"accounts/{ACCOUNT_ID}/products/en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/{ACCOUNT_ID}/products/en~US~SKU003"
]
}
]
}
]
}