如要快速開發,您可以使用註冊工具 的外掛程式,以便快速註冊或更新裝置 模型和執行個體
如果不想使用這項工具,可以手動註冊 或是使用 JSON 檔案和 REST API 更新裝置您可以在 電腦。請先取得存取權杖,然後直接跳到 適當的部分
取得存取憑證
確認授權工具是否為最新版本:
python -m pip install --upgrade google-auth-oauthlib[tool]
取得憑證以註冊新的裝置型號。參照您複製到 裝置 步驟。
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://...
複製網址並貼到瀏覽器 (步驟如下: 或任何其他機器)核准後,系統就會提供驗證碼 會顯示在瀏覽器中,例如「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
,表示輸入的代碼無效。 請再試一次,並謹慎複製及貼上完整的程式碼。在 JSON 回應中找到
token
。複製此存取權杖 (不含 雙引號) 內) 貼到環境變數中:ACCESSTOKEN=access-token
裝置型號作業
定義及註冊裝置型號
建立檔案 (例如
device_model.json
) 可說明特性 裝置型號請參閱裝置型號 JSON 參考資料 瞭解詳情使用下列任一方法註冊裝置型號。記得要 將
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 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- 方法:
POST
- 內文:
device_model.json
的內容 - 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
無論選擇哪一種方式,伺服器都應傳回裝置型號 JSON 的副本 或類似的名稱如果伺服器上已有模型,您會收到
ALREADY_EXISTS
錯誤。
取得裝置型號
使用下列任一方法取得裝置型號。記得要
將 project_id
替換成
和 device_model_id
。
使用下列指令:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 方法:
GET
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
列出裝置型號
使用下列任一方法,列出特定專案的所有裝置型號。記得要
將 project_id
替換成
。
使用下列指令:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- 方法:
GET
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
更新裝置型號
使用下列任一方法更新裝置型號。記得要
將 project_id
替換成
和 device_model_id
找出與裝置型號相關聯的關聯
使用下列指令:
curl -s -X PUT -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 方法:
PUT
- 內文:
device_model.json
的內容 - 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
無論選擇哪一種方式,伺服器都應傳回更新後的裝置副本 您傳送的模型 JSON 版本
刪除裝置型號
使用下列任一方法刪除裝置型號。記得要
將 project_id
替換成
和 device_model_id
。
使用下列指令:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- 方法:
DELETE
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
裝置執行個體作業
定義及註冊裝置執行個體
建立檔案 (例如
test_device.json
) 識別您的裝置。 請參閱裝置執行個體 JSON 參考資料 瞭解詳情您可以使用下列任一方法註冊裝置。記得要 將
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 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- 方法:
POST
- 內文:
test_device.json
的內容 - 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
無論選擇哪種方法,伺服器都應傳回裝置執行個體 JSON 的副本 或類似的名稱如果伺服器上已有執行個體,您將收到
ALREADY_EXISTS
錯誤。
取得裝置執行個體
請透過下列任一方法取得裝置執行個體。記得要
將 project_id
替換成
與裝置型號和裝置 (id
) 建立關聯。
使用下列指令:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- 方法:
GET
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
列出裝置執行個體
使用
下列方法。請記得將 project_id
替換成
與下方網址中的裝置執行個體相關聯
使用下列指令:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- 方法:
GET
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串
刪除裝置執行個體
使用下列任一方法刪除裝置執行個體。記得要
將 project_id
替換成
與裝置型號和裝置 (id
) 建立關聯。
使用下列指令:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
請傳送包含下列屬性的 HTTPS 要求:
- 網址:https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- 方法:
DELETE
- Body: 無
- 標題:
Authorization: Bearer <access-token>
其中 <access-token>是包含存取權杖的字串