Enterprises

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

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

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

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