Method: partners.devices.claim

دستگاهی را برای مشتری ادعا می کند و آن را به ثبت نام بدون لمس اضافه می کند. اگر دستگاه قبلاً توسط مشتری دیگری ادعا شده باشد، تماس با خطا مواجه می شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
partnerId

string ( int64 format)

ضروری. شناسه شریک فروشنده.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 تنظیم شود.

customer میدان اتحادیه ضروری. مشتری که دستگاه برای او ادعا شده است. customer فقط می تواند یکی از موارد زیر باشد:
customerId

string ( int64 format)

شناسه مشتری که دستگاه برای او ادعا شده است.

googleWorkspaceCustomerId

string

شناسه مشتری Google Workspace.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پیام پاسخ حاوی شناسه دستگاه ادعا.

نمایندگی JSON
{
  "deviceId": string,
  "deviceName": string
}
زمینه های
deviceId

string ( int64 format)

شناسه دستگاه دستگاه مورد ادعا.

deviceName

string

نام منبع دستگاه در قالب partners/[PARTNER_ID]/devices/[DEVICE_ID] .

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.