Enterprises

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

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

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

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

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

لا يمكن استدعاء هذه الطريقة إلا بعد استدعاء Enterprises.Enroll أو Enterprises.CompleteSignup، وقبل 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) التي تتصل