API Reference

يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. لكل نوع من أنواع الموارد تمثيل بيانات واحد أو أكثر وطريقة واحدة أو أكثر.

أنواع الموارد

  1. الأجهزة
  2. المؤسسات
  3. الأذونات
  4. تراخيص المجموعة
  5. المستخدمون الحاصلون على ترخيص المجموعة
  6. عمليات التثبيت
  7. الإعدادات المُدارة للجهاز
  8. الإعدادات المُدارة للمستخدم
  9. إعدادات الضبط المُدار
  10. الأذونات
  11. المنتجات
  12. مفاتيح حسابات الخدمة
  13. مجموعات تخطيط المتجر
  14. صفحات تخطيط المتجر
  15. المستخدمون
  16. تطبيقات الويب

الأجهزة

لمعرفة تفاصيل "مورد الأجهزة"، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب 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 المميز.
createWebToken POST  /enterprises/enterpriseId/createWebToken تعرض رمزًا مميزًا فريدًا للوصول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم ويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى واجهة برمجة تطبيقات JavaScript للأعمال في Google Play. يمكن استخدام كل رمز مميّز لبدء جلسة واحدة فقط في واجهة المستخدم. راجِع مستندات JavaScript API للحصول على مزيد من المعلومات.
تسجيل POST  /enterprises/enroll لتسجيل مؤسسة باستخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) للاتصال.

مَعلمات طلب البحث المطلوبة: token

generateSignupUrl POST  /enterprises/signupUrl إنشاء عنوان URL للاشتراك.
الحصول على GET  /enterprises/enterpriseId لاسترداد اسم المؤسسة ونطاقها.
getServiceAccount GET  /enterprises/enterpriseId/serviceAccount تعرض حساب الخدمة وبيانات الاعتماد. يمكن ربط حساب الخدمة بالمؤسسة من خلال استدعاء setAccount. حساب الخدمة فريد لهذه المؤسسة وإدارة الخدمات الجوّالة للمؤسسات (EMM)، وسيتم حذفه إذا كانت المؤسسة غير مرتبطة. وتحتوي بيانات الاعتماد على بيانات المفتاح الخاص ولا يتم تخزينها من جهة الخادم.

لا يمكن طلب هذه الطريقة إلا بعد طلب البيانات Enterprise.registered أو Enterprises.CompleteSignup وقبل Enterprises.SetAccount، ستظهر رسالة خطأ في أحيان أخرى.

ستؤدي الطلبات اللاحقة التي تلي الاتصال الأول إلى إنشاء مجموعة جديدة وفريدة من بيانات الاعتماد، وإبطال بيانات الاعتماد التي تم إنشاؤها سابقًا.

بعد ربط حساب الخدمة بالمؤسسة، يمكن إدارته باستخدام مورد serviceAccountKeys.
getStoreLayout GET  /enterprises/enterpriseId/storeLayout تعرض تنسيق المتجر للمؤسسة. إذا لم يتم ضبط تصميم المتجر، يعرض "أساسي" كنوع تخطيط المتجر وليس صفحة رئيسية.
list GET  /enterprises يبحث عن مؤسسة حسب اسم النطاق. لا يتوفّر هذا الخيار إلا للمؤسسات التي تم إنشاؤها من خلال عملية الإنشاء التي بدأتها Google. ولا حاجة إلى البحث عن رقم التعريف للمؤسسات التي تم إنشاؤها من خلال المسار الذي بدأه "إدارة الخدمات الجوّالة للمؤسسات" لأنّ "إدارة الخدمات الجوّالة للمؤسسات" تتعرّف على رقم تعريف المؤسسة من خلال طلب معاودة الاتصال المحدد في طلب Enterprises.generateSignupUrl.

مَعلمات طلب البحث المطلوبة: domain

pullNotificationSet POST  /enterprises/pullNotificationSet لسحب وإرسال إشعار محدد للمؤسسات المرتبطة بحساب الخدمة الذي تمت مصادقته للطلب. قد تكون مجموعة الإشعارات فارغة إذا لم يكن هناك أي إشعار في انتظار المراجعة.
يجب الإقرار باستلام مجموعة الإشعارات التي تم إرجاعها في غضون 20 ثانية من خلال استدعاء Enterprises.AcknowledgeNotificationSet، ما لم يتم ضبط الإشعارات فارغة.
وسيتم تضمين الإشعارات التي لا تتم الموافقة عليها خلال 20 ثانية مرة أخرى في الرد على طلب PullNotificationSet آخر. وسيتم في النهاية حذف الإشعارات التي لا يتم الإقرار بها مطلقًا وفقًا لسياسة نظام النشر/الاشتراك في 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 = "custom" وتعيين صفحة رئيسية)، فسيتم إيقاف تنسيق المتجر الأساسي.
إلغاء التسجيل POST  /enterprises/enterpriseId/unenroll يؤدي إلى إلغاء تسجيل مؤسسة من خدمة "إدارة الخدمات الجوّالة للمؤسسات" للاتصال.

الأذونات

لمعرفة تفاصيل مورِّد الأذونات، يُرجى الاطّلاع على صفحة تمثيل المورد.

الطريقة طلب 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 استرداد معرّفات جميع المنتجات التي تمتلك المؤسسة ترخيصًا جماعيًا لها ملاحظة: تم إيقاف هذا العنصر نهائيًا. ولا يمكن أن تستخدم عمليات الدمج الجديدة هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة.

مستخدمو ترخيص المجموعة

لمعرفة تفاصيل المورد لمستخدِمي ترخيص المجموعة، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب 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 لعرض أذونات منتج (إن توفّرت). على مشرف المؤسسة عرض هذه الأذونات وقبولها نيابةً عن مؤسسته من أجل الموافقة على هذا المنتج.

على المشرفين قبول الأذونات المعروضة من خلال التفاعل مع عنصر منفصل لواجهة المستخدم في وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM)، ما يؤدي بدوره إلى تفعيل استخدام عنوان 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 تنشئ بيانات اعتماد جديدة لحساب الخدمة المرتبط بهذه المؤسسة. يجب استرداد حساب خدمة الاتصال عن طريق استدعاء Enterprise.GetServiceAccount، كما يجب ضبطه كحساب خدمة المؤسسة من خلال طلب البيانات Enterprises.SetAccount.

يجب ملء نوع المفتاح فقط في المورد المطلوب إدراجه.
list GET  /enterprises/enterpriseId/serviceAccountKeys يسرد جميع بيانات الاعتماد النشطة لحساب الخدمة المرتبط بهذه المؤسسة. يتم عرض رقم التعريف ونوع المفتاح فقط. يجب استرداد حساب خدمة الاتصال عن طريق استدعاء Enterprises.GetServiceAccount، ويجب ضبطه كحساب خدمة المؤسسة من خلال طلب البيانات Enterprises.SetAccount.

مجموعات تنسيقات المتجر

لمعرفة تفاصيل موارد Storelayoutclusters، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة طلب 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 تنشئ رمزًا مميزًا للمصادقة يمكن لعميل سياسة الجهاز استخدامه لتوفير حساب المستخدم المعني المُدار لإدارة الخدمات الجوّالة للمؤسسات (EMM) على أحد الأجهزة. الرمز المميّز الذي تم إنشاؤه للاستخدام مرة واحدة وتنتهي صلاحيته بعد بضع دقائق.

يمكنك توفير المتطلبات اللازمة لما يصل إلى 10 أجهزة لكل مستخدم.

لا تعمل هذه المكالمة إلا مع الحسابات المُدارة من خلال "إدارة الخدمات الجوّالة للمؤسسات" (EMM).
الحصول على GET  /enterprises/enterpriseId/users/userId لاسترداد تفاصيل المستخدم.
getAvailableProductSet GET  /enterprises/enterpriseId/users/userId/availableProductSet استرداد مجموعة المنتجات التي يحق للمستخدم الوصول إليها.
إدراج POST  /enterprises/enterpriseId/users إنشاء مستخدم جديد مُدار لإدارة الخدمات الجوّالة للمؤسسات (EMM).

يجب أن يشتمل مورد Users الذي تم تمريره في نص الطلب على accountIdentifier وaccountType.

إذا كان هناك مستخدم مطابق بالفعل بمعرّف الحساب نفسه، فسيتم تحديث المستخدم بالمورد. في هذه الحالة، يمكن تغيير الحقل displayName فقط.

list GET  /enterprises/enterpriseId/users يبحث عن مستخدم من خلال عنوان البريد الإلكتروني الرئيسي. ولا تتوفّر هذه الميزة إلا للمستخدمين الخاضعين لإدارة Google. ولا حاجة إلى البحث عن المعرّف للمستخدمين الذين تديرهم إدارة الخدمات الجوّالة للمؤسسات (EMM) لأنه يتم عرض المعرّف مسبقًا في نتيجة استدعاء User.insert.

مَعلمات طلب البحث المطلوبة: email

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). مرِّر التفاصيل الجديدة في مورد المستخدمون في نص الطلب. يمكن تغيير الحقل 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 يحدّث تطبيق ويب حالي.