คู่มืออ้างอิงการแจ้งเตือนนักพัฒนาแอปแบบเรียลไทม์

เอกสารนี้แสดงรายการและอธิบายประเภทการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่คุณจะได้รับจาก Google Play

การเข้ารหัส

การเผยแพร่แต่ละครั้งไปยังหัวข้อ Cloud Pub/Sub จะมีฟิลด์ข้อมูลที่เข้ารหัสแบบ Base64 เพียงฟิลด์เดียว

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

หลังจากถอดรหัสฟิลด์ข้อมูลที่เข้ารหัส Base64 แล้ว DeveloperNotification จะมีฟิลด์ต่อไปนี้

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

ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
เวอร์ชัน สตริง เวอร์ชันของการแจ้งเตือนนี้ โดยค่าเริ่มต้นจะเป็น "1.0" เวอร์ชันนี้แตกต่างจากฟิลด์เวอร์ชันอื่นๆ
packageName สตริง ชื่อแพ็กเกจของแอปพลิเคชันที่เกี่ยวข้องกับการแจ้งเตือนนี้ (เช่น `com.some.thing`)
eventTimeMillis ยาว การประทับเวลาเมื่อเกิดเหตุการณ์ในหน่วยมิลลิวินาทีนับตั้งแต่ Epoch
subscriptionNotification SubscriptionNotification

หากมีช่องนี้ แสดงว่าการแจ้งเตือนนี้เกี่ยวข้องกับการสมัครใช้บริการ และช่องนี้จะมีข้อมูลเพิ่มเติมที่เกี่ยวข้องกับการสมัครใช้บริการ

โปรดทราบว่าช่องนี้จะแยกกันกับ pendingRefundReviewNotification, oneTimeProductNotification, voidedPurchaseNotification และ testNotification

oneTimeProductNotification OneTimeProductNotification

หากมีช่องนี้ แสดงว่าการแจ้งเตือนนี้เกี่ยวข้องกับการซื้อครั้งเดียว และช่องนี้จะมีข้อมูลเพิ่มเติมเกี่ยวกับการซื้อ

โปรดทราบว่าช่องนี้เป็นข้อมูลแยกกันกับ pendingRefundReviewNotification, subscriptionNotification, voidedPurchaseNotification และ testNotification

voidedPurchaseNotification VoidedPurchaseNotification

หากมีช่องนี้ แสดงว่าการแจ้งเตือนนี้เกี่ยวข้องกับการซื้อที่เป็นโมฆะ และช่องนี้จะมีข้อมูลเพิ่มเติมเกี่ยวกับการซื้อที่เป็นโมฆะ

โปรดทราบว่าช่องนี้เป็นข้อมูลแยกกันกับ pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification และ testNotification

pendingRefundReviewNotification PendingRefundReviewNotification

หากมีช่องนี้ แสดงว่าการแจ้งเตือนนี้เกี่ยวข้องกับคำขอปฏิเสธการชำระเงินซึ่งคุณสามารถแนะนำวิธีแก้ปัญหาได้ ตอบกลับการแจ้งเตือนนี้โดยเรียกใช้ `ReviewRefund` API

โปรดทราบว่าฟิลด์นี้เป็นข้อมูลแยกกันกับ subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification และ testNotification

testNotification TestNotification

หากมีฟิลด์นี้ แสดงว่าการแจ้งเตือนนี้เกี่ยวข้องกับการเผยแพร่เพื่อทดสอบ โดยจะส่งผ่าน Google Play Console เท่านั้น

โปรดทราบว่าช่องนี้เป็นข้อมูลแยกกันกับ pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification และ voidedPurchaseNotification

SubscriptionNotification

SubscriptionNotification มีช่องต่อไปนี้

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
เวอร์ชัน สตริง เวอร์ชันของการแจ้งเตือนนี้ โดยค่าเริ่มต้นจะเป็น "1.0" เวอร์ชันนี้แตกต่างจากฟิลด์เวอร์ชันอื่นๆ
notificationType Int notificationType สำหรับการสมัครใช้บริการอาจมีค่าต่อไปนี้
  • (1) SUBSCRIPTION_RECOVERED - การสมัครใช้บริการได้รับการกู้คืนจากการระงับบัญชีหรือกลับมาทำงานอีกครั้งจากการหยุดชั่วคราว
  • (2) SUBSCRIPTION_RENEWED - มีการต่ออายุการสมัครใช้บริการที่ใช้งานอยู่
  • (3) SUBSCRIPTION_CANCELED - มีการยกเลิกการสมัครใช้บริการโดยสมัครใจหรือไม่สมัครใจ สำหรับการยกเลิกโดยสมัครใจ ระบบจะส่งเมื่อผู้ใช้ยกเลิก
  • (4) SUBSCRIPTION_PURCHASED - มีการซื้อการสมัครใช้บริการใหม่
  • (5) SUBSCRIPTION_ON_HOLD - การสมัครใช้บริการเข้าสู่สถานะการระงับบัญชี (หากเปิดใช้)
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD - การสมัครใช้บริการเข้าสู่ระยะเวลาผ่อนผัน (หากเปิดใช้)
  • (7) SUBSCRIPTION_RESTARTED - ผู้ใช้กู้คืนการสมัครใช้บริการจาก Play > บัญชี > การสมัครใช้บริการ การสมัครใช้บริการถูกยกเลิกแต่ยังไม่หมดอายุเมื่อผู้ใช้กู้คืน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกู้คืนก่อนหมดอายุ
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED (เลิกใช้งานแล้ว) - ผู้ใช้ยืนยันการเปลี่ยนแปลงราคาการสมัครใช้บริการเรียบร้อยแล้ว
  • (9) SUBSCRIPTION_DEFERRED - ขยายเวลาการเกิดซ้ำของการสมัครใช้บริการแล้ว
  • (10) SUBSCRIPTION_PAUSED - การสมัครใช้บริการหยุดชั่วคราว
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - มีการเปลี่ยนแปลงกำหนดเวลาหยุดการสมัครใช้บริการชั่วคราว
  • (12) SUBSCRIPTION_REVOKED - ระบบเพิกถอนการสมัครใช้บริการจากผู้ใช้ก่อนเวลาหมดอายุ
  • (13) SUBSCRIPTION_EXPIRED - การสมัครใช้บริการหมดอายุแล้ว
  • (17) SUBSCRIPTION_ITEMS_CHANGED - มีการเปลี่ยนแปลงรายการในแพ็กเกจการสมัครใช้บริการ
  • (18) SUBSCRIPTION_CANCELLATION_SCHEDULED - มีการกำหนดเวลาการยกเลิกการสมัครใช้บริการแบบผ่อนชำระให้มีผลเมื่อสิ้นสุดระยะเวลาผูกมัด
  • (19) SUBSCRIPTION_PRICE_CHANGE_UPDATED - มีการอัปเดตรายละเอียดการเปลี่ยนแปลงราคาของรายการที่สมัครใช้บริการ
  • (20) SUBSCRIPTION_PENDING_PURCHASE_CANCELED - ธุรกรรมที่รอดำเนินการของการสมัครใช้บริการถูกยกเลิกแล้ว
  • (21) SUBSCRIPTION_PLAN_TRANSITION_UPDATED - การเปลี่ยนแพ็กเกจที่กำหนดเวลาไว้ของการสมัครใช้บริการได้รับการอัปเดต (เช่น เมื่อผู้ใช้ยอมรับข้อเสนอเพื่อรักษาผู้ใช้ไว้)
  • (22) SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED - ระยะเวลาขอความยินยอมสำหรับการปรับขึ้นราคาของการสมัครใช้บริการได้เริ่มต้นขึ้นแล้ว หรือผู้ใช้ได้ให้ความยินยอมสำหรับการปรับขึ้นราคาแล้ว ระบบจะส่ง RTDN นี้สำหรับการสมัครใช้บริการในภูมิภาคที่ต้องมีการเพิ่มราคาเท่านั้น
purchaseToken สตริง โทเค็นที่ส่งไปยังอุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

ตัวอย่าง

ตัวอย่างการแจ้งเตือนสำหรับการซื้อการสมัครใช้บริการใหม่มีดังนี้

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

OneTimeProductNotification

OneTimeProductNotification มีช่องต่อไปนี้

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
เวอร์ชัน สตริง เวอร์ชันของการแจ้งเตือนนี้ ในตอนแรก ค่านี้จะเป็น "1.0" เวอร์ชันนี้แตกต่างจากฟิลด์เวอร์ชันอื่นๆ
notificationType Int ประเภทการแจ้งเตือน ซึ่งอาจมีค่าต่อไปนี้
  • (1) ONE_TIME_PRODUCT_PURCHASED - ผู้ใช้ซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวเรียบร้อยแล้ว
  • (2) ONE_TIME_PRODUCT_CANCELED - การซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวถูกยกเลิกหรือเพิกถอน
purchaseToken สตริง โทเค็นที่ส่งไปยังอุปกรณ์ของผู้ใช้เมื่อทำการซื้อ
sku สตริง รหัสไอเทมแบบเรียกเก็บเงินครั้งเดียวที่ซื้อ (เช่น "sword_001")

ตัวอย่าง

ตัวอย่างการแจ้งเตือนสำหรับการซื้อครั้งเดียวใหม่มีดังนี้

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

VoidedPurchaseNotification

VoidedPurchaseNotification มีช่องต่อไปนี้

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย

purchaseToken

string

โทเค็นที่เชื่อมโยงกับการซื้อที่เป็นโมฆะ ระบบจะส่งข้อมูลนี้ให้นักพัฒนาแอปเมื่อมีการซื้อใหม่เกิดขึ้น

orderId

string

รหัสคำสั่งซื้อที่ไม่ซ้ำกันซึ่งเชื่อมโยงกับธุรกรรมที่ถูกยกเลิก สำหรับการซื้อครั้งเดียว รหัสนี้จะแสดงรหัสคำสั่งซื้อเดียวที่สร้างขึ้นสำหรับการซื้อ สำหรับการสมัครใช้บริการที่ต่ออายุใหม่อัตโนมัติ ระบบจะสร้างรหัสคำสั่งซื้อใหม่สำหรับธุรกรรมการต่ออายุแต่ละรายการ

productType

int

productType สำหรับการซื้อที่เป็นโมฆะอาจมีค่าต่อไปนี้

  • (1) PRODUCT_TYPE_SUBSCRIPTION - การซื้อการสมัครใช้บริการเป็นโมฆะ
  • (2) PRODUCT_TYPE_ONE_TIME - การซื้อครั้งเดียวถูกยกเลิกแล้ว

refundType

int

refundType สำหรับการซื้อที่เป็นโมฆะอาจมีค่าต่อไปนี้

  • (1) REFUND_TYPE_FULL_REFUND - การซื้อถูกยกเลิกโดยสมบูรณ์
  • (2) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND - การซื้อถูกยกเลิกบางส่วนโดยการคืนเงินบางส่วนตามจำนวน ซึ่งใช้ได้กับการซื้อแบบหลายจำนวนเท่านั้น การซื้อสามารถเป็นโมฆะบางส่วนได้หลายครั้ง

โปรดทราบว่าเมื่อมีการคืนเงินสำหรับจำนวนรวมที่เหลืออยู่ของการซื้อหลายรายการ refundType จะREFUND_TYPE_FULL_REFUND

ตัวอย่าง

ตัวอย่างการแจ้งเตือนสำหรับการซื้อที่เป็นโมฆะรายการใหม่มีดังนี้

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

กำลังใช้ VoidedPurchaseNotification

เมื่อไคลเอ็นต์ RTDN ได้รับ VoidedPurchaseNotification ให้จดข้อมูลต่อไปนี้ไว้

  • packageName: ระบุแอป
  • eventTimeMillis: แจ้งให้คุณทราบถึงเวลาที่เกิดการเปลี่ยนแปลงสถานะ
  • purchaseToken: โทเค็นที่ส่งไปยังอุปกรณ์ของผู้ใช้เมื่อซื้อไอเทม
  • orderId: ระบุคำสั่งซื้อที่เชื่อมโยงกับธุรกรรมที่เป็นโมฆะ
  • productType: ระบุว่าการซื้อที่เป็นโมฆะเป็นการซื้อในแอปหรือการสมัครใช้บริการ
  • refundType: ระบุประเภทการคืนเงินที่ทำให้การซื้อเป็นโมฆะ

PendingRefundReviewNotification

ระบบจะส่ง PendingRefundReviewNotification เมื่อผู้ใช้ขอการปฏิเสธการชำระเงินสำหรับการซื้อ และคำขอดังกล่าวต้องได้รับการตรวจสอบจากนักพัฒนาแอป เมื่อได้รับการแจ้งเตือนนี้ คุณควรประเมินคำขอและให้คำแนะนำในการคืนเงินและหลักฐานการใช้การซื้อภายใน 24 ชั่วโมงโดยเรียกใช้ API ReviewRefund

PendingRefundReviewNotification มีช่องต่อไปนี้

{
  "version": string,
  "pendingRefundToken": string,
  "orderId": string,
  "refundReason": int,
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
เวอร์ชัน สตริง เวอร์ชันของการแจ้งเตือนนี้ โดยค่าเริ่มต้นจะเป็น "1.0" เวอร์ชันนี้แตกต่างจากฟิลด์เวอร์ชันอื่นๆ
pendingRefundToken สตริง โทเค็นที่ไม่ซ้ำกันซึ่งระบุคำขอคืนเงินที่รอดำเนินการซึ่งอยู่ระหว่างตรวจสอบ ส่งโทเค็นนี้เมื่อเรียกใช้ ReviewRefund API
orderId สตริง รหัสคำสั่งซื้อของการซื้อที่อยู่ระหว่างการตรวจสอบการคืนเงินที่รอดำเนินการ
refundReason Int เหตุผลในการขอเงินคืน การตรวจสอบที่รอดำเนินการรองรับเฉพาะ CHARGEBACK (7) เป็นเหตุผลในการคืนเงิน โค้ดของคุณควรจัดการเหตุผลใหม่ๆ เมื่อพร้อมใช้งาน
obfuscatedAccountId สตริง (หากมี) รหัสบัญชีผู้ใช้ที่นักพัฒนาแอประบุไว้ซึ่งปรับให้ยากต่อการอ่าน (Obfuscate) ซึ่งระบุไว้เมื่อทำการซื้อ
obfuscatedProfileId สตริง (หากมี) รหัสโปรไฟล์ที่นักพัฒนาแอปกำหนดซึ่งมีการปรับให้ยากต่อการอ่าน (Obfuscate) ซึ่งระบุไว้เมื่อทำการซื้อ

ตัวอย่าง

ตัวอย่างการแจ้งเตือนการตรวจสอบการคืนเงินที่รอดำเนินการมีดังนี้

{
  "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 มีช่องต่อไปนี้

{
  "version": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
เวอร์ชัน สตริง เวอร์ชันของการแจ้งเตือนนี้ โดยค่าเริ่มต้นจะเป็น "1.0" เวอร์ชันนี้แตกต่างจากฟิลด์เวอร์ชันอื่นๆ

ตัวอย่าง

ตัวอย่างการแจ้งเตือนการทดสอบมีดังนี้

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