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 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-09 بهوقت ساعت هماهنگ جهانی."],[[["This endpoint claims a device for a customer, adding it to zero-touch enrollment, and returns an error if the device is already claimed by another customer."],["The HTTP request to claim a device is a POST request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim`, requiring the reseller partner's ID in the path parameters."],["The request body must include the `deviceIdentifier`, `sectionType`, and the customer's ID (`customerId` or `googleWorkspaceCustomerId`), along with optional fields such as `deviceMetadata` and `preProvisioningToken` for Chrome OS devices."],["A successful response contains the `deviceId` of the claimed device and its resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`."],["This action requires the OAuth scope `https://www.googleapis.com/auth/androidworkprovisioning` for authorization."]]],["This describes claiming a device for a customer via a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim`. The request requires a `partnerId` and a body specifying the `deviceIdentifier`, `sectionType`, and the customer using either `customerId` or `googleWorkspaceCustomerId`. Optional fields include `deviceMetadata` and `preProvisioningToken`. A successful response includes the claimed `deviceId` and `deviceName`. The operation requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope.\n"]]
