เอกสารนี้แสดงรายการและอธิบายประเภทการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่คุณจะได้รับจาก 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 สำหรับการสมัครใช้บริการอาจมีค่าต่อไปนี้
|
| 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 | ประเภทการแจ้งเตือน ซึ่งอาจมีค่าต่อไปนี้
|
| 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 มีช่องต่อไปนี้
| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย |
|---|---|---|
|
|
โทเค็นที่เชื่อมโยงกับการซื้อที่เป็นโมฆะ ระบบจะส่งข้อมูลนี้ให้นักพัฒนาแอปเมื่อมีการซื้อใหม่เกิดขึ้น |
|
|
รหัสคำสั่งซื้อที่ไม่ซ้ำกันซึ่งเชื่อมโยงกับธุรกรรมที่ถูกยกเลิก สำหรับการซื้อครั้งเดียว รหัสนี้จะแสดงรหัสคำสั่งซื้อเดียวที่สร้างขึ้นสำหรับการซื้อ สำหรับการสมัครใช้บริการที่ต่ออายุใหม่อัตโนมัติ ระบบจะสร้างรหัสคำสั่งซื้อใหม่สำหรับธุรกรรมการต่ออายุแต่ละรายการ |
|
|
|
|
|
โปรดทราบว่าเมื่อมีการคืนเงินสำหรับจำนวนรวมที่เหลืออยู่ของการซื้อหลายรายการ |
ตัวอย่าง
ตัวอย่างการแจ้งเตือนสำหรับการซื้อที่เป็นโมฆะรายการใหม่มีดังนี้
{
"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"
}
}