Satış API'si v1 Kullanım Senaryosu Rehberi
Satış API'si için kullanım senaryoları.
API Sürümü: v1
Satış API'si nedir?
Satışlar için Satış Ortağı API'si (Satış API'si), satıcılara satış performansı bilgileri sağlar. Bu, ayrıntı düzeyine ve alıcı türüne göre ayrılmış belirli bir dönemdeki toplu sipariş metriklerinin döndürülmesiyle gerçekleştirilir. Satış API'si işlemlerinin yanı sıra ilgili veri türleri ve şemaları hakkında daha fazla bilgi için bkz. Satış API'si Başvurusu.
Ön koşullar
Bu eğitici içeriği başarıyla tamamlamak için şunlara ihtiyacınız olacak:
- Adına çağrı yaptığınız satış ortağından yetkilendirme. Daha fazla bilgi için Satış Ortağı API'si uygulamalarını yetkilendirme bölümüne bakın.
- Geliştirici profilinize atanan Fiyatlandırma rolü.
- Uygulamanızın Uygulama kaydı sayfasında seçilen Fiyatlandırma rolü.
Eğitici içerik: Satış performansı bilgilerini alın
Bu bölüm, Satış API'sini kullanarak satış performansı bilgilerini alma sürecinde size yol gösterecektir.
Satış performansı bilgilerini alın
Belirli bir aralıkla ilgili toplu sipariş metriklerini almak için aşağıdaki parametrelerle getOrderMetrics
işlemini çağırın:
Sorgu Parametresi:
Parametre | Açıklama | Zorunlu mu? |
marketplaceIds |
Pazaryeri tanımlayıcısı. Siparişin verildiği pazaryerini belirtir. Yalnızca bir pazaryeri belirtilebilir. Örneğin Tür: < dize > dizi |
Evet |
interval |
A time interval used for selecting order metrics. This takes the form of two dates separated by two hyphens (first date is inclusive; second date is exclusive). Dates are in ISO 8601 format and must represent absolute time (either Z notation or offset notation). Örnek: Tür: dize |
Evet |
granularityTimeZone |
Gün sınırını belirleyen IANA uyumlu bir saat dilimi. Saatten büyük bir ayrıntı düzeyi değeri belirtirken gerekir. Örnek: ABD/Pasifik bölgesinde yaz saatini hesaba katarak gün sınırlarını hesaplamak için ABD/Pasifik kullanın. Tür: dize |
Hayır |
granularity |
Bir zaman birimine göre sipariş metriklerinin gruplandırılmasına ait Örnek: Gün sınırının Type: enum (Granularity) |
Evet |
buyerType |
Sonuçları, Örnek: Yanıtın yalnızca B2B alıcılara yönelik sipariş metriklerini içermesini istiyorsanız Type: enum (BuyerType) |
Hayır |
fulfillmentNetwork |
Sonuçları, Örnek: Yanıtın yalnızca Amazon Lojistik Ağı ile ilgili sipariş metriklerini içermesini istiyorsanız Tür: dize |
Hayır |
firstDayOfWeek |
Örnek: Haftanın Pazar günü başlamasını istiyorsanız Type: enum (FirstDayOfWeek) |
Hayır |
asin |
Sonuçları, belirttiğiniz ASIN'e göre filtreler. Hem Örnek: Yanıtın yalnızca Tür: dize |
Hayır |
sku |
Sonuçları, belirttiğiniz SKU'ya göre filtreler. Hem Örnek: Yanıtın yalnızca Tür: dize |
Hayır |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/sales/v1/orderMetrics?marketplaceIds=&interval=&granularityTimeZone=&granularity=&buyerType=&fulfillmentNetwork=&firstDayOfWeek=&asin=&sku="
Yanıt
Parametre | Açıklama | Zorunlu mu? |
interval |
İstenilen ayrıntı düzeyine göre zaman aralığı (ör. Saat, Gün vb.). Bu, listedeki ilk ya da son aralıksa ve istenen aralık, istenen ayrıntı düzeyine uymuyorsa eksik veriler içerebilir. (ör. Tür: dize |
Evet |
unitCount |
Belirtilen filtrelere göre siparişlerdeki birim sayısı. Tür: tam sayı |
Evet |
orderItemCount |
Belirtilen filtrelere göre sipariş ürünlerinin sayısı. Tür: tam sayı |
Evet |
orderCount |
Belirtilen filtrelere göre sipariş sayısı. Tür: tam sayı |
Evet |
averageUnitPrice |
Belirtilen filtrelere göre bir ürünün ortalama fiyatı. Formül, totalSales/unitCount şeklindedir. Type: Money |
Evet |
totalSales |
Belirtilen filtrelere göre tüm siparişlerdeki toplam sipariş edilen ürün satışları. Type: Money |
Evet |
Yanıt örneği
{
"request": {
"parameters": {
"granularity": {
"value": "Day"
}
}
},
"response": {
"payload": [
{
"interval": "2019-08-01T00:00-07:00--2018-08-02T00:00-07:00",
"unitCount": 1,
"orderItemCount": 1,
"orderCount": 1,
"averageUnitPrice": {
"amount": "22.95",
"currencyCode": "USD"
},
"totalSales": {
"amount": "22.95",
"currencyCode": "USD"
}
},
{
"interval": "2019-08-02T00:00-07:00--2018-08-03T00:00-07:00",
"unitCount": 1,
"orderItemCount": 1,
"orderCount": 1,
"averageUnitPrice": {
"amount": "2.05",
"currencyCode": "USD"
},
"totalSales": {
"amount": "2.05",
"currencyCode": "USD"
}
}
]
}
}
Updated 5 months ago