Android Device Provisioning Partner API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح واجهة برمجة التطبيقات لعملاء الأجهزة الجوّالة ومقدّمي إدارة الخدمات الجوّالة للمؤسسات (EMM) إدارة برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" آليًا.
الخدمة: androiddevicemanaged.googleapis.com
لطلب هذه الخدمة، ننصحك باستخدام مكتبات البرامج التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، استخدِم المعلومات التالية عند تقديم طلبات البيانات من واجهة برمجة التطبيقات.
مستند Discovery
مستند الاكتشاف هو مواصفة يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. يُستخدم لإنشاء مكتبات للعملاء، ومكونات IDE الإضافية، وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات استكشاف متعددة. توفّر هذه الخدمة مستند Discovery التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تحتوي خدمة واحدة على عدة نقاط نهاية للخدمة. تشتمل هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط جميع معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:
https://androiddeviceprovisioning.googleapis.com
| الطُرق |
list |
GET /v1/customers
يسرد حسابات العملاء التابعة للمستخدم. |
| الطُرق |
create |
POST /v1/{parent=customers/*}/configurations
تنشئ عملية ضبط جديدة. |
delete |
DELETE /v1/{name=customers/*/configurations/*}
يؤدي هذا الإجراء إلى حذف إعدادات غير مستخدَمة. |
get |
GET /v1/{name=customers/*/configurations/*}
الحصول على تفاصيل عملية الضبط. |
list |
GET /v1/{parent=customers/*}/configurations
يسرد إعدادات العميل. |
patch |
PATCH /v1/{configuration.name=customers/*/configurations/*}
تُعدِّل قيم حقول الإعدادات. |
| الطُرق |
applyConfiguration |
POST /v1/{parent=customers/*}/devices:applyConfiguration
تطبِّق هذه السياسة إعدادًا على الجهاز لتسجيل الجهاز في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". |
get |
GET /v1/{name=customers/*/devices/*}
الحصول على تفاصيل الجهاز. |
list |
GET /v1/{parent=customers/*}/devices
يسرد أجهزة العميل. |
removeConfiguration |
POST /v1/{parent=customers/*}/devices:removeConfiguration
إزالة إعدادات من الجهاز |
unclaim |
POST /v1/{parent=customers/*}/devices:unclaim
يلغي العميل المطالبة بملكية جهاز ويزيله من "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". |
| الطُرق |
list |
GET /v1/{parent=customers/*}/dpcs
يسرد وحدات التحكّم بسياسة الجهاز (DPC) التي تتيح برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API enables mobile device customers and EMMs to manage zero-touch enrollment programmatically.\u003c/p\u003e\n"],["\u003cp\u003eThe service utilizes REST resources including \u003ccode\u003ev1.customers\u003c/code\u003e, \u003ccode\u003ev1.customers.configurations\u003c/code\u003e, \u003ccode\u003ev1.customers.devices\u003c/code\u003e, and \u003ccode\u003ev1.customers.dpcs\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides various methods to manage customer accounts, configurations, and devices, including creating, deleting, listing, and updating configurations.\u003c/p\u003e\n"],["\u003cp\u003eDevice management includes applying and removing configurations, getting device details, and unclaiming devices from zero-touch enrollment.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for this API is \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com\u003c/code\u003e, and it offers a discovery document for building client libraries.\u003c/p\u003e\n"]]],["The API allows managing zero-touch enrollment for mobile devices. It provides resources for `customers`, `configurations`, `devices`, and `dpcs`. Key actions include: listing customer accounts and DPCs; creating, deleting, getting, listing, and updating configurations; and applying or removing configurations from devices, along with getting device details, listing them and removing them from the zero-touch enrollment process. These resources use `GET`, `POST`, `DELETE` and `PATCH` to manage data.\n"],null,["# Android Device Provisioning Partner API\n\nThe API lets mobile device customers and EMMs programmatically manage zero-touch enrollment.\n\n- [REST Resource: v1.customers](#v1.customers)\n- [REST Resource: v1.customers.configurations](#v1.customers.configurations)\n- [REST Resource: v1.customers.devices](#v1.customers.devices)\n- [REST Resource: v1.customers.dpcs](#v1.customers.dpcs)\n\nService: androiddeviceprovisioning.googleapis.com\n-------------------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://androiddeviceprovisioning.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://androiddeviceprovisioning.googleapis.com`\n\nREST Resource: [v1.customers](/zero-touch/reference/customer/rest/v1/customers)\n-------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------|---------------------------------------------------------|\n| [list](/zero-touch/reference/customer/rest/v1/customers/list) | `GET /v1/customers` Lists the user's customer accounts. |\n\nREST Resource: [v1.customers.configurations](/zero-touch/reference/customer/rest/v1/customers.configurations)\n-------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|\n| [create](/zero-touch/reference/customer/rest/v1/customers.configurations/create) | `POST /v1/{parent=customers/*}/configurations` Creates a new configuration. |\n| [delete](/zero-touch/reference/customer/rest/v1/customers.configurations/delete) | `DELETE /v1/{name=customers/*/configurations/*}` Deletes an unused configuration. |\n| [get](/zero-touch/reference/customer/rest/v1/customers.configurations/get) | `GET /v1/{name=customers/*/configurations/*}` Gets the details of a configuration. |\n| [list](/zero-touch/reference/customer/rest/v1/customers.configurations/list) | `GET /v1/{parent=customers/*}/configurations` Lists a customer's configurations. |\n| [patch](/zero-touch/reference/customer/rest/v1/customers.configurations/patch) | `PATCH /v1/{configuration.name=customers/*/configurations/*}` Updates a configuration's field values. |\n\nREST Resource: [v1.customers.devices](/zero-touch/reference/customer/rest/v1/customers.devices)\n-----------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| [applyConfiguration](/zero-touch/reference/customer/rest/v1/customers.devices/applyConfiguration) | `POST /v1/{parent=customers/*}/devices:applyConfiguration` Applies a Configuration to the device to register the device for zero-touch enrollment. |\n| [get](/zero-touch/reference/customer/rest/v1/customers.devices/get) | `GET /v1/{name=customers/*/devices/*}` Gets the details of a device. |\n| [list](/zero-touch/reference/customer/rest/v1/customers.devices/list) | `GET /v1/{parent=customers/*}/devices` Lists a customer's devices. |\n| [removeConfiguration](/zero-touch/reference/customer/rest/v1/customers.devices/removeConfiguration) | `POST /v1/{parent=customers/*}/devices:removeConfiguration` Removes a configuration from device. |\n| [unclaim](/zero-touch/reference/customer/rest/v1/customers.devices/unclaim) | `POST /v1/{parent=customers/*}/devices:unclaim` Unclaims a device from a customer and removes it from zero-touch enrollment. |\n\nREST Resource: [v1.customers.dpcs](/zero-touch/reference/customer/rest/v1/customers.dpcs)\n-----------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| [list](/zero-touch/reference/customer/rest/v1/customers.dpcs/list) | `GET /v1/{parent=customers/*}/dpcs` Lists the DPCs (device policy controllers) that support zero-touch enrollment. |"]]
