คู่มือนี้จะถือว่าคุณมี ESA ที่สร้างขึ้นด้วยตนเองอยู่แล้ว และจะแสดง วิธีกำหนดค่าเพื่อใช้กับข้อความ Push ของ EMM งานเสร็จแล้ว โดยเจ้าของ ESA (คุณในฐานะผู้ให้บริการโซลูชัน EMM หรือลูกค้าของคุณ) โดยใช้ คอนโซล Google API:
1. เปิดใช้การเข้าถึง Google Cloud Pub/Sub API ในคอนโซล Google API สำหรับ ในระบบคลาวด์
2. ให้สิทธิ์ผู้แก้ไขแก่ ESA
3. ตั้งค่าโปรเจ็กต์เพื่อรับการแจ้งเตือน EMM
4. ส่งการแจ้งเตือนทดสอบ EMM
5. ติดตามหัวข้อ
ขั้นตอนเหล่านี้มีอธิบายไว้อย่างละเอียดมากขึ้นในส่วนด้านล่าง
1. เปิดใช้การเข้าถึง Cloud Pub/Sub API สำหรับโปรเจ็กต์
วิธีเปิดใช้งาน Cloud Pub/Sub API สำหรับโปรเจ็กต์
- ในคอนโซล API ให้เปิดไลบรารี API เลือก โปรเจ็กต์ (หรือสร้างโปรเจ็กต์ใหม่ หากจำเป็น) ไลบรารี API แสดงรายการทั้งหมด API ที่ใช้ได้ โดยจัดกลุ่มตามกลุ่มผลิตภัณฑ์และความนิยม
- ค้นหา Cloud Pub/Sub API ในส่วน Google Cloud API (หากไม่ใช่ ปรากฏในรายการ ให้ใช้การค้นหาเพื่อค้นหา)
- เลือก Cloud Pub/Sub API แล้วคลิกเปิดใช้
หลังจากเปิดใช้ API แล้ว ให้เลือกAPI และ ในเมนู "บริการ" ให้คลิก แดชบอร์ดเพื่อดูรายการ API ทั้งหมดที่เปิดใช้ ก่อนระบบคลาวด์ Pub/Sub API สามารถใช้กับข้อความที่ส่งถึงลูกค้าได้ คุณต้องให้สิทธิ์ผู้แก้ไข สิทธิ์ในบัญชีบริการของลูกค้า (ESA)
2. ให้สิทธิ์ผู้แก้ไขแก่ ESA
จากคอนโซล API ให้ให้สิทธิ์ที่จำเป็นต่อไปนี้
- จาก API และ บริการ ให้คลิกข้อมูลเข้าสู่ระบบ คุณควร ดู ESA ของลูกค้าคุณที่แสดงรายการภายใต้คีย์ของบัญชีบริการ
- คลิกจัดการบัญชีบริการเพื่อเปิดบัญชีบริการทั้งหมด ที่เกี่ยวข้องกับโปรเจ็กต์
- จากรายการ ให้เลือกบัญชี ESA ที่เหมาะสม แล้วคลิก สิทธิ์
- ในช่องเพิ่มสมาชิก ให้ทำดังนี้
- ป้อนอีเมลที่เชื่อมโยงกับ ESA
- จากตัวเลือกแบบเลื่อนลง เลือกตัดต่อวิดีโอ (ถัดจาก ช่องป้อนข้อความ)
- คลิกเพิ่มเพื่อบันทึกสิทธิ์
3. ตั้งค่าโปรเจ็กต์เพื่อรับการแจ้งเตือน EMM
เมื่อเปิดใช้ Cloud Pub/Sub API และ ESA ที่กำหนดค่าด้วย Editor คุณสามารถกำหนดค่าโปรเจ็กต์เพื่อรับการแจ้งเตือน EMM เป็น อย่างละเอียดในชุด ข้อความ Push ของ EMM กล่าวสั้นๆ คือ กระบวนการตั้งค่าเกี่ยวข้องกับการกำหนดค่า ปลายทางเซิร์ฟเวอร์ HTTP เพื่อส่งข้อความ Push ไปยังสมาชิก
การแจ้งเตือน EMM จะส่งเป็น
protobufs
(บัฟเฟอร์โปรโตคอล ซึ่งเป็นรูปแบบง่ายๆ สำหรับการจัดลำดับข้อมูลที่มีโครงสร้าง) ที่บรรจุเป็น
ข้อความไบต์อาร์เรย์ที่เข้ารหัสแบบไบต์ 64 ภายในแพ็กเก็ต JSON ในโค้ดของคุณ คุณต้อง
แยกวิเคราะห์ JSON นี้และถอดรหัสเนื้อหาบัฟเฟอร์โปรโตคอล ตัวอย่าง
ของ Protobuf ที่เข้ารหัส URL แบบ Base64 ที่ปลอดภัยสำหรับ NewPermissionsEvent
การแจ้งเตือน:
CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF
โดยจะถอดรหัสเป็น
{
enterprise_id: "C12345678"
event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
[as milliseconds]: 2016-04-22 10:15:28 +0100
new_permissions_event: {
product_id: "app:com.fakeapp.example"
requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
"android.permission.VIBRATE" ]
}
}
หากต้องการถอดรหัสการแจ้งเตือน EMM ที่มีรูปแบบ Protobuf คุณสามารถใช้
พบ emm_pubsub.proto
ไฟล์ใน
ที่เก็บ google/play-work บน GitHub เมื่อมีประเภทการแจ้งเตือนใหม่คือ
เพิ่มแล้ว ไฟล์นั้นจะขยายออกด้วยประเภทใหม่ และโค้ดตัวอย่างจะได้รับการอัปเดต
การเปลี่ยนแปลงเหล่านี้ควรจะเข้ากันได้แบบย้อนหลัง แต่ก็ต้องแน่ใจว่าโค้ดของคุณสามารถใช้งานได้ดี
ด้วยความยินดีด้วยการรับการแจ้งเตือนประเภทที่ไม่รู้จักนอกเหนือจาก
ที่แสดงอยู่ในไฟล์ .proto
4. ส่งการแจ้งเตือนทดสอบ EMM
การส่งการแจ้งเตือนทดสอบช่วยให้คุณยืนยันได้ว่า ตั้งค่าระบบเพื่อรับการแจ้งเตือน EMM จาก Google Play และ ยังช่วยให้คุณทราบชื่อหัวข้อด้วย (ใช้ชื่อหัวข้อเดียวกันเพื่อแสดง การแจ้งเตือน Google Play EMM ทั้งหมด)
ใช้ Play EMM API เพื่อเรียกใช้เมธอด
sendTestPushNotification
ในทรัพยากรขององค์กร
การเรียกใช้การดำเนินการนี้จะทำให้ระบบส่งการแจ้งเตือนทดสอบ EMM หากใช้ EMM มีการกำหนดค่าการแจ้งเตือนอย่างเหมาะสม API จะแสดงผลดังนี้
{ topic_name: "/projects/project-name/topics/play-work-012345", message_id: "128976912439" }
5. ติดตามหัวข้อ
การใช้โค้ดตัวอย่างที่ให้ไว้ใน Run รหัสทดสอบของผู้เผยแพร่โฆษณา (ในส่วนตั้งค่าพุชของ EMM การแจ้งเตือน) สมัครรับข้อมูลในหัวข้อที่ระบุ คุณควรได้รับ ทดสอบการแจ้งเตือนของ EMM พร้อมการแจ้งเตือนจริงที่ ตั้งแต่ที่คุณเริ่มกระบวนการกำหนดค่า