Method: partners.devices.claim

お客様のデバイスを登録し、ゼロタッチ登録に追加します。デバイスがすでに別のお客様により取得されている場合、呼び出しはエラーを返します。

HTTP リクエスト

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
partnerId

string (int64 format)

必須。販売パートナーの ID。

リクエスト本文

リクエストの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
フィールド
deviceIdentifier

object (DeviceIdentifier)

必須。必須。登録するデバイスのデバイス識別子です。
sectionType

enum (DeviceProvisioningSectionType)

必須。デバイスのプロビジョニング レコードのセクションの種類。
deviceMetadata

object (DeviceMetadata)

（省略可）デバイスに添付するメタデータ。
preProvisioningToken

string

（省略可）Chrome OS デバイスに対してのみ必須で、設定できます。
共用体フィールド customer。必須。デバイスを申請するお客様。customer は次のいずれかになります。
customerId

string (int64 format)

デバイスを申請するお客様の ID。
googleWorkspaceCustomerId

string

Google Workspace のお客様 ID。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

申し立てのデバイス ID を含むレスポンス メッセージ。

JSON 表現 
{
  "deviceId": string,
  "deviceName": string
}
フィールド
deviceId

string (int64 format)

申請されたデバイスのデバイス ID。
deviceName

string

デバイスのリソース名。partners/[PARTNER_ID]/devices/[DEVICE_ID] の形式で指定します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/androidworkprovisioning

詳しくは、OAuth 2.0 の概要をご覧ください。