Enterprises

للحصول على قائمة بالأساليب لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.

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

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

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

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

اسم السمة	القيمة	الوصف	ملاحظات
administrator[]	list	مشرفي المؤسسة لا تتوفّر هذه الميزة إلا للمؤسسات التي تم إنشاؤها من خلال العملية التي تبدأها إدارة الخدمات الجوّالة للمؤسسات.
administrator[].email	string	عنوان البريد الإلكتروني الخاص بالمشرف
enterpriseType	string	نوع المؤسسة القِيَم المقبولة هي: "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
id	string	المعرّف الفريد للمؤسسة.
kind	string
managedGoogleDomainType	string	نوع نطاق Google المُدار القِيَم المقبولة هي: "managedGoogleDomainTypeUnspecified" "typeDomain" "typeTeam"
name	string	اسم المؤسسة، مثل "شركة كذا"
primaryDomain	string	النطاق الأساسي للمؤسسة، مثل example.com

الطُرق

acknowledgeNotificationSet

يُستخدَم هذا الإجراء للإشارة إلى الإشعارات التي تم استلامها من Enterprises.PullNotificationSet لمنع المكالمات اللاحقة من عرض الإشعارات نفسها.

completeSignup

يُكمِل عملية الاشتراك من خلال تحديد رمز الاكتمال و رمز المؤسسة. يجب عدم استدعاء هذا الطلب عدة مرات لرمز علامتك التجارية في Enterprise.

createWebToken

تعرض رمزًا فريدًا للوصول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم على الويب، عليك تمرير الرمز المميَّز الذي تم إنشاؤه إلى واجهة برمجة التطبيقات للغة JavaScript في Google Play للأعمال. لا يمكن استخدام كل رمز مميّز إلا لبدء جلسة واحدة لواجهة المستخدم. اطّلِع على مستندات JavaScript API للحصول على مزيد من المعلومات.

تسجيل

تسجيل مؤسسة باستخدام خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) التي تُجري المكالمة

generateSignupUrl

إنشاء عنوان URL للاشتراك

الحصول

استرداد اسم مؤسسة ونطاقها

getServiceAccount

يعرض حساب خدمة وبيانات اعتماد. يمكن ربط حساب الخدمة بالمؤسسة من خلال استدعاء setAccount. يكون حساب الخدمة فريدًا لهذا المؤسّسة وإدارة الخدمات الجوّالة للمؤسسات (EMM)، وسيتم حذفه إذا تم إلغاء ربط المؤسّسة. تحتوي بيانات الاعتماد على بيانات المفتاح الخاص ولا يتم تخزينها على خادم.

لا يمكن استدعاء هذه الطريقة إلا بعد استدعاء methods:‏ Enterprises.Enroll أو Methods:‏ Enterprises.CompleteSignup، وقبل methods:‏ Enterprises.SetAccount، وفي الأوقات الأخرى ستظهر رسالة خطأ.

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

بعد ربط حساب الخدمة بالمؤسسة، يمكن إدارته باستخدام مورد serviceAccountKeys.

getStoreLayout

تعرض تنسيق المتجر للمؤسسة. إذا لم يتم ضبط تنسيق المتجر، يتم عرض "أساسي" كنوع تنسيق المتجر ولا يتم عرض صفحة رئيسية.

list

البحث عن مؤسسة حسب اسم النطاق لا تتوفّر هذه الميزة إلا للمؤسسات التي تم إنشاؤها من خلال عملية الإنشاء التي تبدأها Google. لا يلزم البحث عن رقم التعريف للمؤسسات التي تم إنشاؤها من خلال التدفق الذي يبدأه موفِّر إدارة الخدمات الجوّالة للمؤسسات (EMM)، لأنّ موفِّر إدارة الخدمات الجوّالة للمؤسسات (EMM) يتعرّف على رقم تعريف المؤسسة في الاستدعاء المحدَّد في طلب Enterprises.generateSignupUrl.

pullNotificationSet

تسترجع هذه الوظيفة مجموعة إشعارات للمؤسسات المرتبطة بحساب الخدمة الذي تم مصادقة الطلب من أجله. قد تكون مجموعة الإشعارات فارغة إذا لم تكن هناك إشعارات في انتظار المراجعة.
يجب الردّ على مجموعة الإشعارات التي تم إرجاعها في غضون 20 ثانية من خلال الاتصال بـ Enterprises.AcknowledgeNotificationSet، ما لم تكن مجموعة الإشعارات فارغة.
سيتم في النهاية تضمين الإشعارات التي لم يتم تأكيدها في غضون 20 ثانية مجددًا في الردّ على طلب آخر من نوع PullNotificationSet ، وسيتم حذف الإشعارات التي لم يتم تأكيدها مطلقًا في نهاية المطاف وفقًا لسياسة نظام Pub/Sub في Google Cloud Platform.
قد يتم تنفيذ طلبات متعددة بشكل متزامن لاسترداد الإشعارات، وفي هذه الحالة سيتم хувين الإشعارات في انتظار المراجعة (إن وجدت) بين كل متصل، في حال توفّر أي منها.
في حال عدم توفّر أي إشعارات، يتم عرض قائمة إشعارات فارغة. قد تؤدي الطلبات اللاحقة إلى عرض المزيد من الإشعارات فور توفّرها.

sendTestPushNotification

يُرسِل إشعارًا تجريبيًا للتحقّق من عملية دمج إدارة الخدمات الجوّالة للمؤسسات مع خدمة Google Cloud Pub/Sub لهذه المؤسسة.

setAccount

يضبط الحساب الذي سيتم استخدامه للمصادقة على واجهة برمجة التطبيقات على أنّه المؤسسة.

setStoreLayout

تُستخدَم لضبط تنسيق المتجر للمؤسسة. يكون مَعلمة storeLayoutType مضبوطة تلقائيًا على "أساسية" ويتم تفعيل تنسيق المتجر الأساسي. لا يحتوي التنسيق الأساسي إلا على التطبيقات التي وافق عليها المشرف والتي تمت إضافتها إلى مجموعة المنتجات المتاحة للمستخدم (باستخدام طلب setAvailableProductSet). يتم ترتيب التطبيقات على الصفحة حسب قيمة معرّف المنتج. إذا أنشأت تنسيق متجر مخصّصًا (من خلال ضبط storeLayoutType = "custom" وضبط صفحة رئيسية)، سيتم إيقاف تنسيق المتجر الأساسي.

إلغاء التسجيل

إلغاء تسجيل مؤسسة من خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) التي تتصل