使用 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_iddevice_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) 建立關聯。