Hướng dẫn này giả định rằng bạn đã tạo một truy vấn mở theo cách thủ công và giới thiệu cho bạn cách định cấu hình để sử dụng với thông báo đẩy EMM. Các việc cần làm đã hoàn thành bởi chủ sở hữu EEA (bạn, nhà cung cấp giải pháp EMM hoặc khách hàng của bạn) sử dụng Bảng điều khiển API của Google:
1. Bật quyền truy cập API Google Cloud Pub/Sub trong Bảng điều khiển API của Google để dự án trên đám mây.
2. Cấp quyền của Người chỉnh sửa cho EEA.
3. Thiết lập một dự án để nhận thông báo EMM.
4. Gửi thông báo EMM (quản lý thiết bị di động doanh nghiệp) thử nghiệm.
5. Đăng ký chủ đề.
Các bước này được trình bày đầy đủ hơn trong các phần bên dưới.
1. Bật quyền truy cập vào API Cloud Pub/Sub cho một dự án
Cách kích hoạt API Cloud Pub/Sub cho dự án:
- Trong Bảng điều khiển API, mở Thư viện API. Chọn dự án đó (hoặc tạo một dự án mới, nếu cần). Thư viện API liệt kê tất cả các API có sẵn, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
- Trong API Google Cloud, hãy tìm API Cloud Pub/Sub. (Nếu không hiển thị trong danh sách, hãy dùng tính năng tìm kiếm để tìm.)
- Chọn API Cloud Pub/Sub, sau đó nhấp vào Bật.
Sau khi bạn bật API, trong phần API & Dịch vụ, nhấp vào Trang tổng quan để xem danh sách tất cả API đã bật. Trước đám mây Bạn có thể dùng API Pub/Sub cho các tin nhắn gửi đến khách hàng. Bạn phải cấp cho Người chỉnh sửa các quyền đối với tài khoản dịch vụ của khách hàng đó ((ES) của khách hàng đó).
2. Cấp quyền Người chỉnh sửa cho EEA
Trong Bảng điều khiển API, hãy cấp các quyền cần thiết:
- Từ API và Dịch vụ, nhấp vào Thông tin xác thực. Bạn nên xem danh sách khách hàng của bạn tại phần Khóa tài khoản dịch vụ.
- Nhấp vào Quản lý tài khoản dịch vụ để mở tất cả tài khoản dịch vụ liên kết với dự án.
- Trong danh sách, hãy chọn tài khoản mở khoá phù hợp, sau đó nhấp vào Quyền.
- Trong trường Thêm thành viên:
- Nhập địa chỉ email được liên kết với EEA.
- Trong bộ chọn thả xuống, hãy chọn Trình chỉnh sửa (bên cạnh trường nhập dữ liệu).
- Nhấp vào Thêm để lưu Quyền.
3. Thiết lập dự án để nhận thông báo EMM
Khi API Cloud Pub/Sub được bật và cách định cấu hình Hộp cát về quyền riêng tư (ES) bằng Google Ads Editor bạn có thể định cấu hình một dự án để nhận thông báo EMM chi tiết trong Đặt tăng thông báo đẩy của EMM. Tóm lại, quá trình thiết lập bao gồm cả quá trình định cấu hình điểm cuối của máy chủ HTTP để đẩy thông báo đến người đăng ký.
Thông báo EMM được gửi dưới dạng
protobufs
(bộ đệm giao thức, một định dạng đơn giản để chuyển đổi tuần tự dữ liệu có cấu trúc) được đóng gói dưới dạng
Thông báo mảng byte được mã hoá byte64 bên trong gói JSON. Trong mã của mình, bạn phải
phân tích cú pháp JSON này và giải mã nội dung vùng đệm giao thức. Sau đây là ví dụ
của một protobuf được mã hoá an toàn bằng URL base64 cho NewPermissionsEvent
thông báo:
CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF
Tham số này giải mã thành:
{
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" ]
}
}
Để giải mã thông báo EMM (quản lý thiết bị di động doanh nghiệp) có định dạng protobuf, bạn có thể sử dụng
Tệp emm_pubsub.proto nằm trong
kho lưu trữ google/play-work trên GitHub. Khi loại thông báo mới là
thì tệp đó sẽ được mở rộng với loại mới và mã mẫu được cập nhật.
Những thay đổi này phải có khả năng tương thích ngược, nhưng hãy đảm bảo mã của bạn có thể xử lý
nhận thông báo về các loại không xác định, ngoài những thông báo đó
được liệt kê trong tệp .proto.
4. Gửi thông báo EMM (quản lý thiết bị di động doanh nghiệp) thử nghiệm
Việc gửi thông báo thử nghiệm giúp bạn xác nhận rằng bạn đã thực hiện thành công thiết lập hệ thống của bạn để nhận thông báo EMM từ Google Play và còn giúp bạn biết tên chủ đề (bạn cũng có thể dùng chính tên chủ đề này để cung cấp nội dung) tất cả thông báo EMM của Google Play).
Sử dụng API EMM của Play, gọi phương thức
sendTestPushNotification trên tài nguyên Enterprises.
Khi bạn gọi thao tác này, hệ thống sẽ gửi một thông báo EMM kiểm thử. Nếu EMM thông báo được định cấu hình đúng cách thì API sẽ trả về các giá trị sau:
{
topic_name: "/projects/project-name/topics/play-work-012345",
message_id: "128976912439"
}
5. Đăng ký chủ đề
Sử dụng mã mẫu được cung cấp trong phần Chạy mã thử nghiệm của nhà xuất bản (trong phần Thiết lập thao tác đẩy EMM thông báo), thì hãy đăng ký theo dõi chủ đề cụ thể. Bạn sẽ nhận được thông báo EMM (quản lý thiết bị di động doanh nghiệp) thử nghiệm, cùng với mọi thông báo thực được tạo kể từ khi bạn bắt đầu quá trình định cấu hình.