للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
يمثّل مورد Enterprise الربط بين إدارة الخدمات الجوّالة للمؤسسات (EMM) ومؤسسة معيّنة. يمكن إنشاء مثيل لهذا الربط بإحدى الطريقتين المختلفتين باستخدام واجهة برمجة التطبيقات هذه على النحو التالي:
- بالنسبة إلى عملاء النطاقات التي تديرها Google، تتضمّن هذه العملية استخدام
Enterprises.enroll
وEnterprises.setAccount
(إلى جانب العناصر التي تم الحصول عليها من "وحدة تحكُّم المشرف" و"وحدة تحكُّم Google API") وإرسالها إلى إدارة الخدمات الجوّالة للمؤسسات (EMM) من خلال عملية يدوية أكثر أو أقل. - بالنسبة إلى عملاء "حسابات Google Play للأعمال"، تتضمّن هذه العملية استخدام
Enterprises.generateSignupUrl
وEnterprises.completeSignup
مع واجهة مستخدم الاشتراك في "Google Play للأعمال" (الآلية التي توفّرها Google) لإنشاء الربط بدون خطوات يدوية.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
administrator[] |
list |
مشرفو المؤسسة ولا تتوفّر هذه الميزة إلا للمؤسسات التي تم إنشاؤها من خلال التدفق الذي بدأته إدارة الخدمات الجوّالة للمؤسسات (EMM). |
|
administrator[].email |
string |
عنوان البريد الإلكتروني للمشرف. | |
id |
string |
تمثّل هذه السمة المعرّف الفريد للمؤسسة. |
|
kind |
string |
||
name |
string |
اسم المؤسسة، على سبيل المثال، "Example, Inc". | |
primaryDomain |
string |
النطاق الأساسي للمؤسسة، مثل "example.com" |
الطُرق
- acknowledgeNotificationSet
- الإقرار بالإشعارات التي تم تلقّيها من Enterprises.PullNotificationSet لمنع معاودة المكالمات اللاحقة نفس الإشعارات.
- completeSignup
- إكمال عملية الاشتراك عن طريق تحديد الرمز المميز للإكمال الرمز المميّز للمؤسسة يجب عدم استدعاء هذا الطلب عدة مرات لمؤسسة معينة رمز مميز.
- createWebToken
- عرض رمز مميز فريد للوصول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم الويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى JavaScript على "Google Play للأعمال". واجهة برمجة التطبيقات. يمكن استخدام كل رمز مميّز لبدء جلسة واحدة فقط في واجهة المستخدم. يمكنك الاطّلاع على مستندات JavaScript API لمزيد من المعلومات
- تسجيل
- يتم تسجيل مؤسسة تستخدم خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) للاتصال.
- generateSignupUrl
- أنشِئ عنوان URL للاشتراك.
- الحصول على
- استرداد اسم مؤسسة ونطاقها
- getServiceAccount
- عرض حساب الخدمة وبيانات الاعتماد. حساب الخدمة
بالمؤسسة عبر استدعاء setAccount. حساب الخدمة
فريدة لهذه المؤسسة وإدارة الخدمات الجوّالة للمؤسسات (EMM)، وسيتم حذفها إذا كانت المؤسسة
غير محدد. تحتوي بيانات الاعتماد على بيانات مفاتيح خاصة ولا يتم تخزينها.
جانب الخادم.
لا يمكن استدعاء هذه الطريقة إلا بعد استدعاء Enterprises.register أو Enterprises.CompleteSignup, and before Enterprises.SetAccount; وأحيانًا أخرى يعرض خطأ.
ستنشئ المكالمات اللاحقة التي تلي المكالمة الأولى مجموعة جديدة وفريدة من بيانات الاعتماد، وإلغاء صلاحية بيانات الاعتماد التي تم إنشاؤها سابقًا.
بعد ربط حساب الخدمة بالمؤسسة، يمكن إدارته. باستخدام مورد serviceAccountKeys. - getStoreLayout
- عرض تنسيق المتجر للمؤسسة إذا كان تخطيط المتجر لم يتم تعيينه، يعرض "أساسي" كنوع تخطيط المتجر ولا الرئيسية.
- list
- يبحث عن مؤسسة حسب اسم النطاق. ولا يتوفّر ذلك إلا للمؤسسات التي تم إنشاؤها من خلال عملية صناعة المحتوى لا يلزم البحث عن المعرف للمؤسسات التي تم إنشاؤها عبر التدفق الذي بدأته إدارة الخدمات الجوّالة للمؤسسات (EMM) بما أن إدارة الخدمات الجوّالة للمؤسسات تتعرّف على رقم تعريف المؤسسة في رد الاتصال المحدد في طلب Enterprises.generateSignupUrl.
- pullNotificationSet
- يسحب الإشعارات ويرسلها للمؤسسات المرتبطة
حساب الخدمة الذي تمت مصادقته للطلب. قد يتم ضبط الإشعار
يكون فارغًا إذا لم يكن هناك أي إشعار في انتظار المراجعة.
يجب الموافقة على أي مجموعة إشعارات تم إرجاعها في غضون 20 ثانية. من خلال استدعاء Enterprises.AcknowledgeNotificationSet، ما لم مجموعة الإشعارات فارغة.
سيتم عرض الإشعارات التي لا يتم إقرارها خلال 20 ثانية. أن يتم تضمينها في النهاية مرة أخرى في الرد على PullNotificationSet آخر وسيتم حذف تلك التي لم يتم الإقرار بها مطلقًا وفقًا لسياسة نظام النشر/الاشتراك في Google Cloud Platform
يمكن تنفيذ طلبات متعددة بالتزامن لاسترداد الإشعارات، وفي هذه الحالة ستكون الإشعارات التي في انتظار المراجعة (إن وجدت) التقسيم بين كل متصل، إذا كان هناك أي مكالمات معلّقة.
وفي حال عدم وجود أي إشعارات، سيتم عرض قائمة إشعارات فارغة. وقد تعرض الطلبات اللاحقة مزيدًا من الإشعارات بعد أن تصبح المتوفرة. - sendTestPushNotification
- إرسال إشعار اختباري للتحقّق من دمج إدارة الخدمات الجوّالة للمؤسسات (EMM) مع خدمة Google Cloud Pub/Sub لهذه المؤسسة.
- setAccount
- يحدد هذا الإعداد الحساب الذي سيتم استخدامه لمصادقة واجهة برمجة التطبيقات باعتباره للمؤسسات.
- setStoreLayout
- يضبط تنسيق المتجر للمؤسسة. بشكل افتراضي، StoreLayoutType على "أساسي" ويتم تمكين تخطيط المتجر الأساسي. الوظيفة الأساسية يحتوي التنسيق فقط على التطبيقات التي وافق عليها المشرف، والتي لديها إلى مجموعة المنتجات المتاحة لمستخدم (باستخدام setavailableProductSet). يتم فرز التطبيقات على الصفحة بترتيب قيمة معرّف المنتج. إذا أنشأت تخطيط متجر مخصصًا (عن طريق الإعداد storeLayoutType = "custom" وتعيين صفحة رئيسية)، فإن المتجر الأساسي تم إيقاف التصميم.
- إلغاء التسجيل
- إلغاء تسجيل مؤسسة من خدمة "إدارة الخدمات الجوّالة للمؤسسات" للاتصال.