Gerçek zamanlı geliştirici bildirimleri referans kılavuzu

Bu belgede, Google Play'den alabileceğiniz gerçek zamanlı geliştirici bildirimlerinin türleri listelenmekte ve açıklanmaktadır.

Kodlama

Cloud Pub/Sub konusuna yapılan her yayın, base64 ile kodlanmış tek bir veri alanı içerir.

{
  "message": {
    "attributes": {
      "key": "value"
    },
    "data": "eyAidmVyc2lvbiI6IHN0cmluZywgInBhY2thZ2VOYW1lIjogc3RyaW5nLCAiZXZlbnRUaW1lTWlsbGlzIjogbG9uZywgIm9uZVRpbWVQcm9kdWN0Tm90aWZpY2F0aW9uIjogT25lVGltZVByb2R1Y3ROb3RpZmljYXRpb24sICJzdWJzY3JpcHRpb25Ob3RpZmljYXRpb24iOiBTdWJzY3JpcHRpb25Ob3RpZmljYXRpb24sICJ0ZXN0Tm90aWZpY2F0aW9uIjogVGVzdE5vdGlmaWNhdGlvbiB9",
    "messageId": "136969346945"
  },
  "subscription": "projects/myproject/subscriptions/mysubscription"
}

Base64 olarak kodlanmış veri alanının kodunu çözdükten sonra DeveloperNotification aşağıdaki alanları içerir:

{
  "version": string,
  "packageName": string,
  "eventTimeMillis": long,
  "oneTimeProductNotification": OneTimeProductNotification,
  "subscriptionNotification": SubscriptionNotification,
  "voidedPurchaseNotification": VoidedPurchaseNotification,
  "pendingRefundReviewNotification": PendingRefundReviewNotification,
  "testNotification": TestNotification
}

Bu alanlar aşağıdaki tabloda açıklanmıştır.

Özellik adı Değer Açıklama
sürüm dize Bu bildirimin sürümü. Başlangıçta bu değer "1.0"dır. Bu sürüm, diğer sürüm alanlarından farklıdır.
packageName dize Bu bildirimin ilgili olduğu uygulamanın paket adı (ör. `com.some.thing`).
eventTimeMillis uzun Etkinliğin gerçekleştiği zaman damgası (Epoch'tan bu yana milisaniye cinsinden).
subscriptionNotification SubscriptionNotification

Bu alan mevcutsa bu bildirim bir abonelikle ilgilidir ve bu alan, abonelikle ilgili ek bilgiler içerir.

Bu alanın pendingRefundReviewNotification, oneTimeProductNotification, voidedPurchaseNotification ve testNotification ile birbirini dışladığını unutmayın.

oneTimeProductNotification OneTimeProductNotification

Bu alan varsa bu bildirim tek seferlik bir satın alma işlemiyle ilgilidir ve bu alan, satın alma işlemiyle ilgili ek bilgiler içerir.

Bu alanın pendingRefundReviewNotification, subscriptionNotification, voidedPurchaseNotification ve testNotification ile birbirini dışladığını unutmayın.

voidedPurchaseNotification VoidedPurchaseNotification

Bu alan mevcutsa bu bildirim, geçersiz kılınan bir satın alma işlemiyle ilgilidir ve bu alan, geçersiz kılınan satın alma işlemiyle ilgili ek bilgiler içerir.

Bu alanın pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification ve testNotification ile karşılıklı olarak birbirini dışladığını unutmayın.

pendingRefundReviewNotification PendingRefundReviewNotification

Bu alan mevcutsa bu bildirim, çözüm önerebileceğiniz bir ters ibraz isteğiyle ilgilidir. `ReviewRefund` API'yi çağırarak bu bildirime yanıt verin.

Bu alanın subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification ve testNotification ile karşılıklı olarak birbirini dışladığını unutmayın.

testNotification TestNotification

Bu alan varsa bu bildirim bir test yayınıyla ilgilidir. Bunlar yalnızca Google Play Console üzerinden gönderilir.

Bu alanın pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification ve voidedPurchaseNotification ile birbirini dışladığını unutmayın.

SubscriptionNotification

SubscriptionNotification aşağıdaki alanları içerir:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string
}
Özellik adı Değer Açıklama
sürüm dize Bu bildirimin sürümü. Başlangıçta bu değer "1.0"dır. Bu sürüm, diğer sürüm alanlarından farklıdır.
notificationType int Bir aboneliğin notificationType değeri aşağıdakilerden biri olabilir:
  • (1) SUBSCRIPTION_RECOVERED - Hesabın askıya alınmasından bir abonelik kurtarıldı veya duraklatılmış bir abonelik devam ettirildi.
  • (2) SUBSCRIPTION_RENEWED: Etkin bir abonelik yenilendi.
  • (3) SUBSCRIPTION_CANCELED - Bir abonelik isteğe bağlı veya isteğe bağlı olmadan iptal edildi. İsteyerek yapılan iptal için kullanıcı iptal ettiğinde gönderilir.
  • (4) SUBSCRIPTION_PURCHASED: Yeni bir abonelik satın alındı.
  • (5) SUBSCRIPTION_ON_HOLD - Bir abonelik, hesabın askıya alınması durumuna girdi (etkinleştirildiyse).
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD: Abonelik ek süreye girdi (etkinleştirilmişse).
  • (7) SUBSCRIPTION_RESTARTED - Kullanıcı, Play > Hesap > Abonelikler bölümünden aboneliğini geri yükledi. Abonelik iptal edilmiş ancak kullanıcı geri yüklediğinde henüz süresi dolmamış. Daha fazla bilgi için Süre dolmadan önce geri yükleme başlıklı makaleyi inceleyin.
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED (KULLANIMDAN KALDIRILDI) - Abonelik fiyatı değişikliği kullanıcı tarafından başarıyla onaylandı.
  • (9) SUBSCRIPTION_DEFERRED - Bir aboneliğin yinelenme süresi uzatıldı.
  • (10) SUBSCRIPTION_PAUSED - Bir abonelik duraklatıldı.
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - Abonelik duraklatma planı değiştirildi.
  • (12) SUBSCRIPTION_REVOKED - Bir abonelik, geçerlilik süresi dolmadan önce kullanıcıdan iptal edildi.
  • (13) SUBSCRIPTION_EXPIRED - Bir aboneliğin süresi doldu.
  • (17) SUBSCRIPTION_ITEMS_CHANGED: Abonelik paketindeki bir öğe değiştirildi.
  • (18) SUBSCRIPTION_CANCELLATION_SCHEDULED: Taksitli aboneliğin iptali, taahhüt süresinin sonunda geçerli olacak şekilde planlandı.
  • (19) SUBSCRIPTION_PRICE_CHANGE_UPDATED - Bir abonelik öğesinin fiyat değişikliği ayrıntıları güncellendi.
  • (20) SUBSCRIPTION_PENDING_PURCHASE_CANCELED - Bir aboneliğin bekleyen işlemi iptal edildi.
  • (21) SUBSCRIPTION_PLAN_TRANSITION_UPDATED - Bir aboneliğin planlı plan geçişi güncellendi (örneğin, bir kullanıcı elde tutma teklifini kabul ettiğinde).
  • (22) SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED - Bir aboneliğin fiyat artışı için izin süresi başladı veya kullanıcı fiyat artışı için izin verdi. Bu RTDN, yalnızca fiyat artışının gerekli olduğu bir bölgedeki abonelikler için gönderilir.
purchaseToken dize Abonelik satın alındığında kullanıcının cihazına sağlanan jeton.

Örnek

Yeni bir abonelik satın alma işlemiyle ilgili bildirim örneğini aşağıda bulabilirsiniz:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "subscriptionNotification":
  {
    "version":"1.0",
    "notificationType":4,
    "purchaseToken":"PURCHASE_TOKEN"
  }
}

OneTimeProductNotification

OneTimeProductNotification aşağıdaki alanları içerir:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
Mülk Adı Değer Açıklama
sürüm dize Bu bildirimin sürümü. Başlangıçta bu değer "1.0" olacaktır. Bu sürüm, diğer sürüm alanlarından farklıdır.
notificationType int Bildirimin türü. Aşağıdaki değerleri içerebilir:
  • (1) ONE_TIME_PRODUCT_PURCHASED: Tek seferlik bir ürün, kullanıcı tarafından başarıyla satın alındığında.
  • (2) ONE_TIME_PRODUCT_CANCELED: Tek seferlik ürün satın alma işlemi iptal edildi veya geri alındı.
purchaseToken dize Satın alma işlemi yapıldığında kullanıcının cihazına sağlanan jeton.
sku dize Satın alınan tek seferlik ürünün kimliği (ör. "sword_001")

Örnek

Yeni bir tek seferlik satın alma işlemiyle ilgili bildirim örneğini aşağıda bulabilirsiniz:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "oneTimeProductNotification":
  {
    "version":"1.0",
    "notificationType":1,
    "purchaseToken":"PURCHASE_TOKEN",
    "sku":"my.sku"
  }
}

VoidedPurchaseNotification

VoidedPurchaseNotification aşağıdaki alanları içerir:

Mülk Adı Değer Açıklama

purchaseToken

string

Geçersiz kılınan satın alma işlemiyle ilişkili jeton. Bu bilgiler, yeni bir satın alma işlemi gerçekleştiğinde geliştiriciye sağlanır.

orderId

string

Geçersiz kılınan işlemle ilişkili benzersiz sipariş kimliği. Tek seferlik satın alma işlemlerinde bu, satın alma işlemi için oluşturulan tek sipariş kimliğini temsil eder. Otomatik yenilenen aboneliklerde her yenileme işlemi için yeni bir sipariş kimliği oluşturulur.

productType

int

Geçersiz kılınan bir satın alma işleminin productType değeri aşağıdakilerden biri olabilir:

  • (1) PRODUCT_TYPE_SUBSCRIPTION - Bir abonelik satın alma işlemi geçersiz kılındı.
  • (2) PRODUCT_TYPE_ONE_TIME - Tek seferlik bir satın alma işlemi geçersiz kılındı.

refundType

int

Geçersiz kılınan bir satın alma işleminin refundType değeri aşağıdakilerden biri olabilir:

  • (1) REFUND_TYPE_FULL_REFUND - Satın alma işlemi tamamen geçersiz kılındı.
  • (2) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND: Satın alma işlemi, miktara dayalı kısmi geri ödeme ile kısmen geçersiz kılındı. Bu durum yalnızca birden fazla miktarda satın alma işlemleri için geçerlidir. Bir satın alma işlemi birden fazla kez kısmen geçersiz kılınabilir.

Çoklu satın alma işleminde kalan toplam miktar geri ödendiğinde refundType, REFUND_TYPE_FULL_REFUND olur.

Örnek

Yeni bir geçersiz satın alma işlemiyle ilgili bildirim örneği:

{
  "version":"1.0",
  "packageName":"com.some.app",
  "eventTimeMillis":"1503349566168",
  "voidedPurchaseNotification":
  {
    "purchaseToken":"PURCHASE_TOKEN",
    "orderId":"GS.0000-0000-0000",
    "productType":1
    "refundType":1
  }
}

VoidedPurchaseNotification kullanma

RTDN istemciniz bir VoidedPurchaseNotification aldığında aşağıdaki bilgileri not edin:

  • packageName: Uygulamayı tanımlar.
  • eventTimeMillis: Durum değişikliğinin gerçekleştiği zamanı bildirir.
  • purchaseToken: Ürün satın alındığında kullanıcının cihazına sağlanan jeton.
  • orderId: Geçersiz kılınan işlemle ilişkili siparişi tanımlar.
  • productType: İptal edilen satın alma işleminin bir uygulama içi satın alma işlemi mi yoksa abonelik mi olduğunu gösterir.
  • refundType: Satın alma işlemini geçersiz kılan geri ödeme türünü belirtir.

PendingRefundReviewNotification

Bir kullanıcı, satın alma işlemi için ters ibraz isteğinde bulunduğunda ve bu istek geliştirici incelemesi gerektirdiğinde PendingRefundReviewNotification gönderilir. Bu bildirimi aldığınızda, talebi değerlendirmeniz ve ReviewRefund API'yi çağırarak 24 saat içinde geri ödeme önerisi ve satın alma kullanım kanıtı sunmanız gerekir.

PendingRefundReviewNotification aşağıdaki alanları içerir:

{
  "version": string,
  "pendingRefundToken": string,
  "orderId": string,
  "refundReason": int,
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Özellik adı Değer Açıklama
sürüm dize Bu bildirimin sürümü. Başlangıçta bu değer "1.0"dır. Bu sürüm, diğer sürüm alanlarından farklıdır.
pendingRefundToken dize İncelenmekte olan bekleyen geri ödeme isteğini tanımlayan benzersiz bir jeton. ReviewRefund API'yi çağırırken bu jetonu iletin.
orderId dize Beklemedeki geri ödeme incelemesine tabi olan satın alma işleminin sipariş kimliği.
refundReason int Geri ödeme talebinin nedeni. Bekleyen incelemeler, geri ödeme nedeni olarak yalnızca CHARGEBACK (7) değerini destekler. Kodunuz, yeni nedenler kullanıma sunuldukça bunları işlemelidir.
obfuscatedAccountId dize (Varsa) Satın alma işlemi sırasında sağlanan, geliştirici tarafından belirtilen gizlenmiş kullanıcı hesabı kimliği.
obfuscatedProfileId dize (Varsa) Satın alma işlemi sırasında sağlanan, geliştirici tarafından belirtilen gizlenmiş profil kimliği.

Örnek

Beklemede olan geri ödeme incelemesi bildirimine bir örnek:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "pendingRefundReviewNotification":
  {
    "version":"1.0",
    "pendingRefundToken":"example-token",
    "orderId":"GPA.1234-5678-9012-34567",
    "refundReason":7,
    "obfuscatedAccountId":"user-account-id",
    "obfuscatedProfileId":"user-profile-id"
  }
}

TestNotification

TestNotification aşağıdaki alanları içerir:

{
  "version": string
}
Özellik adı Değer Açıklama
sürüm dize Bu bildirimin sürümü. Başlangıçta bu değer "1.0"dır. Bu sürüm, diğer sürüm alanlarından farklıdır.

Örnek

Test bildirimi örneği:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "testNotification":
  {
    "version":"1.0"
  }
}