お客様のデバイスを登録し、ゼロタッチ登録に追加します。デバイスがすでに別のお客様により取得されている場合、呼び出しはエラーを返します。
HTTP リクエスト
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
partnerId |
必須。販売パートナーの ID。 |
リクエスト本文
リクエストの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "deviceIdentifier": { object ( |
フィールド | |
---|---|
deviceIdentifier |
必須。必須。登録するデバイスのデバイス識別子です。 |
sectionType |
必須。デバイスのプロビジョニング レコードのセクションの種類。 |
deviceMetadata |
(省略可)デバイスに添付するメタデータ。 |
preProvisioningToken |
(省略可)Chrome OS デバイスに対してのみ必須で、設定できます。 |
共用体フィールド 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 の概要をご覧ください。