Enterprises

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

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

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

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
اسم السمة القيمة الوصف ملاحظات
administrator[] list مشرفو المؤسسة لا تتوفّر هذه الميزة إلا للمؤسسات التي تم إنشاؤها من خلال سير العمل الذي بدأته "إدارة الخدمات الجوّالة للمؤسسات".

administrator[].email string عنوان البريد الإلكتروني للمشرف
enterpriseType string تمثّل هذه السمة نوع المؤسسة.

القيم المقبولة هي:
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings nested object إعدادات مصادقة المستخدم التي توفّرها Google
googleAuthenticationSettings.createdAt nested object الطابع الزمني لوقت إنشاء الإعدادات أو تعديلها لأول مرة
googleAuthenticationSettings.createdAt.nanos integer أجزاء غير سالبة من الثانية بدقة النانو ثانية يجب أن تتضمّن قيم الثواني السالبة التي تتضمّن كسورًا قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك الرقمان.
googleAuthenticationSettings.createdAt.seconds long تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة Unix في 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين 0001-01-01T00:00:00Z و9999-12-31T23:59:59Z ضِمنًا.
googleAuthenticationSettings.dedicatedDevicesAllowed string تُستخدَم لتحديد ما إذا كان يُسمح باستخدام الأجهزة المخصّصة.

القيم المقبولة هي:
  • "allowed"
  • "dedicatedDevicesAllowedUnspecified"
  • "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired string توضّح هذه السمة ما إذا كانت مصادقة Google مطلوبة.

القيم المقبولة هي:
  • "googleAuthenticationRequiredUnspecified"
  • "notRequired"
  • "required"
googleAuthenticationSettings.updatedAt nested object الطابع الزمني لآخر تعديل تم إجراؤه على الإعدادات
googleAuthenticationSettings.updatedAt.nanos integer أجزاء غير سالبة من الثانية بدقة النانو ثانية يجب أن تتضمّن قيم الثواني السالبة التي تتضمّن كسورًا قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك الرقمان.
googleAuthenticationSettings.updatedAt.seconds long تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة Unix في 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين 0001-01-01T00:00:00Z و9999-12-31T23:59:59Z ضِمنًا.
id string المعرّف الفريد للمؤسسة.

id string المعرّف الفريد للمؤسسة.

kind string
managedGoogleDomainType string نوع نطاق Google المُدار

القيم المقبولة هي:
  • "managedGoogleDomainTypeUnspecified"
  • "typeDomain"
  • "typeTeam"
name string اسم المؤسسة، مثل "شركة كذا"
primaryDomain string النطاق الأساسي للمؤسسة، مثل "example.com".

الطُرق

acknowledgeNotificationSet
تعترف هذه السمة بالإشعارات التي تم تلقّيها من Enterprises.PullNotificationSet لمنع المكالمات اللاحقة من عرض الإشعارات نفسها.
completeSignup
تُكمل عملية الاشتراك من خلال تحديد رمز الإكمال ورمز المؤسسة. يجب عدم استدعاء هذا الطلب عدة مرات لرمز Enterprise Token معيّن.
createWebToken
تعرض هذه الدالة رمزًا مميزًا فريدًا للوصول إلى واجهة مستخدم قابلة للتضمين. لإنشاء واجهة مستخدم على الويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى واجهة برمجة تطبيقات JavaScript الخاصة بـ "Google Play للأعمال". يمكن استخدام كل رمز مميّز لبدء جلسة واحدة فقط لواجهة المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات JavaScript API.
enroll
تسجيل مؤسسة باستخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) التي تتيح إجراء المكالمات
generateEnterpriseUpgradeUrl
تنشئ عنوان URL لترقية المؤسسة من أجل ترقية مؤسسة "حسابات Google Play للأعمال" الحالية إلى نطاق Google خاضع للإدارة. يمكنك الاطّلاع على دليل ترقية حساب مؤسسة للحصول على مزيد من التفاصيل.
generateSignupUrl
تنشئ عنوان URL للاشتراك.
الحصول على
يستردّ اسم المؤسسة ونطاقها.
getServiceAccount
تعرض هذه الطريقة حساب خدمة وبيانات اعتماد. يمكن ربط حساب الخدمة بالمؤسسة من خلال استدعاء setAccount. حساب الخدمة فريد لهذه المؤسسة وإدارة الخدمات الجوّالة للمؤسسات، وسيتم حذفه إذا تم إلغاء ربط المؤسسة. تحتوي بيانات الاعتماد على بيانات المفتاح الخاص ولا يتم تخزينها على الخادم.

لا يمكن استدعاء هذه الطريقة إلا بعد استدعاء 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
إرسال إشعار تجريبي للتحقّق من صحة عملية دمج إدارة الخدمات الجوّالة للمؤسسات (EMM) مع خدمة Google Cloud Pub/Sub لهذه المؤسسة
setAccount
تضبط هذه السمة الحساب الذي سيتم استخدامه للمصادقة على واجهة برمجة التطبيقات بصفتها مؤسسة.
setStoreLayout
تضبط هذه السمة تخطيط المتجر للمؤسسة. يكون storeLayoutType مضبوطًا تلقائيًا على "basic" ويتم تفعيل تصميم المتجر الأساسي. لا يحتوي التنسيق الأساسي إلا على التطبيقات التي وافق عليها المشرف وتمت إضافتها إلى مجموعة المنتجات المتاحة للمستخدم (باستخدام طلب setAvailableProductSet). يتم ترتيب التطبيقات على الصفحة حسب قيمة معرّف المنتج. إذا أنشأت تنسيق متجر مخصّصًا (من خلال ضبط storeLayoutType = "custom" وإعداد صفحة رئيسية)، سيتم إيقاف تنسيق المتجر الأساسي.
إلغاء التسجيل
إلغاء تسجيل مؤسسة من موفِّر إدارة الخدمات الجوّالة للمؤسسات (EMM) الذي يتيح إجراء المكالمات