為客戶索取裝置,然後將裝置新增至零接觸註冊機制。如果已有其他客戶認領裝置,通話將傳回錯誤。
HTTP 要求
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
partnerId |
必要欄位。經銷商合作夥伴的 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "deviceIdentifier": { object ( |
欄位 | |
---|---|
deviceIdentifier |
必要欄位。必要欄位。要認領的裝置 ID。 |
sectionType |
必要欄位。裝置佈建記錄的區段類型。 |
deviceMetadata |
選填欄位,要附加到裝置上的中繼資料。 |
preProvisioningToken |
選填欄位,只能針對 Chrome 作業系統裝置進行設定。 |
聯集欄位 customer 。必要欄位。領取裝置的客戶。customer 只能是下列其中一項: |
|
customerId |
領取裝置的客戶 ID。 |
googleWorkspaceCustomerId |
Google Workspace 客戶 ID。 |
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
含有聲明裝置 ID 的回應訊息。
JSON 表示法 |
---|
{ "deviceId": string, "deviceName": string } |
欄位 | |
---|---|
deviceId |
已認領裝置的裝置 ID。 |
deviceName |
裝置的資源名稱,格式為 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidworkprovisioning
詳情請參閱 OAuth 2.0 總覽。