يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يحتوي كل نوع من أنواع الموارد على تمثيل بيانات واحد أو أكثر وطريقة واحدة أو أكثر.
أنواع الموارد
- الأجهزة
- المؤسسات
- الأذونات
- تراخيص المجموعة
- المستخدمون الحاصلون على ترخيص جماعي
- عمليات التثبيت
- عمليات الإعداد المُدارة للجهاز
- عمليات الإعداد المُدارة للمستخدم
- إعدادات الضبط المُدارة
- الأذونات
- المنتجات
- مفاتيح حسابات الخدمة
- مجموعات تنسيق المتاجر
- صفحات تنسيق المتاجر
- المستخدمون
- تطبيقات الويب
الأجهزة
بالنسبة إلى تفاصيل موارد الأجهزة، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| forceReportUpload |
POST /enterprises/enterpriseId/users/userId/devices/deviceId/forceReportUpload
|
يحمِّل تقريرًا يحتوي على أي تغييرات في حالات التطبيق على الجهاز منذ إنشاء آخر تقرير. يمكنك استدعاء هذه الطريقة بمعدل يصل إلى 3 مرات كل 24 ساعة لجهاز معين. |
| الحصول على |
GET /enterprises/enterpriseId/users/userId/devices/deviceId
|
يسترد تفاصيل الجهاز. |
| getState |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
استرداد ما إذا كان قد تم تمكين وصول الجهاز إلى خدمات Google أو إيقافه. لا تسري حالة الجهاز إلا إذا تم تفعيل فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android في "وحدة تحكّم المشرف في Google". وبخلاف ذلك، يتم تجاهل حالة الجهاز ويتم السماح لجميع الأجهزة بالوصول إلى خدمات Google. لا يتوفر هذا إلا للمستخدمين الخاضعين لإدارة Google. |
| list |
GET /enterprises/enterpriseId/users/userId/devices
|
يسترد أرقام تعريف جميع أجهزة المستخدم. |
| setState |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/state
|
تحدِّد هذه السياسة ما إذا كان إمكانية وصول الجهاز إلى خدمات Google مفعَّلة أو غير مفعَّلة. لا تسري حالة الجهاز إلا إذا تم تفعيل فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android في "وحدة تحكّم المشرف في Google". وبخلاف ذلك، يتم تجاهل حالة الجهاز ويتم السماح لجميع الأجهزة بالوصول إلى خدمات Google. لا يتوفر هذا إلا للمستخدمين الخاضعين لإدارة Google. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId
|
تعديلات على سياسة الجهاز.
لضمان فرض السياسة بشكل صحيح، عليك منع الحسابات غير المُدارة من الوصول إلى Google Play من خلال ضبط allowed_accounts في الإعدادات المُدارة لحزمة Google Play. يُرجى الاطّلاع على القسم حظر الحسابات في Google Play.
|
المؤسسات
لمعرفة تفاصيل موارد المؤسسات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| acknowledgeNotificationSet |
POST /enterprises/acknowledgeNotificationSet
|
يتلقى هذا الإشعار الإشعارات التي تم تلقّيها من Enterprises.PullNotificationSet لمنع الاتصالات اللاحقة من عرض الإشعارات نفسها. |
| completeSignup |
POST /enterprises/completeSignup
|
يكمل عملية الاشتراك من خلال تحديد الرمز المميز للإكمال والرمز المميز لـ Enterprise. ويجب عدم طلب هذا الطلب عدة مرات لرمز Enterprise معين. |
| createWebToken |
POST /enterprises/enterpriseId/createWebToken
|
لعرض رمز مميّز فريد للدخول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم ويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى واجهة برمجة تطبيقات JavaScript في Google Play للأعمال. يمكن استخدام كل رمز مميّز فقط لبدء جلسة واحدة لواجهة المستخدم. يمكنك الاطّلاع على مستندات واجهة برمجة تطبيقات JavaScript للحصول على مزيد من المعلومات. |
| تسجيل |
POST /enterprises/enroll
|
تسجيل مؤسسة باستخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) للاتصال
مَعلمات طلب البحث المطلوبة:
|
| generateSignupUrl |
POST /enterprises/signupUrl
|
ينشئ عنوان URL للاشتراك. |
| الحصول على |
GET /enterprises/enterpriseId
|
يسترد اسم مؤسسة ونطاقها. |
| getServiceAccount |
GET /enterprises/enterpriseId/serviceAccount
|
لعرض حساب الخدمة وبيانات الاعتماد. يمكن ربط حساب الخدمة بالمؤسسة من خلال استدعاء setAccount. يكون حساب الخدمة فريدًا لهذه المؤسسة ولإدارة الخدمات الجوّالة للمؤسسات (EMM)، وسيتم حذفه في حال إلغاء ربط المؤسسة. تحتوي بيانات الاعتماد على بيانات مفتاح خاص ولا يتم تخزينها من جهة الخادم.
لا يمكن استدعاء هذه الطريقة إلا بعد طلب Enterprises.enroll أو Enterprises.CompleteSignup، وقبل Enterprises.SetAccount: عرض رسالة خطأ في أحيان أخرى. ستؤدي الطلبات اللاحقة بعد إجراء الطلب الأول إلى إنشاء مجموعة جديدة وفريدة من بيانات الاعتماد، وإلغاء صلاحية بيانات الاعتماد التي تم إنشاؤها سابقًا. بعد ربط حساب الخدمة بالمؤسسة، يمكن إدارته باستخدام مورد serviceAccountKeys. |
| getStoreLayout |
GET /enterprises/enterpriseId/storeLayout
|
تعرض تنسيق المتجر للمؤسسة. إذا لم يتم تعيين تخطيط المتجر، فسيتم عرض "أساسي" كنوع تخطيط المتجر وبدون صفحة رئيسية. |
| list |
GET /enterprises
|
البحث عن مؤسسة حسب اسم النطاق
لا يتوفّر هذا إلا للمؤسسات التي تم إنشاؤها من خلال عملية الإنشاء التي بدأتها Google. ولا يلزم البحث عن رقم التعريف للمؤسسات التي تم إنشاؤها من خلال
التدفق الذي بدأه إدارة الخدمات الجوّالة للمؤسسات (EMM) لأنّ "إدارة الخدمات الجوّالة للمؤسسات" تتعرّف على رقم تعريف المؤسسة في
طلب معاودة الاتصال المحدّد في طلب Enterprises.generateSignupUrl.
مَعلمات طلب البحث المطلوبة:
|
| pullNotificationSet |
POST /enterprises/pullNotificationSet
|
سحب وإرجاع إشعار تم ضبطه للمؤسسات المرتبطة بحساب الخدمة الذي تمت مصادقته للطلب قد تكون مجموعة الإشعارات فارغة
إذا لم يكن هناك أي إشعارات في انتظار المراجعة.
يجب الموافقة على مجموعة الإشعارات التي تم إرجاعها في غضون 20 ثانية من خلال استدعاء Enterprises.AcknowledgeNotificationSet، ما لم تكن مجموعة الإشعارات فارغة. في النهاية، سيتم تضمين الإشعارات التي لا يتم قبولها في غضون 20 ثانية في الرد على طلب Pull NotificationSet آخر، وسيتم حذف الإشعارات التي لم يتم قبولها مطلقًا وفقًا لسياسة نظام النشر/الاشتراك في Google Cloud Platform. قد يتم تنفيذ طلبات متعددة بشكل متزامن لاسترداد الإشعارات، وفي هذه الحالة سيتم تقسيم الإشعارات (إن وجدت) بين كل متصل، إذا كان هناك أي إشعارات معلّقة. في حال عدم وجود أي إشعارات، سيتم عرض قائمة إشعارات فارغة. قد تعرض الطلبات اللاحقة المزيد من الإشعارات بعد توفُّرها. |
| sendTestPushNotification |
POST /enterprises/enterpriseId/sendTestPushNotification
|
يتم إرسال إشعار تجريبي للتحقّق من دمج إدارة الخدمات الجوّالة للمؤسسات (EMM) مع خدمة Google Cloud Pub/Sub لهذه المؤسسة. |
| setAccount |
PUT /enterprises/enterpriseId/account
|
تحدِّد هذه السياسة الحساب الذي سيتم استخدامه للمصادقة على واجهة برمجة التطبيقات باعتبارها المؤسسة. |
| setStoreLayout |
PUT /enterprises/enterpriseId/storeLayout
|
تحدِّد هذه السياسة تنسيق المتجر للمؤسسة. يتم ضبط storeLayoutType تلقائيًا على "أساسي" ويتم تفعيل تخطيط المتجر الأساسي. لا يحتوي التنسيق الأساسي إلا على التطبيقات التي وافق عليها المشرف، والتي تمت إضافتها إلى مجموعة المنتجات المتاحة لمستخدم (باستخدام استدعاء setAvailableProductSet). يتم فرز التطبيقات على الصفحة بترتيب قيمة معرف المنتج. إذا أنشأت تنسيق متجر مخصصًا (من خلال تعيين storeLayoutType = "مخصص" وتعيين صفحة رئيسية)، سيتم إيقاف تخطيط المتجر الأساسي. |
| إلغاء التسجيل |
POST /enterprises/enterpriseId/unenroll
|
إلغاء تسجيل مؤسسة من إدارة الخدمات الجوّالة للمؤسسات (EMM) للاتصال. |
أذونات الوصول إلى الموقع الإلكتروني
لمعرفة تفاصيل مورد الأذونات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
يزيل إذن الوصول إلى تطبيق عن المستخدم. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| الحصول على |
GET /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
يسترد تفاصيل استحقاق. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| list |
GET /enterprises/enterpriseId/users/userId/entitlements
|
يسرد جميع الاستحقاقات للمستخدم المحدّد. يتم ضبط رقم التعريف فقط. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId/entitlements/entitlementId
|
إضافة استحقاق إلى تطبيق أو تحديثه. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
تراخيص جماعية
لمعرفة تفاصيل مورد تراخيص المجموعة، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| الحصول على |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId
|
يسترد تفاصيل الترخيص الجماعي لمؤسسة ما لمنتج. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| list |
GET /enterprises/enterpriseId/groupLicenses
|
يسترد المعرّفات لجميع المنتجات التي حصلت المؤسسة على ترخيص مجموعة لها. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
المستخدمون الحاصلون على ترخيص جماعي
للحصول على تفاصيل موارد Group Licenseusers، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| list |
GET /enterprises/enterpriseId/groupLicenses/groupLicenseId/users
|
يسترد معرّفات المستخدمين الذين تم منحهم استحقاقات بموجب الترخيص. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
عمليات التثبيت
لمعرفة تفاصيل مورد عمليات التثبيت، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
طلبات إزالة تطبيق من جهاز عند الاتصال برقم get أو
list، سيظل التطبيق يظهر على أنّه مثبّت على الجهاز إلى أن
تتم إزالته فعليًا.
|
| الحصول على |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
استرداد تفاصيل تثبيت تطبيق على الجهاز. |
| list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/installs
|
يسترد هذا الإعداد تفاصيل جميع التطبيقات المثبّتة على الجهاز المحدد. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId
|
طلبات تثبيت أحدث إصدار من التطبيق على الجهاز إذا كان التطبيق مثبتًا بالفعل، فسيتم تحديثه إلى أحدث إصدار إذا لزم الأمر. |
عمليات الإعداد المُدارة للجهاز
بالنسبة إلى عمليات الإعداد المُدارة لتفاصيل مورد الجهاز، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
إزالة عملية الضبط المُدارة لكل جهاز لتطبيق معيّن على الجهاز المحدّد |
| الحصول على |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
يسترد تفاصيل الإعداد المُدار لكل جهاز. |
| list |
GET /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice
|
يسرد جميع عمليات الضبط المُدارة لكل جهاز للجهاز المحدّد. يتم ضبط رقم التعريف فقط. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId
|
إضافة أو تعديل إعداد مُدار لكل جهاز على جهاز محدّد. |
عمليات الإعداد المُدارة للمستخدم
بالنسبة إلى عمليات الضبط المُدارة لتفاصيل موارد المستخدم، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
يؤدي هذا الخيار إلى إزالة الإعدادات المُدارة لكل مستخدم لتطبيق معيَّن للمستخدم المحدَّد. |
| الحصول على |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
يسترد تفاصيل الإعداد المُدار لكل مستخدم لتطبيق معيّن للمستخدم المحدّد. |
| list |
GET /enterprises/enterpriseId/users/userId/managedConfigurationsForUser
|
يسرد جميع عمليات الضبط المُدارة لكل مستخدم للمستخدم المحدَّد. يتم تعيين المعرف فقط. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId
|
إضافة إعدادات الضبط المُدارة أو تعديلها لتطبيق معيَّن للمستخدم المحدَّد
إذا كان لديك إطار iframe لعمليات الضبط المُدارة،
يمكنك تطبيق عمليات الضبط المُدارة على مستخدم من خلال تحديد mcmId
ومتغيرات الضبط المرتبطة به (إن وُجدت) في الطلب. بدلاً من ذلك، يمكن لجميع خدمات إدارة الخدمات الجوّالة للمؤسسات (EMM) تطبيق عمليات الضبط المُدارة من خلال تمرير قائمة بالخصائص المُدارة.
|
إعدادات الضبط المُدارة
بالنسبة إلى تفاصيل المورد ضبط الإعدادات المُدارة، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| list |
GET /enterprises/enterpriseId/products/productId/managedConfigurationsSettings
|
يسرد جميع إعدادات عمليات الضبط المُدارة للتطبيق المحدَّد. |
الأذونات
للحصول على تفاصيل موارد الأذونات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| الحصول على |
GET /permissions/permissionId
|
يسترد تفاصيل إذن تطبيق Android للعرض لمشرف المؤسسة. |
المنتجات
للاطّلاع على تفاصيل موارد المنتجات، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| موافقة |
POST /enterprises/enterpriseId/products/productId/approve
|
يوافق على المنتج المحدّد وأذونات التطبيق ذات الصلة، إن توفّرت. الحدّ الأقصى لعدد المنتجات التي يمكنك الموافقة عليها لكل عميل من عملاء المؤسسة هو 1,000 منتج. للتعرّف على كيفية استخدام "Google Play للأعمال" لتصميم وإنشاء تنسيق للمتجر لعرض المنتجات الموافَق عليها للمستخدمين، راجِع تصميم تنسيق المتجر. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| generateApprovalUrl |
POST /enterprises/enterpriseId/products/productId/generateApprovalUrl
|
ينشئ عنوان URL يمكن عرضه في إطار iframe لعرض أذونات (إن وجدت) أحد المنتجات. ويجب على أحد مشرفي المؤسسة الاطّلاع على هذه الأذونات وقبولها نيابةً عن مؤسسته من أجل الموافقة على هذا المنتج. على المشرفين قبول الأذونات المعروضة من خلال التفاعل مع عنصر منفصل في واجهة المستخدم في وحدة تحكّم "إدارة الخدمات الجوّالة للمؤسسات"، ما سيؤدي بدوره إلى تفعيل استخدام عنوان URL هذا بصفته السمة approvalUrlInfo.approvalUrl في طلب "Products.approve" للموافقة على المنتج.
يمكن استخدام عنوان URL هذا فقط لعرض الأذونات لمدة تصل إلى يوم واحد.
ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة.
|
| الحصول على |
GET /enterprises/enterpriseId/products/productId
|
يسترد تفاصيل منتج لعرضها لأحد مشرفي المؤسسة. |
| getAppRestrictionsSchema |
GET /enterprises/enterpriseId/products/productId/appRestrictionsSchema
|
استرداد المخطط الذي يحدد الخصائص القابلة للتهيئة لهذا المنتج. تحتوي جميع المنتجات على مخطط، ولكن قد يكون هذا المخطط فارغًا في حال عدم تحديد أي عمليات ضبط مُدارة. يمكن استخدام هذا المخطط لتعبئة واجهة مستخدم تسمح للمشرف بتهيئة المنتج. لتطبيق عملية ضبط مُدارة بناءً على المخطط الذي تم الحصول عليه باستخدام واجهة برمجة التطبيقات هذه، يُرجى الاطّلاع على عمليات الضبط المُدارة من خلال Play. |
| getPermissions |
GET /enterprises/enterpriseId/products/productId/permissions
|
لاسترداد أذونات تطبيق Android التي يتطلبها هذا التطبيق. |
| list |
GET /enterprises/enterpriseId/products
|
للبحث عن المنتجات المعتمدة التي تطابق طلب البحث، أو جميع المنتجات المعتمدة إذا لم يكن هناك طلب بحث. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| إلغاء الموافقة |
POST /enterprises/enterpriseId/products/productId/unapprove
|
إلغاء الموافقة على المنتج المحدّد (وأذونات التطبيق ذات الصلة، إن توفّرت) ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
مفاتيح حسابات الخدمة
للحصول على تفاصيل موارد Serviceaccountkeys، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/serviceAccountKeys/keyId
|
يزيل بيانات الاعتماد المحددة لحساب الخدمة المرتبط بهذه المؤسسة ويلغي صلاحيتها. يجب أن يكون قد تم استرداد حساب خدمة الاتصال من خلال طلب Enterprises.GetServiceAccount ويجب ضبطه كحساب خدمة المؤسسة من خلال الاتصال بـ Enterprises.SetAccount. |
| إدراج |
POST /enterprises/enterpriseId/serviceAccountKeys
|
تنشئ بيانات اعتماد جديدة لحساب الخدمة المرتبط بهذه المؤسسة. يجب استرداد حساب خدمة الاتصال من خلال طلب البيانات Enterprises.GetServiceAccount ويجب ضبطه كحساب خدمة للمؤسسات من خلال الاتصال بـ Enterprises.SetAccount. يجب ملء نوع المفتاح فقط في المورد المراد إدراجه. |
| list |
GET /enterprises/enterpriseId/serviceAccountKeys
|
يسرد جميع بيانات الاعتماد النشطة لحساب الخدمة المرتبط بهذه المؤسسة. يتم عرض المعرّف ونوع المفتاح فقط. يجب استرداد حساب خدمة الاتصال من خلال طلب Enterprises.GetServiceAccount، ويجب ضبطه كحساب خدمة المؤسسة من خلال الاتصال بـ Enterprises.SetAccount. |
مجموعات تنسيق المتجر
بالنسبة إلى تفاصيل موارد مجموعات Storelayout، راجِع صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
لحذف مجموعة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| الحصول على |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
يسترد تفاصيل المجموعة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| إدراج |
POST /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
يدرج مجموعة جديدة في الصفحة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| list |
GET /enterprises/enterpriseId/storeLayout/pages/pageId/clusters
|
استرداد تفاصيل كافة المجموعات في الصفحة المحددة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| تعديل |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId
|
لتعديل مجموعة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
صفحات تنسيق المتجر
بالنسبة إلى Storelayoutpages تفاصيل الموارد، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/storeLayout/pages/pageId
|
حذف صفحة متجر ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| الحصول على |
GET /enterprises/enterpriseId/storeLayout/pages/pageId
|
يسترد تفاصيل صفحة المتجر. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| إدراج |
POST /enterprises/enterpriseId/storeLayout/pages
|
يدرج صفحة متجر جديدة. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| list |
GET /enterprises/enterpriseId/storeLayout/pages
|
يسترد تفاصيل كل الصفحات في المتجر. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| تعديل |
PUT /enterprises/enterpriseId/storeLayout/pages/pageId
|
تعديل محتوى صفحة المتجر ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
المستخدِمون
بالنسبة إلى تفاصيل موارد المستخدمين، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/users/userId
|
تم حذف مستخدم مُدار بواسطة إدارة الخدمات الجوّالة للمؤسسات (EMM). |
| generateAuthenticationToken |
POST /enterprises/enterpriseId/users/userId/authenticationToken
|
ينشئ رمزًا مميزًا للمصادقة يمكن لبرنامج سياسة الجهاز استخدامه لتوفير
حساب المستخدم المُدار المعيَّن لإدارة الخدمات الجوّالة للمؤسسات على أحد الأجهزة.
الرمز المميّز الذي تم إنشاؤه يُستخدم لمرة واحدة وتنتهي صلاحيته بعد بضع دقائق.
يمكنك توفير المتطلبات اللازمة لما يصل إلى 10 أجهزة لكل مستخدم. لا يمكن إجراء هذه المكالمة إلّا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM). |
| الحصول على |
GET /enterprises/enterpriseId/users/userId
|
لاسترداد تفاصيل المستخدم. |
| getAvailableProductSet |
GET /enterprises/enterpriseId/users/userId/availableProductSet
|
استرداد مجموعة المنتجات التي يحق للمستخدم الوصول إليها. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| إدراج |
POST /enterprises/enterpriseId/users
|
ينشئ مستخدمًا جديدًا مُدارًا لإدارة الخدمات الجوّالة للمؤسسات (EMM).
يجب أن يتضمّن مورد Users (المستخدمون) الذي تم تمريره في نص الطلب accountIdentifier وaccountType.
في حال وجود مستخدم مطابق له معرّف الحساب نفسه،
سيتم تعديل المستخدم باستخدام المورد. في هذه الحالة، يمكن تغيير
الحقل |
| list |
GET /enterprises/enterpriseId/users
|
البحث عن مستخدم حسب عنوان البريد الإلكتروني الرئيسي
لا يتوفر هذا إلا للمستخدمين الخاضعين لإدارة Google. لا يلزم البحث عن المعرف للمستخدمين الخاضعين لإدارة EMM
لأن رقم التعريف قد تم عرضه بالفعل في
نتيجة استدعاء Users.insert.
مَعلمات طلب البحث المطلوبة:
|
| revokeDeviceAccess |
DELETE /enterprises/enterpriseId/users/userId/deviceAccess
|
يؤدي هذا الإجراء إلى إلغاء إمكانية الوصول إلى جميع الأجهزة التي تم توفير المتطلبات اللازمة لها حاليًا للمستخدم. لن يتمكن المستخدم بعد ذلك من استخدام "متجر Play للأعمال" على أي من أجهزته المُدارة.
لا يمكن إجراء هذه المكالمة إلّا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM). |
| setAvailableProductSet |
PUT /enterprises/enterpriseId/users/userId/availableProductSet
|
لتعديل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (يشار إليها باسم منتجات whitelisted). يمكن إضافة المنتجات إلى القائمة البيضاء فقط إذا تمت الموافقة عليها أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تم إبطال الموافقة عليها). ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة. |
| تعديل |
PUT /enterprises/enterpriseId/users/userId
|
تعديل تفاصيل حساب مستخدم يخضع لإدارة الخدمات الجوّالة للمؤسسات (EMM)
يمكن استخدامها مع المستخدمين الخاضعين لإدارة الخدمات الجوّالة للمؤسسات (EMM) فقط (وليس المستخدمين الخاضعين لإدارة Google). مرِّر التفاصيل الجديدة في المورد Users (المستخدمون) في نص الطلب. يمكن تغيير الحقل displayName فقط. ويجب عدم ضبط الحقول الأخرى أو ضبط القيمة النشطة حاليًا
|
تطبيقات الويب
بالنسبة إلى تفاصيل موارد Webapps، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) الخاصة بـ https://www.googleapis.com/androidenterprise/v1، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /enterprises/enterpriseId/webApps/webAppId
|
لحذف تطبيق ويب حالي. |
| الحصول على |
GET /enterprises/enterpriseId/webApps/webAppId
|
الحصول على تطبيق ويب حالي. |
| إدراج |
POST /enterprises/enterpriseId/webApps
|
ينشئ تطبيق ويب جديدًا للمؤسسة. |
| list |
GET /enterprises/enterpriseId/webApps
|
يسترد تفاصيل جميع تطبيقات الويب لمؤسسة معيّنة. |
| تعديل |
PUT /enterprises/enterpriseId/webApps/webAppId
|
لتحديث تطبيق ويب حالي. |