REST Resource: orders

Kaynak: Sipariş

Order kaynağı, Google Play'de yapılan bir işlemle ilgili kapsamlı bilgileri kapsar. Siparişin kendisi, satın alınan ürünler ve siparişle ilgili etkinliklerin geçmişi hakkında ayrıntılar sağlayan çeşitli özellikler içerir.

Orders API'leri, Google Play ekosistemindeki sipariş verilerinize gerçek zamanlı erişim sağlar. Hem tek seferlik hem de yinelenen siparişlerle ilgili ayrıntılı bilgileri ve meta verileri (ör. ücretler, vergiler ve geri ödemeler gibi işlem ayrıntılarının yanı sıra abonelikler için fiyatlandırma aşamaları gibi meta veriler) alabilirsiniz. Sipariş API'leri, sipariş yönetimiyle ilgili görevleri otomatikleştirmenize olanak tanır. Böylece Play Console üzerinden manuel kontroller yapma ihtiyacı azalır.

Bu API'nin kullanım alanlarından bazıları şunlardır:

  • Anlık sipariş verilerini alma: orders.get işlevini kullanarak sipariş kimliğiyle satın alma işleminden hemen sonra sipariş ayrıntılarını ve meta verileri alın.

  • Sipariş güncelleme senkronizasyonu: Sipariş bilgilerinin güncel bir kaydını tutmak için sipariş güncellemelerini düzenli olarak senkronize edin.

Not:

  • Orders API çağrıları, Play Developer API kotanıza dahil edilir. Bu kota, varsayılan olarak günlük 200.000'dir ve kapsamlı sipariş geçmişlerini senkronize etmek için yetersiz olabilir.

  • Çağrı başına en fazla 1.000 sipariş alınabilir. Kota kullanımını en aza indirmek için daha büyük sayfa boyutları kullanmanız önerilir. Cloud Console'da kotanızı kontrol edin ve gerekirse daha fazla kota isteyin.

JSON gösterimi 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ],
  "orderId": string,
  "purchaseToken": string,
  "state": enum (State),
  "createTime": string,
  "lastEventTime": string,
  "buyerAddress": {
    object (BuyerAddress)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },
  "orderDetails": {
    object (OrderDetails)
  },
  "orderHistory": {
    object (OrderHistory)
  },
  "developerRevenueInBuyerCurrency": {
    object (Money)
  },
  "pointsDetails": {
    object (PointsDetails)
  }
}
Alanlar
lineItems[]

object (LineItem)

Bu siparişi oluşturan tek tek satır öğeleri.
orderId

string

Sipariş kimliği.
purchaseToken

string

Abonelik veya öğe satın alındığında kullanıcının cihazına sağlanan jeton.
state

enum (State)

Siparişin durumu.
createTime

string (Timestamp format)

Siparişin oluşturulduğu zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastEventTime

string (Timestamp format)

Siparişle ilgili son etkinliğin gerçekleştiği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
buyerAddress

object (BuyerAddress)

Vergi hesaplamasında kullanılmak üzere müşterinin adres bilgileri. Google, siparişin kayıtlı satıcısı olduğunda yalnızca ülke gösterilir.
total

object (Money)

İndirimler ve vergiler dikkate alınarak müşterinin ödediği nihai tutar.
tax

object (Money)

Bu sipariş kapsamında ödenen toplam vergi.
orderDetails

object (OrderDetails)

Oluşturma sırasındaki siparişle ilgili ayrıntılı bilgiler.
orderHistory

object (OrderHistory)

Siparişin değiştirilmesine neden olan etkinliklerle ilgili ayrıntılar.
developerRevenueInBuyerCurrency

object (Money)

Kısmi geri ödemeler, vergiler ve ücretler dahil olmak üzere bu siparişten alıcının para biriminde elde ettiğiniz gelir. Google her satıştan standart işlem ve üçüncü taraf ücretlerini düşer (bazı bölgelerde KDV de düşülür).
pointsDetails

object (PointsDetails)

Teklif bilgileri, indirim oranı ve puan değerleri dahil olmak üzere siparişte kullanılan Play puanları.

Eyalet

Siparişin durumu.

Sıralamalar
STATE_UNSPECIFIED Durum belirtilmemiş. Bu değer kullanılmaz.
PENDING Sipariş oluşturuldu ve işlenmeyi bekliyor.
PROCESSED Sipariş başarıyla işlendi.
CANCELED Sipariş işlenmeden önce iptal edilmiştir.
PENDING_REFUND İstenen geri ödemenin işlenmesi bekleniyor.
PARTIALLY_REFUNDED Sipariş tutarının bir kısmı geri ödendi.
REFUNDED Sipariş tutarının tamamı geri ödendi.

BuyerAddress

Vergi hesaplamasında kullanılmak üzere müşterinin adres bilgileri.

JSON gösterimi 
{
  "buyerState": string,
  "buyerCountry": string,
  "buyerPostcode": string
}
Alanlar
buyerState

string

Alıcı adresinin bulunduğu ülkenin en üst düzey idari alt bölümü. Google, siparişin kayıtlı satıcısı olduğunda bu bilgiler dahil edilmez.
buyerCountry

string

ISO-3166-1 Alpha-2'ye (BM ülke kodları) dayalı iki harfli ülke kodu.
buyerPostcode

string

Adresin posta kodu. Google, siparişin kayıtlı satıcısı olduğunda bu bilgiler dahil edilmez.

OrderDetails

Oluşturma sırasındaki siparişle ilgili ayrıntılı bilgiler.

JSON gösterimi 
{
  "taxInclusive": boolean
}
Alanlar
taxInclusive

boolean

Listelenen fiyatın vergi dahil olup olmadığını gösterir.

LineItem

Satır öğesinin ayrıntıları.

JSON gösterimi 
{
  "productTitle": string,
  "productId": string,
  "listingPrice": {
    object (Money)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },

  // Union field details can be only one of the following:
  "oneTimePurchaseDetails": {
    object (OneTimePurchaseDetails)
  },
  "subscriptionDetails": {
    object (SubscriptionDetails)
  },
  "paidAppDetails": {
    object (PaidAppDetails)
  }
  // End of list of possible types for union field details.
}
Alanlar
productTitle

string

Geliştiricinin belirlediği ürün adı. Alıcının yerel ayarında görüntülenir. Örnek: coins, aylık abonelik vb.
productId

string

Satın alınan ürünün kimliği veya uygulama içi SKU (örneğin, "monthly001" ya da "com.some.thing.inapp1").
listingPrice

object (Money)

Öğenin Play Store'daki listelenen fiyatı. Bu fiyata vergi dahil olabilir veya olmayabilir. İndirimler veya promosyonlar hariçtir.
total

object (Money)

İndirimler ve vergi dikkate alınarak bu satır öğesi için kullanıcı tarafından ödenen toplam tutar.
tax

object (Money)

Bu satır öğesi için ödenen vergi.

Birleştirme alanı details.

details yalnızca aşağıdakilerden biri olabilir:
oneTimePurchaseDetails

object (OneTimePurchaseDetails)

Tek seferlik satın alma işleminin ayrıntıları.
subscriptionDetails

object (SubscriptionDetails)

Abonelik satın alma işleminin ayrıntıları.
paidAppDetails

object (PaidAppDetails)

Ücretli uygulama satın alma işleminin ayrıntıları.

OneTimePurchaseDetails

Tek seferlik satın alma işleminin ayrıntıları.

JSON gösterimi 
{
  "quantity": integer,
  "offerId": string,
  "purchaseOptionId": string,
  "rentalDetails": {
    object (RentalDetails)
  }
}
Alanlar
quantity

integer

Satın alınan öğelerin sayısı (çoklu miktar öğe satın alma işlemleri için).
offerId

string

Tek seferlik satın alma teklifinin teklif kimliği.
purchaseOptionId

string

Satın alma seçeneğinin kimliği. Bu alan hem satın alma seçenekleri hem de varyant teklifleri için ayarlanır. Satın alma seçenekleri için bu kimlik, satın alma seçeneğini tanımlar. Varyant teklifleri için bu kimlik, ilişkili satın alma seçeneğini ifade eder ve offerId ile birlikte varyant teklifini tanımlar.
rentalDetails

object (RentalDetails)

Kiralama satın alma işleminin ayrıntıları. Yalnızca kiralama satın alma işlemiyse ayarlayın.

RentalDetails

Bu türde alan yok.

Kiralama satın alma işleminin ayrıntıları.

SubscriptionDetails

Abonelik satın alma işleminin ayrıntıları.

JSON gösterimi 
{
  "basePlanId": string,
  "offerId": string,
  "offerPhase": enum (OfferPhase),
  "servicePeriodStartTime": string,
  "servicePeriodEndTime": string
}
Alanlar
basePlanId

string

Aboneliğin temel plan kimliği.
offerId

string

Mevcut abonelik teklifinin teklif kimliği.
offerPhase

enum (OfferPhase)

Bu siparişle finanse edilen fatura döneminin fiyatlandırma aşaması.
servicePeriodStartTime

string (Timestamp format)

Bu siparişle finanse edilen fatura döneminin başlangıcı. Bu, sipariş işlendiği sırada faturalandırma/hizmet döneminin başlangıç zamanının anlık görüntüsüdür ve yalnızca muhasebe için kullanılmalıdır.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
servicePeriodEndTime

string (Timestamp format)

Bu siparişle finanse edilen fatura döneminin sonu. Bu, sipariş işlendiği sırada faturalandırma/hizmet döneminin bitiş zamanının anlık görüntüsüdür ve yalnızca muhasebe için kullanılmalıdır. Abonelik hizmeti döneminin geçerli bitiş zamanını almak için purchases.subscriptionsv2.get yöntemini kullanın.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

OfferPhase

Bu siparişle finanse edilen hak kazanma döneminin fiyatlandırma aşaması.

Sıralamalar
OFFER_PHASE_UNSPECIFIED Teklif aşaması belirtilmemiş. Bu değer kullanılmaz.
BASE Sipariş, temel fiyat dönemini finanse eder.
INTRODUCTORY Sipariş, tanıtım fiyatı dönemini finanse eder.
FREE_TRIAL Sipariş, ücretsiz deneme süresini finanse ediyorsa.

PaidAppDetails

Bu türde alan yok.

Ücretli uygulama satın alma işleminin ayrıntıları.

OrderHistory

Siparişin değiştirilmesine neden olan etkinliklerle ilgili ayrıntılar.

JSON gösterimi 
{
  "partialRefundEvents": [
    {
      object (PartialRefundEvent)
    }
  ],
  "processedEvent": {
    object (ProcessedEvent)
  },
  "cancellationEvent": {
    object (CancellationEvent)
  },
  "refundEvent": {
    object (RefundEvent)
  }
}
Alanlar
partialRefundEvents[]

object (PartialRefundEvent)

Bu siparişle ilgili kısmi geri ödeme etkinliklerinin ayrıntıları.
processedEvent

object (ProcessedEvent)

Siparişin işlenme zamanıyla ilgili ayrıntılar.
cancellationEvent

object (CancellationEvent)

Siparişin iptal edildiği zamanla ilgili ayrıntılar.
refundEvent

object (RefundEvent)

Siparişin tam olarak ne zaman geri ödendiğiyle ilgili ayrıntılar.

ProcessedEvent

Siparişin işlenme zamanıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "eventTime": string
}
Alanlar
eventTime

string (Timestamp format)

Siparişin işlendiği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

CancellationEvent

Siparişin iptal edildiği zamanla ilgili ayrıntılar.

JSON gösterimi 
{
  "eventTime": string
}
Alanlar
eventTime

string (Timestamp format)

Siparişin iptal edildiği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

RefundEvent

Siparişin tam olarak ne zaman geri ödendiğiyle ilgili ayrıntılar.

JSON gösterimi 
{
  "eventTime": string,
  "refundDetails": {
    object (RefundDetails)
  },
  "refundReason": enum (RefundReason)
}
Alanlar
eventTime

string (Timestamp format)

Siparişin tam olarak geri ödendiği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
refundDetails

object (RefundDetails)

Tam geri ödemeyle ilgili ayrıntılar.
refundReason

enum (RefundReason)

Sipariş için geri ödeme yapılmasının nedeni.

RefundDetails

Kısmi veya tam geri ödeme ayrıntıları

JSON gösterimi 
{
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  }
}
Alanlar
total

object (Money)

Vergi dahil geri ödenen toplam tutar.
tax

object (Money)

Geri ödenen vergi tutarı.

RefundReason

Sipariş için geri ödeme yapılmasının nedeni.

Sıralamalar
REFUND_REASON_UNSPECIFIED orders.refund nedeni belirtilmedi. Bu değer kullanılmaz.
OTHER Sipariş için burada listelenen nedenler dışında bir nedenle geri ödeme yapıldı.
CHARGEBACK Sipariş için geri ödeme yapıldı.

PartialRefundEvent

Bu siparişle ilgili kısmi geri ödeme etkinliklerinin ayrıntıları.

JSON gösterimi 
{
  "createTime": string,
  "processTime": string,
  "state": enum (State),
  "refundDetails": {
    object (RefundDetails)
  }
}
Alanlar
createTime

string (Timestamp format)

Kısmi geri ödemenin oluşturulduğu zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
processTime

string (Timestamp format)

Kısmi geri ödemenin işlendiği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
state

enum (State)

Kısmi geri ödemenin durumu.
refundDetails

object (RefundDetails)

Kısmi geri ödemeyle ilgili ayrıntılar.

Eyalet

Kısmi geri ödemenin durumu.

Sıralamalar
STATE_UNSPECIFIED Durum belirtilmemiş. Bu değer kullanılmaz.
PENDING Kısmi geri ödeme oluşturuldu ancak henüz işlenmedi.
PROCESSED_SUCCESSFULLY Kısmi geri ödeme başarıyla işlendi.

PointsDetails

Siparişlere uygulanan Play Points ile ilgili ayrıntılar.

JSON gösterimi 
{
  "pointsOfferId": string,
  "pointsCouponValue": {
    object (Money)
  },
  "pointsDiscountRateMicros": string,
  "pointsSpent": string
}
Alanlar
pointsOfferId

string

Bu sipariş için kullanılan Play puanı teklifine özgü kimlik.
pointsCouponValue

object (Money)

Play Points kuponunun parasal değeri. Bu, kuponun sağladığı indirimdir ve toplam tutar olmayabilir. Yalnızca Play Points kuponları kullanıldığında ayarlanır. Örneğin, 2 ABD doları değerinde 100 puanlık bir kupon için bu değer 2 ABD dolarıdır.
pointsDiscountRateMicros

string (int64 format)

Play Points promosyonunun maliyeti düşürdüğü yüzde oranı. Örneğin, 2 ABD doları değerinde 100 puanlık bir kupon için bu değer 500.000'dir. 2 TL'nin tahmini puanı 200 olsa da gereken gerçek puan 100 olup bu değerin% 50'sidir. Mikrolardaki% 50 ise 500.000'dir. 0 ile 1.000.000 arasında.
pointsSpent

string (int64 format)

Bu siparişte kullanılan Play puanlarının sayısı. Örneğin, 2 ABD doları değerinde 100 puanlık bir kupon için bu değer 100'dür. Temel teklifle birlikte kullanılan kupon için bu, her ikisinde de harcanan toplam puanlardır.

Yöntemler

batchget

 Bir sipariş listesi için sipariş ayrıntılarını alma

get

 Tek bir siparişin ayrıntılarını alma

refund

 Kullanıcının aboneliği veya uygulama içi satın alma siparişi için geri ödeme yapılması