Merchant Center hesabınızdaki ürünlerin durumu hakkında genel bir bakış elde etmek için aggregateProductStatuses.list
yöntemini kullanabilirsiniz. Bu, her bir ürünü getirmenize gerek kalmadan ürün verilerinizin genel durumunu izlemek için kullanışlıdır. Bu yöntem, sahip olduğunuz ürünlerin toplam sayısını durumlarına (onaylandı, beklemede, onaylanmadı) göre ayrı ayrı gösterir 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
aggregateProductStatuses
yanıtına yansıması arasında 30 dakikadan uzun bir gecikme olabilir. - Sorun tutarlılığı:
aggregateProductStatuses.list
yöntemi tarafından döndürülen sorun başlıkları ve açıklamalarının, Products API tarafından döndürülen sorunlarla tutarlı olması amaçlanmaktadı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, hedef ve ülke kombinasyonuna göre ürünlerin durumunu gösterir. Arama
aggregateProductStatuses.list
parametresiz olarak yapıldığında 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/12345/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/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU003"
]
}
]
},
{
"name": "accounts/12345/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/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~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ı belirli bir ülke ve hedefteki durumu görecek şekilde filtreleyebilirsiniz. Örneğin: country = "US" AND reportingContext = "SHOPPING_ADS"
.
Daha fazla 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/12345/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/12345/products/online~en~US~SKU001",
"accounts/12345/products/online~en~US~SKU002"
]
},
{
"issueType": "invalid_price",
"severity": "CRITICAL",
"numProducts": "10",
"sampleProducts": [
"accounts/12345/products/online~en~US~SKU003"
]
}
]
}
]
}