ประเภทการแจ้งเตือน
เพิ่มข้อความและแจ้งเตือน
ข้อมูลเบื้องต้น
หลังจากผู้ใช้เพิ่มบัตรแล้ว คุณอาจต้องการส่งข้อความเกี่ยวกับ
และตรวจสอบว่า
พวกเขาได้รับการแจ้งเตือนเกี่ยวกับเรื่องนี้ ใช้ Add Message API
คำขอที่มี message_type
เท่ากับ
TEXT_AND_NOTIFY
สิ่งต่อไปนี้จะเกิดขึ้น
- "ข้อความ" ระบบจะเพิ่มสินค้าใน "ด้านหลังบัตร" (หรือที่เรียกว่ารายละเอียด เทมเพลต) และข้อความ Push จะส่งไปยังผู้ใช้ที่บันทึกบัตร
- เมื่อผู้ใช้แตะการแจ้งเตือน ระบบจะเปิด Google Wallet ขึ้นมาด้านหน้า บัตร (หรือเรียกว่ามุมมองการ์ด) และผู้ใช้จะเห็นข้อความเสริมที่ด้านบนของ หน้าจอที่มี "ดูข้อความ"
- การคลิกข้อความเสริมจะนำผู้ใช้ไปยังด้านหลังของบัตร และไฮไลต์ข้อความที่ยังไม่อ่าน
ข้อควรพิจารณาเมื่อส่งข้อความพร้อมการแจ้งเตือนถึงผู้ใช้
- ผู้ใช้ต้องเปิดการแจ้งเตือนสำหรับบัตรเพื่อรับ ข้อความ Push ที่เกี่ยวข้องกับข้อความ
- ข้อความอาจมี URI ที่ไปยังเว็บไซต์หรือแอปของคุณ ไฮเปอร์ลิงก์ต้องเป็น เว็บไซต์หรือแอปที่เกี่ยวข้องกับบัตร การกระทำนี้เป็นการละเมิด นโยบายการใช้งานที่ยอมรับได้ เพื่อนำผู้ใช้ไปยังลิงก์ที่ไม่เกี่ยวข้องกับบัตร
- คุณจะส่งข้อความที่เรียกใช้ข้อความ Push ได้สูงสุด 3 ข้อความใน 24 ชั่วโมง Google อาจควบคุมโควต้าการส่งข้อความ Push ของคุณหาก คิดว่าคุณกำลังส่งสแปมให้ผู้ใช้
- Google ควบคุมข้อความ Push ที่ผู้ใช้เห็นบนหน้าจอล็อก Wallet
- คุณสามารถใช้ปุ่มอัปเดต หรือ Patch วิธีแก้ไขหรือนำข้อมูลข้อความออกโดยใช้คลาสหรือวัตถุปกติ ปลายทาง
ขั้นตอนการผสานรวม
เมื่อต้องการแจ้งให้ผู้ใช้ทราบว่ามีการเพิ่มข้อความของผู้ออกบัตรใหม่โดยใช้ AddMessage API คุณจะต้องอัปเดต AddMessageRequest เพื่อให้ข้อความ ที่มีข้อความใหม่จะมี MessageType TEXT_AND_NOTIFY แทน TEXT
ตัวอย่างคำขอ JSON เพื่อเพิ่มข้อความและแจ้งเตือนในชั้นเรียนบัตร
… "id": ISSUER_ID.CLASS_ID", "message": { "header":"My Class message header", "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>", "id": "message_id", "message_type": "TEXT_AND_NOTIFY" }, …
ตัวอย่างคำขอ JSON เพื่อเพิ่มข้อความและแจ้งเตือนในออบเจ็กต์ Passes
… "id": OBJECT_ID", "classId": "ISSUER_ID.CLASS_ID", "message": { "header":"My Object message header", "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>", "id": "message_id", "message_type": "TEXT_AND_NOTIFY" }, …
ตัวอย่างการตอบกลับสำหรับเพิ่มข้อความและแจ้งเตือนสำหรับ Pass Class
// The updated resource … { "kind": "walletobjects#walletObjectMessage", "header": "My Object message header", "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>", "id": "message_id", "messageType": "textAndNotify" }, …
การจัดการข้อยกเว้น
การพยายามแจ้งเตือนมากกว่า 3 ครั้งจะทำให้ คำตอบ QuotaExceededException การอัปเดตเพิ่มเติมเกี่ยวกับ ตั้งค่าบัตรได้โดยใช้ "TEXT" แทนที่จะเป็น "TEXT_AND_NOTIFY" ตามที่กล่าวไว้ในการผสานรวม ขั้นตอน