使用 REST API 手動註冊裝置

如要快速開發，您可以使用註冊工具 的外掛程式，以便快速註冊或更新裝置 模型和執行個體

如果不想使用這項工具，可以手動註冊 或是使用 JSON 檔案和 REST API 更新裝置您可以在 電腦。請先取得存取權杖，然後直接跳到 適當的部分

取得存取憑證

  1. 確認授權工具是否為最新版本： 

    python -m pip install --upgrade google-auth-oauthlib[tool]

  2. 取得憑證以註冊新的裝置型號。參照您複製到 裝置 步驟。 

    google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --headless --client-secrets /path/to/client_secret_client-id.json

    終端機中應該會顯示一個網址： 

    Please visit this URL to authorize this application: https://...

  3. 複製網址並貼到瀏覽器 (步驟如下： 或任何其他機器)核准後，系統就會提供驗證碼 會顯示在瀏覽器中，例如「4/XXXX」。複製這段程式碼並貼到 ：

    Enter the authorization code:

    如果授權成功，您會看到類似下方的 JSON 回應 包括： 

    {
   "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"],
   "token_uri": "https://accounts.google.com/o/oauth2/token",
   "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW",
   "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com",
   "client_secret": "Un8_TNFnb55555auSAGasvAg",
   "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U"
 }

    如果看到 UNAUTHENTICATED，表示輸入的代碼無效。 請再試一次，並謹慎複製及貼上完整的程式碼。

  4. 在 JSON 回應中找到 token。複製此存取權杖 (不含 雙引號) 內) 貼到環境變數中：

    ACCESSTOKEN=access-token

裝置型號作業

定義及註冊裝置型號

  1. 建立檔案 (例如device_model.json) 可說明特性 裝置型號請參閱裝置型號 JSON 參考資料 瞭解詳情

  2. 使用下列任一方法註冊裝置型號。記得要 將 project_id 替換成 。

    • 使用下列指令：

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/

    • 請傳送包含下列屬性的 HTTPS 要求：

    無論選擇哪一種方式，伺服器都應傳回裝置型號 JSON 的副本 或類似的名稱如果伺服器上已有模型，您會收到 ALREADY_EXISTS 錯誤。

取得裝置型號

使用下列任一方法取得裝置型號。記得要 將 project_id 替換成 和 device_model_id 。

列出裝置型號

使用下列任一方法，列出特定專案的所有裝置型號。記得要 將 project_id 替換成 。

更新裝置型號

使用下列任一方法更新裝置型號。記得要 將 project_id 替換成 和 device_model_id 找出與裝置型號相關聯的關聯

無論選擇哪一種方式，伺服器都應傳回更新後的裝置副本 您傳送的模型 JSON 版本

刪除裝置型號

使用下列任一方法刪除裝置型號。記得要 將 project_id 替換成 和 device_model_id 。

裝置執行個體作業

定義及註冊裝置執行個體

  1. 建立檔案 (例如test_device.json) 識別您的裝置。 請參閱裝置執行個體 JSON 參考資料 瞭解詳情

  2. 您可以使用下列任一方法註冊裝置。記得要 將 project_id 替換成 。

    • 使用下列指令：

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/

    • 請傳送包含下列屬性的 HTTPS 要求：

    無論選擇哪種方法，伺服器都應傳回裝置執行個體 JSON 的副本 或類似的名稱如果伺服器上已有執行個體，您將收到 ALREADY_EXISTS 錯誤。

取得裝置執行個體

請透過下列任一方法取得裝置執行個體。記得要 將 project_id 替換成 與裝置型號和裝置 (id) 建立關聯。

列出裝置執行個體

使用 下列方法。請記得將 project_id 替換成 與下方網址中的裝置執行個體相關聯

刪除裝置執行個體

使用下列任一方法刪除裝置執行個體。記得要 將 project_id 替換成 與裝置型號和裝置 (id) 建立關聯。