ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM). مزيد من المعلومات

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Enterprises

للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.

تمثيلات الموارد

يمثّل مورد المؤسسات عملية الربط بين إدارة الخدمات الجوّالة للمؤسسات (EMM) ومؤسسة محدَّدة. ويمكن إنشاء مثيل لهذا الربط بإحدى طريقتين مختلفتين باستخدام واجهة برمجة التطبيقات هذه على النحو التالي:

بالنسبة إلى عملاء النطاقات المُدارة من Google، تتضمن العملية استخدام Enterprises.enroll وEnterprises.setAccount (مع العناصر التي تم الحصول عليها من "وحدة تحكُّم المشرف" ووحدة تحكُّم Google API) وإرسالها إلى إدارة الخدمات الجوّالة للمؤسسات (EMM) من خلال عملية يدوية بطريقة أو بأخرى.
بالنسبة إلى عملاء "حسابات Google Play للأعمال"، تتضمّن العملية استخدام Enterprises.generateSignupUrl وEnterprises.completeSignup مع واجهة مستخدم الاشتراك في "Google Play للأعمال" (الآلية التي توفّرها Google) لإنشاء الربط بدون خطوات يدوية.

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

{
  "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: إكمال عملية الاشتراك عن طريق تحديد الرمز المميّز للإكمال والرمز المميز لـ Enterprise. ويجب عدم طلب هذا الطلب عدة مرات لرمز Enterprise معين.
createWebToken: عرض رمزًا مميزًا فريدًا للدخول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم ويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى واجهة برمجة تطبيقات JavaScript في Google Play للأعمال. يمكن استخدام كل رمز مميّز فقط لبدء جلسة واحدة لواجهة المستخدم. يمكنك الاطّلاع على مستندات واجهة برمجة تطبيقات JavaScript للحصول على مزيد من المعلومات.
تسجيل: تسجيل مؤسسة باستخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) للاتصال
generateSignupUrl: ينشئ عنوان URL للاشتراك.
الحصول على: يسترد اسم مؤسسة ونطاقها.
getServiceAccount: إرجاع حساب الخدمة وبيانات الاعتماد يمكن ربط حساب الخدمة بالمؤسسة من خلال استدعاء setAccount. يكون حساب الخدمة فريدًا لهذه المؤسسة ولإدارة الخدمات الجوّالة للمؤسسات (EMM)، وسيتم حذفه في حال إلغاء ربط المؤسسة. تحتوي بيانات الاعتماد على بيانات مفتاح خاص ولا يتم تخزينها من جهة الخادم.

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

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

بعد ربط حساب الخدمة بالمؤسسة، يمكن إدارته باستخدام مورد serviceAccountKeys.
getStoreLayout: عرض تنسيق المتجر للمؤسسة. إذا لم يتم تعيين تخطيط المتجر، فسيتم عرض "أساسي" كنوع تخطيط المتجر وبدون صفحة رئيسية.
list: يبحث عن مؤسسة حسب اسم النطاق. لا يتوفّر هذا إلا للمؤسسات التي تم إنشاؤها من خلال عملية الإنشاء التي بدأتها Google. ولا يلزم البحث عن رقم التعريف للمؤسسات التي تم إنشاؤها من خلال التدفق الذي بدأه إدارة الخدمات الجوّالة للمؤسسات (EMM) لأنّ "إدارة الخدمات الجوّالة للمؤسسات" تتعرّف على رقم تعريف المؤسسة في طلب معاودة الاتصال المحدّد في طلب Enterprises.generateSignupUrl.
pullNotificationSet: يسحب ويعيد الإشعار المضبوط للمؤسسات المرتبطة بحساب الخدمة الذي تمت مصادقته للطلب. قد تكون مجموعة الإشعارات فارغة إذا لم يكن هناك أي إشعارات في انتظار المراجعة.
يجب الموافقة على مجموعة الإشعارات التي تم إرجاعها في غضون 20 ثانية من خلال استدعاء Enterprises.AcknowledgeNotificationSet، ما لم تكن مجموعة الإشعارات فارغة.
في النهاية، سيتم تضمين الإشعارات التي لا يتم قبولها في غضون 20 ثانية في الرد على طلب Pull NotificationSet آخر، وسيتم حذف الإشعارات التي لم يتم قبولها مطلقًا وفقًا لسياسة نظام النشر/الاشتراك في Google Cloud Platform.
قد يتم تنفيذ طلبات متعددة بشكل متزامن لاسترداد الإشعارات، وفي هذه الحالة سيتم تقسيم الإشعارات (إن وجدت) بين كل متصل، إذا كان هناك أي إشعارات معلّقة.
في حال عدم وجود أي إشعارات، سيتم عرض قائمة إشعارات فارغة. قد تعرض الطلبات اللاحقة المزيد من الإشعارات بعد توفُّرها.
sendTestPushNotification: تُرسل إشعارًا تجريبيًا للتحقّق من دمج إدارة الخدمات الجوّالة للمؤسسات (EMM) مع خدمة Google Cloud Pub/Sub لهذه المؤسسة.
setAccount: يضبط هذا الإعداد الحساب الذي سيتم استخدامه للمصادقة على واجهة برمجة التطبيقات باعتبارها المؤسسة.
setStoreLayout: لضبط تنسيق المتجر للمؤسسة. يتم ضبط storeLayoutType تلقائيًا على "أساسي" ويتم تفعيل تخطيط المتجر الأساسي. لا يحتوي التنسيق الأساسي إلا على التطبيقات التي وافق عليها المشرف، والتي تمت إضافتها إلى مجموعة المنتجات المتاحة لمستخدم (باستخدام استدعاء setAvailableProductSet). يتم فرز التطبيقات على الصفحة بترتيب قيمة معرف المنتج. إذا أنشأت تنسيق متجر مخصصًا (من خلال تعيين storeLayoutType = "مخصص" وتعيين صفحة رئيسية)، سيتم إيقاف تخطيط المتجر الأساسي.
إلغاء التسجيل: يؤدي هذا الإجراء إلى إلغاء تسجيل مؤسسة من خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM).