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 مراجعه کنید.