訂閱活動

事件為非同步資料，由 Google Cloud Pub/Sub 管理，每個 Project會有一個主題。事件可為所有裝置和結構提供更新，只要使用者未撤銷存取權杖，且事件訊息未過期，系統就會確保收到事件。

事件是 SDM API 的選用功能，您可以使用 Google Cloud 專案輕鬆實作及驗證這些測試。

啟用活動功能

您可以在 Device Access 控制台啟用事件。如果尚未在控制台中選取專案，請立即選取。

前往 Device Access 控制台

如果您已啟用事件 (例如在建立專案時)，專案資訊部分的 Cloud 發布/訂閱主題欄位應已包含值，也就是主題 ID，格式如下：

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

如果您尚未啟用事件：

  1. 按一下 Pub/Sub 主題的 圖示，然後選取「編輯」。
  2. 勾選「啟用事件」，然後按一下「儲存」。
  3. 系統會根據上述格式為您產生主題 ID。

複製主題 ID，您需要這個 ID 建立主題訂閱項目，才能擷取事件訊息。

建立提取訂閱項目

提取式訂閱是指訂閱者向 Pub/Sub 伺服器發出要求，要求處理排隊的事件訊息。這是驗證授權裝置是否產生事件的快速簡便方法。

開啟 Google Cloud 專案的 Cloud Shell：

前往 Google Cloud Shell

在 Cloud Shell 提示中執行下列指令，使用您偏好的 subscription-id 和專屬主題 ID，建立主題的拉取訂閱項目：

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

啟動事件

如要在建立 Pub/Sub 訂閱後首次啟動事件，請呼叫列出裝置的一次性觸發事件：

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

系統會在這個 API 呼叫之後發布所有結構體和裝置的事件。

產生事件

系統會針對所有特徵欄位變更產生事件，其中有些是自動產生，有些則是手動產生。

舉例來說，如果 Nest Thermostat 附近的環境溫度有所變動，系統會自動傳送Temperature 特徵的事件，並附上新的 ambientTemperatureCelsius 值。

如要手動產生，請採取下列任一做法：

  1. 實體變更裝置狀態，例如變更 Nest Thermostat 的模式。
  2. 觸發事件，例如 Google Nest Cam Indoor 上的動作、人物或聲響偵測事件。
  3. 使用 SDM API 執行裝置指令。

查看訊息

您可以在 Google Cloud 專案的 Pub/Sub 訂閱專區中查看事件訊息：

前往 Google Cloud Pub/Sub 訂閱項目

  1. 按一下先前建立的訂閱 ID。
  2. 在「訂閱詳細資料」畫面上，您應該會看到「未確認訊息計數」圖表的活動。這表示訂閱項目已收到事件訊息。如果沒有看到任何活動，請稍候片刻，或產生更多事件。
  3. 按一下「查看訊息」，即可開啟「訊息」面板。
  4. 按一下「PULL」PULL即可查看訊息。這些事件應對應至您用來產生事件的動作。

您也可以使用基本 pull 指令，在 Cloud Shell 中查看訊息：

gcloud pubsub subscriptions pull subscription-id

如要進一步瞭解訂閱類型，以及 SDM API 傳送的事件類型和使用方式，請參閱「事件」。

管理訊息

您應定期確認及清除訊息，以便維持訂閱項目的清潔狀態，並避免向其他訂閱者傳送重複的訊息。您可以在 Pub/Sub 訂閱項目部分手動清除所有訂閱訊息：

前往 Google Cloud Pub/Sub 訂閱項目

  1. 按一下訂閱 ID。
  2. 您可以透過以下幾種方式確認並清除資料：
    1. 按一下「查看訊息」，即可開啟「訊息」面板。勾選「Enable ack messages」核取方塊，然後按一下「PULL」，即可查看並確認所有訊息。
    2. 按一下「清除訊息」，即可確認所有現有訊息並清除，而無須查看訊息內容。按一下「清除」確認。

您也可以在 Cloud Shell 中使用 --auto-ack 標記搭配基本 pull 指令，清除訊息：

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

管理訂閱項目

如「使用訂閱屬性」一節所述，您可以透過各種方式設定訂閱項目。

雖然您可以自行決定如何管理訂閱項目和訊息，但對於實際應用程式，我們建議您使用服務帳戶進行驗證，而非本快速上手指南中所述的使用者帳戶。服務帳戶由應用程式或虛擬機器使用，而非由人使用，且有其專屬的帳戶金鑰。

如要進一步瞭解如何使用 Device Access驗證服務帳戶，請參閱「事件」一文。

上一頁
3. 使用 API