Đăng ký theo dõi sự kiện

Các sự kiện không đồng bộ và được Google Cloud Pub/Sub quản lý, trong một chủ đề duy nhất cho mỗi Project. Sự kiện cung cấp thông tin cập nhật cho tất cả các thiết bị và cấu trúc, đồng thời việc nhận các sự kiện mới là miễn là mã truy cập không bị thu hồi bởi người dùng và thông báo sự kiện không đã hết hạn.

Sự kiện là một tính năng không bắt buộc của API SDM. Chúng có thể dễ dàng triển khai và xác minh thông qua Google Cloud dự án.

Bật sự kiện

Bạn có thể bật tính năng sự kiện trong Device Access Bảng điều khiển. Chọn Dự án của bạn trong Play Console, nếu bạn chưa có.

Truy cập Device Access Bảng điều khiển

Nếu bạn đã bật các sự kiện (ví dụ: trong dự án tạo), trường Chủ đề Pub/Sub trong phần Thông tin dự án đã có sẵn được gọi là ID chủ đề, ở định dạng:

projects/sdm-prod/topics/enterprise-project-id

Nếu bạn chưa bật sự kiện:

  1. Nhấp vào biểu tượng cho Pub/Sub chủ đề rồi chọn Chỉnh sửa.
  2. Đánh dấu vào mục Bật sự kiện rồi nhấp vào Lưu.
  3. Mã chủ đề sẽ được tạo cho bạn theo định dạng như ở trên.

Sao chép mã nhận dạng chủ đề của bạn. Bạn sẽ cần mã này để tạo một gói đăng ký theo dõi chủ đề này có thể truy xuất các thông báo sự kiện.

Tạo gói thuê bao kéo

Gói thuê bao kéo là khi người đăng ký bắt đầu yêu cầu đến Pub/Sub cho các thông báo sự kiện được xếp hàng đợi. Đây là một cách nhanh chóng và dễ dàng để xác minh rằng đang được tạo cho các thiết bị được uỷ quyền của bạn.

Mở Cloud Shell cho dự án trên Google Cloud:

Truy cập Google Cloud Shell

Tại dấu nhắc Cloud Shell, hãy chạy lệnh sau để tạo một quy trình kéo đăng ký chủ đề của bạn, sử dụng bất kỳ subscription-id nào bạn thích và ID chủ đề duy nhất của bạn:

gcloud pubsub subscriptions create subscription-id --topic=projects/sdm-prod/topics/enterprise-project-id
Created subscription [projects/gcp-project-name/subscriptions/subscription-id].

Bắt đầu sự kiện

Để bắt đầu các sự kiện lần đầu tiên sau khi gói thuê bao Pub/Sub đã tạo, hãy gọi điện để liệt kê các thiết bị của bạn làm điều kiện kích hoạt một lần:

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

Các sự kiện cho tất cả cấu trúc và thiết bị sẽ xuất bản sau lệnh gọi API này.

Tạo sự kiện

Sự kiện được tạo cho tất cả các thay đổi đối với trường đặc điểm, một số thay đổi là tự động, một số sách hướng dẫn.

Ví dụ: nếu nhiệt độ môi trường xung quanh gần Nest Thermostat thay đổi, một sự kiện cho Nhiệt độ sẽ nằm trong phạm vi tự động được gửi cùng với một giá trị ambientTemperatureCelsius mới.

Để tạo bản ghi theo cách thủ công, hãy thực hiện một trong hai cách sau:

  1. Thay đổi trạng thái của thiết bị về mặt vật lý, chẳng hạn như thay đổi chế độ của Nest Thermostat của bạn.
  2. Kích hoạt một sự kiện, chẳng hạn như chuyển động, người hoặc âm thanh trên Google Nest Cam trong nhà.
  3. Thực thi lệnh trên thiết bị thông qua API SDM.

Xem tin nhắn

Bạn có thể xem các thông báo về sự kiện trong dự án của mình trên Google Cloud trong Phần Gói thuê bao Pub/Sub:

Chuyển đến trang Gói thuê bao Google Cloud Pub/Sub

  1. Nhấp vào Mã gói thuê bao mà bạn đã tạo trước đó.
  2. Trên màn hình Chi tiết đăng ký, bạn sẽ thấy hoạt động của Biểu đồ Số thư chưa được nhận email. Điều này cho biết thông báo sự kiện đã đến cho gói thuê bao của bạn. Nếu bạn không thấy hoạt động nào, hãy đợi một lát trong khi tạo thêm một vài sự kiện.
  3. Nhấp vào XEM TIN NHẮN để hiển thị bảng Messages (Thông báo).
  4. Nhấp vào KÉO để xem thư. Chúng phải tương ứng với các hành động mà bạn đã dùng để tạo sự kiện.

Bạn cũng có thể xem tin nhắn trong Cloud Shell bằng lệnh pull cơ bản:

gcloud pubsub subscriptions pull subscription-id

Để biết thêm thông tin về các loại gói thuê bao cũng như các loại sự kiện được gửi bằng API SDM và cách sử dụng chúng, hãy xem Sự kiện.

Quản lý thư

Bạn phải thường xuyên xác nhận và xoá hoàn toàn thư để duy trì gói thuê bao và tránh gửi thư trùng lặp tới những người đăng ký khác. Tất cả Bạn có thể xoá hoàn toàn tin nhắn đăng ký theo cách thủ công trong Gói thuê bao Pub/Sub mục:

Chuyển đến trang Gói thuê bao Google Cloud Pub/Sub

  1. Nhấp vào Mã gói thuê bao.
  2. Có một số cách để xác nhận và xoá hoàn toàn:
    1. Nhấp vào XEM TIN NHẮN để hiển thị bảng Messages (Thông báo). Chọn hộp kiểm Bật thông báo ack rồi nhấp vào KÉO để xem và xác nhận tất cả thư.
    2. Nhấp vào TÌM HIỂU SÂU HƠN MESSAGE để xóa hoàn toàn tất cả thư hiện có bằng cách xác nhận mà không đang xem chúng. Nhấp vào DUYỆT TÌM để xác nhận.

Bạn cũng có thể xoá hoàn toàn các thư trong Cloud Shell bằng cách sử dụng cờ --auto-ack với một lệnh pull cơ bản:

gcloud pubsub subscriptions pull subscription-id --auto-ack

Quản lý gói thuê bao

Bạn có thể thiết lập gói thuê bao theo nhiều cách, như mô tả trong Sử dụng thuộc tính gói thuê bao.

Mặc dù bạn muốn quản lý gói thuê bao và tin nhắn như thế nào là tuỳ vào bạn, đối với một Vì vậy, bạn nên sử dụng Tài khoản dịch vụ của thay vì một tài khoản người dùng như bạn có từ trước đến nay trong hướng dẫn nhanh này bắt đầu hướng dẫn. Tài khoản dịch vụ được ứng dụng hoặc máy ảo sử dụng, chứ không phải một người và có khoá tài khoản duy nhất của riêng mình.

Để biết thêm thông tin về việc xác thực tài khoản dịch vụ với Device Access, hãy xem Sự kiện.

Trước
3. Sử dụng API