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)

必須。必須。要求するデバイスのデバイス ID。

sectionType

enum (DeviceProvisioningSectionType)

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

deviceMetadata

object (DeviceMetadata)

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

preProvisioningToken

string

省略可。ChromeOS デバイスに対してのみ設定する必要があります。

共用体フィールド 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 の概要をご覧ください。