Method: partners.devices.claimAsync
دسته ای از دستگاه ها را برای مشتری به صورت ناهمزمان ادعا می کند. دستگاه ها را به ثبت نام بدون لمس اضافه می کند. برای کسب اطلاعات بیشتر، عملیات دسته ای طولانی را بخوانید.
درخواست HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
partnerId | string ( int64 format) مورد نیاز. شناسه شریک فروشنده. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
claims[] | object ( PartnerClaim ) مورد نیاز. لیستی از ادعاهای دستگاه |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidworkprovisioning
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
ادعای شریک
یک درخواست ادعا را شناسایی می کند.
نمایندگی 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. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-09 بهوقت ساعت هماهنگ جهانی."],[[["This endpoint `POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync` enables partners to asynchronously claim a batch of devices for a customer, adding them to zero-touch enrollment."],["The request requires a `partnerId` path parameter, which is the reseller partner's ID, and a request body with a list of device claims within the `claims` field."],["Each device claim is identified by a `PartnerClaim` object, which contains the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and a customer identifier in the form of `customerId` or `googleWorkspaceCustomerId`."],["The `PartnerClaim` object optionally includes a `preProvisioningToken` and is required to complete the request."],["A successful request returns an `Operation` object, indicating that the long-running operation has been initiated."]]],["This outlines how to claim devices for a customer asynchronously via the Android zero-touch enrollment API. Use a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync`, providing the required `partnerId`. The request body, structured in JSON, includes a list of device `claims` with each claim containing the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and the required customer's ID (`customerId` or `googleWorkspaceCustomerId`). The `preProvisioningToken` field is required only for ChromeOS devices. The response body contains an `Operation`.\n"]]