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. Orders 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 verilerini alın.

  • Sipariş güncelleme senkronizasyonu: Sipariş bilgilerinin güncel 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 kotanın varsayılan değeri günlük 200.000'dir ve kapsamlı sipariş geçmişlerini senkronize etmek için yetersiz kalabilir.

  • Ç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 ayrı 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ştirildiği etkinliklerle ilgili ayrıntılar.
developerRevenueInBuyerCurrency

object (Money)

Kısmi geri ödemeler, vergiler ve ücretler dahil olmak üzere bu sipariş için alıcının para birimindeki geliriniz. 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şe uygulanan 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

Bir 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, monthly subscription vb.
productId

string

Satın alınan ürünün kimliği veya uygulama içi SKU (örneğin, "monthly001" veya "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.

details birleşik alanı.

details aşağıdakilerden yalnızca 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,
  "preorderDetails": {
    object (PreorderDetails)
  },
  "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.
preorderDetails

object (PreorderDetails)

Ön siparişin ayrıntıları. Yalnızca ön sipariş satın alma işlemiyse ayarlayın.
rentalDetails

object (RentalDetails)

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

PreorderDetails

Bu türde alan yok.

Ön sipariş satın alma işleminin ayrıntıları.

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),
  "offerPhaseDetails": {
    object (OfferPhaseDetails)
  },
  "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ı. Kullanımdan kaldırıldı. Bunun yerine offerPhaseDetails özelliğini kullanın.
offerPhaseDetails

object (OfferPhaseDetails)

Bu siparişle finanse edilen yararlanma dönemi için fiyatlandırma aşaması ayrıntıları.
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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

OfferPhaseDetails

Bu siparişle finanse edilen yararlanma dönemi için fiyatlandırma aşamasının ayrıntıları.

JSON gösterimi 
{

  // Union field phase_details can be only one of the following:
  "freeTrialDetails": {
    object (FreeTrialDetails)
  },
  "introductoryPriceDetails": {
    object (IntroductoryPriceDetails)
  },
  "baseDetails": {
    object (BaseDetails)
  },
  "prorationPeriodDetails": {
    object (ProrationPeriodDetails)
  }
  // End of list of possible types for union field phase_details.
}
Alanlar
phase_details birleşik alanı. Fiyatlandırma aşaması ayrıntıları. phase_details aşağıdakilerden yalnızca biri olabilir:
freeTrialDetails

object (FreeTrialDetails)

Sipariş, ücretsiz deneme süresini finanse ediyorsa.
introductoryPriceDetails

object (IntroductoryPriceDetails)

Sipariş, tanıtım fiyatı dönemini finanse eder.
baseDetails

object (BaseDetails)

Sipariş, temel fiyat dönemini finanse eder.
prorationPeriodDetails

object (ProrationPeriodDetails)

Sipariş, orantılı ödeme dönemini finanse eder.

FreeTrialDetails

Bu türde alan yok.

Ücretsiz deneme fiyatlandırma aşamasının ayrıntıları.

IntroductoryPriceDetails

Bu türde alan yok.

Tanıtım fiyatı fiyatlandırma aşamasının ayrıntıları.

BaseDetails

Bu türde alan yok.

Taban fiyatlandırma aşamasının ayrıntıları.

ProrationPeriodDetails

Orantılı ödeme döneminin ayrıntıları.

Orantılı dönem, mevcut hakları kapsayacak şekilde plan değişikliği sırasında hesaplanan bir dönem (Daha fazla bilgi için Kullanıcıların aboneliklerini yükseltmesine, düşürmesine veya değiştirmesine izin verme başlıklı makaleyi inceleyin) veya eklenti yenileme tarihlerini temel abonelikle aynı olacak şekilde ayarlamak için kullanılan orantılı bir dönem (Daha fazla bilgi için Satın alma işlemindeki öğeler için geçerli kurallar başlıklı makaleyi inceleyin) olabilir.

JSON gösterimi 
{
  "originalOfferPhase": enum (OfferPhase),
  "linkedOrderId": string
}
Alanlar
originalOfferPhase

enum (OfferPhase)

Orantılı ödeme dönemi bunlardan herhangi birini içeriyorsa satın alınan satır öğesindeki orijinal teklif aşamasını temsil edin. Örneğin, CHARGE_FULL_PRICE plan değişikliğinden kaynaklanan orantılı ödeme dönemi, yeni ürün kullanıcısının satın aldığı abonelik teklifinin 1. teklif aşamasıyla birleştirilebilir. Bu durumda, orijinal teklif aşaması burada ayarlanır.
linkedOrderId

string

Plan değişikliğinden önceki orijinal abonelik satın alma işleminin son sipariş kimliği. Bu alan yalnızca bu orantılı ödeme dönemi, önceki abonelikten yükseltme/düşürme işleminden kaynaklanıyorsa ve önceki aboneliğin bağlantılı siparişindeki kalan teklif aşamasını taşıyorsa doldurulur.

PaidAppDetails

Bu türde alan yok.

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

OrderHistory

Siparişin değiştirildiği 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şlendiği zamanla 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şlendiği zamanla ilgili ayrıntılar.

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

string (Timestamp format)

Siparişin işlendiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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 ödeme 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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 ABD doları için 200 puanlık bir tahmin yapılmış ancak gereken puan sayısı 100 olduğu için bu tahminin% 50'si kadar puan gerekiyor. 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 puan sayısıdı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ı

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Çözünürlük
5xx Google Play sunucusunda genel hata. İsteğinizi yeniden deneyin.

Sorun devam ederse Google Play hesap yöneticinizle iletişime geçin veya destek isteği gönderin. Bilinen kesintiler için Play Durum Kontrol Paneli'ni kontrol edin.
409 Eşzamanlılık güncelleme hatası.

Güncellenmekte olan bir nesne güncellenmeye çalışıldı. Örneğin, bir satın alma işlemi, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak onaylanıyor.

 İsteğinizi yeniden deneyin.