REST Resource: enterprises

المرجع: Enterprise

الإعدادات المطبَّقة على مؤسسة

تمثيل JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  }
}
الحقول
name

string

اسم المؤسسة الذي ينشئه الخادم أثناء الإنشاء، بالتنسيق enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

أنواع إشعارات Google Pub/Sub المفعَّلة للمؤسسة
pubsubTopic

string

تمثّل هذه السمة الموضوع الذي يتم نشر إشعارات النشر/الاشتراك فيه، ويكون بالتنسيق projects/{project}/topics/{topic}. يكون هذا الحقل مطلوبًا فقط في حال تفعيل إشعارات النشر/الاشتراك.
primaryColor

integer

لون بتنسيق RGB يشير إلى اللون السائد الذي سيتم عرضه في واجهة مستخدم تطبيق إدارة الأجهزة يتم تخزين مكوّنات اللون على النحو التالي: (red << 16) | (green << 8) | blue، حيث تتراوح قيمة كل مكوّن بين 0 و255، شاملةً.
enterpriseDisplayName

string

اسم المؤسسة المعروض للمستخدمين. لا يمكن أن يتألف هذا الحقل من أكثر من 100 حرف.
termsAndConditions[]

object (TermsAndConditions)

الأحكام والشروط التي يجب قبولها عند توفير جهاز لهذه المؤسسة. يتم إنشاء صفحة من العبارات لكل قيمة في هذه القائمة.
appAutoApprovalEnabled
(deprecated)

boolean

تم إيقافها نهائيًا ولم تعُد مستخدمة.
signinDetails[]

object (SigninDetail)

تفاصيل تسجيل الدخول للمؤسسة
contactInfo

object (ContactInfo)

معلومات الاتصال بالمؤسسة التي تديرها خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM).
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

إعدادات مصادقة المستخدم التي تقدّمها Google

NotificationType

أنواع الإشعارات التي قد يرسلها خادم إدارة الأجهزة من خلال Google Pub/Sub

عمليات التعداد
NOTIFICATION_TYPE_UNSPECIFIED يتم تجاهل هذه القيمة.
ENROLLMENT إشعار يتم إرساله عند تسجيل جهاز.
COMPLIANCE_REPORT

تمّ الإيقاف.
STATUS_REPORT إشعار يتم إرساله عندما يُصدر الجهاز تقرير حالة.
COMMAND هو إشعار يتم إرساله عند اكتمال أمر الجهاز.
USAGE_LOGS يتم إرسال إشعار عندما يرسل الجهاز BatchUsageLogEvents.

ExternalData

البيانات المستضافة في موقع جغرافي خارجي من المفترض أن يتم تنزيل البيانات من خلال تطبيق Android Device Policy والتحقّق منها باستخدام التجزئة.

تمثيل JSON 
{
  "url": string,
  "sha256Hash": string
}
الحقول
url

string

عنوان URL المطلق للبيانات، والذي يجب أن يستخدم مخطّط http أو https لا يوفر تطبيق Android Device Policy أي بيانات اعتماد في طلب GET، لذلك يجب أن يكون عنوان URL متاحًا للجميع. قد يتم تضمين مكوّن طويل عشوائي في عنوان URL لمنع المهاجمين من اكتشاف عنوان URL.
sha256Hash

string

تشير هذه السمة إلى تجزئة بترميز SHA-256 بترميز base-64 للمحتوى المستضاف على عنوان URL. إذا لم يتطابق المحتوى مع هذه التجزئة، لن تستخدم سياسة Android Device Policy البيانات.

TermsAndConditions

صفحة الأحكام والشروط التي يجب قبولها أثناء الإعداد

تمثيل JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
الحقول
header

object (UserFacingMessage)

عنوان قصير يظهر أعلى محتوى HTML
content

object (UserFacingMessage)

سلسلة HTML منسقة بشكل جيد وسيتم تحليله على العميل باستخدام android.text.Html#fromHtml.

SigninDetail

مرجع يحتوي على تفاصيل تسجيل الدخول لمؤسسة استخدِم enterprises لإدارة SigninDetail لمؤسسة معيّنة.

بالنسبة إلى المؤسسة، يمكن أن يكون لدينا أي عدد من SigninDetail يتم تحديده بشكل فريد من خلال مجموعة من الحقول الثلاثة التالية (signinUrl وallowPersonalUsage وtokenTag). لا يمكن إنشاء SigninDetailَين بالقيمة نفسها (signinUrl وallowPersonalUsage وtokenTag). (tokenTag هو حقل اختياري).

Patch: تؤدي العملية إلى تعديل القائمة الحالية لـ SigninDetails بالقائمة الجديدة SigninDetails.

  • في حال ضبط إعدادات SigninDetail المُخزَّنة، سيتم عرض قيم signinEnrollmentToken وqrCode نفسها.
  • إذا تم ضبط إعدادات SigninDetail متعددة متطابقة غير محفوظة، سيتم تخزين الإعداد الأول من بين إعدادات SigninDetail هذه.
  • إذا كانت الإعدادات متوفّرة، لا يمكننا طلبها أكثر من مرّة في طلب بيانات معيّن من واجهة برمجة التطبيقات، وإلا سيظهر خطأ مفتاح مكرّر وستتعذّر العملية بأكملها.
  • إذا أزلنا إعدادات SigninDetail معيّنة من الطلب، ستتم إزالتها من مساحة التخزين. يمكننا بعد ذلك طلب signinEnrollmentToken وqrCode آخرَين لإعدادات SigninDetail نفسها.
تمثيل JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
الحقول
signinUrl

string

عنوان URL لتسجيل الدخول للمصادقة عند توفير الجهاز برمز تسجيل دخول. يجب أن تنتهي نقطة نهاية تسجيل الدخول بمسار مصادقة باستخدام عنوان URL على شكل https://enterprise.google.com/android/enroll?et= في حال تسجيل الدخول بنجاح، أو https://enterprise.google.com/android/enroll/invalid في حال تعذُّر تسجيل الدخول.
signinEnrollmentToken

string

رمز مميّز للتسجيل على مستوى المؤسسة يُستخدَم لبدء مسار تسجيل الدخول المخصّص. هذا حقل للقراءة فقط أنشأه الخادم.
qrCode

string

سلسلة JSON يمكن استخدام تمثيل UTF-8 فيها لإنشاء رمز استجابة سريعة لتسجيل جهاز باستخدام هذا الرمز المميّز للتسجيل. لتسجيل جهاز باستخدام NFC، يجب أن يحتوي سجلّ NFC على تمثيل java.util.Properties متسلسل للسمات في ملف JSON. هذا حقل للقراءة فقط يتم إنشاؤه من قِبل الخادم.
allowPersonalUsage

enum (AllowPersonalUsage)

تتحكّم هذه السمة في ما إذا كان مسموحًا بالاستخدام الشخصي على جهاز تم إعداده باستخدام رمز تسجيل هذا الجهاز.

بالنسبة إلى الأجهزة المملوكة للشركة:

  • يتيح تفعيل الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • يتطلّب إيقاف الاستخدام الشخصي من المستخدم إعداد الجهاز كجهاز مُدار بالكامل.

بالنسبة إلى الأجهزة الشخصية:

  • يتيح تفعيل الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • سيؤدي إيقاف الاستخدام الشخصي إلى منع الجهاز من توفير المتطلبات اللازمة. لا يمكن إيقاف الاستخدام الشخصي على جهاز شخصي.
defaultStatus

enum (SigninDetailDefaultStatus)

اختياريّ. لتحديد ما إذا كان يجب استخدام عنوان URL لصفحة تسجيل الدخول تلقائيًا للمؤسسة أم لا. يتم استخدام SigninDetail مع ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT كطريقة تسجيل حساب Google. يمكن ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT في signinDetails واحد فقط من signinDetails المؤسسة. إذا تضمّن Enterprise signinDetails واحدًا على الأقل ولم يتم ضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT، سيتم اختيار أول عنصر من القائمة وضبط defaultStatus على SIGNIN_DETAIL_IS_DEFAULT. إذا لم يتم تحديد signinDetails للEnterprise، سيتعذّر تسجيل الجهاز في حساب Google.
tokenTag

string

بيانات وصفية تحدّدها إدارة الخدمات الجوّالة للمؤسسات (EMM) للتمييز بين نُسخ SigninDetail

SigninDetailDefaultStatus

ما إذا كان يجب استخدام عنوان URL لتسجيل الدخول تلقائيًا للمؤسسة.

عمليات التعداد
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED هذا الرمز مكافئ للرمز SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT سيتم استخدام عنوان URL لتسجيل الدخول تلقائيًا للمؤسسة.
SIGNIN_DETAIL_IS_NOT_DEFAULT لن يتم استخدام عنوان URL لتسجيل الدخول تلقائيًا للمؤسسة.

ContactInfo

تفاصيل الاتصال لمؤسسات "حسابات Google Play للأعمال"

تمثيل JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
الحقول
contactEmail

string

عنوان البريد الإلكتروني لجهة اتصال، وسيتم استخدامه لإرسال إشعارات مهمة متعلقة بميزة "Google Play المُدار".
dataProtectionOfficerName

string

اسم مسؤول حماية البيانات
dataProtectionOfficerEmail

string

عنوان البريد الإلكتروني لمسؤول حماية البيانات تم التحقّق من صحة عنوان البريد الإلكتروني ولكن لم يتم إثبات ملكيته.
dataProtectionOfficerPhone

string

رقم هاتف مسؤول حماية البيانات: تم التحقّق من رقم الهاتف ولكن لم يتم إثبات ملكيته.
euRepresentativeName

string

اسم ممثل الاتحاد الأوروبي
euRepresentativeEmail

string

عنوان البريد الإلكتروني لممثّل الاتحاد الأوروبي تم التحقّق من عنوان البريد الإلكتروني، ولكن لم يتم إثبات ملكيته.
euRepresentativePhone

string

رقم هاتف ممثل الاتحاد الأوروبي تم التحقّق من رقم الهاتف ولكن لم يتم إثبات ملكيته.

GoogleAuthenticationSettings

يحتوي على إعدادات مصادقة المستخدم المقدَّمة من Google.

تمثيل JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
الحقول
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

النتائج فقط. ما إذا كان المستخدمون بحاجة إلى مصادقة Google أثناء عملية التسجيل أم لا. يمكن لمشرف تكنولوجيا المعلومات تحديد ما إذا تم تفعيل مصادقة Google للمؤسسة لأجهزة الموظفين الذين يستند عملهم على المعرفة المكتسبة. لا يمكن ضبط هذه القيمة إلا من خلال "وحدة تحكّم المشرف في Google". يمكن استخدام مصادقة Google مع signinUrl في حال الحاجة إلى مصادقة Google وتحديد signinUrl، سيتم إطلاق مصادقة Google قبل signinUrl.

GoogleAuthenticationRequired

إعداد يحدّد ما إذا كانت مصادقة Google مطلوبة لهذا المؤسّسة.

عمليات التعداد
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED لا يتم استخدام هذه القيمة.
NOT_REQUIRED لا تلزم مصادقة Google.
REQUIRED يجب أن تتم مصادقة المستخدم بنجاح من خلال Google.

الطُرق

create

 إنشاء مؤسسة

delete

 يؤدي هذا الإجراء إلى حذف مؤسسة وجميع الحسابات والبيانات المرتبطة بها نهائيًا.

get

 الحصول على مؤسسة

list

 تعرض هذه القائمة المؤسسات التي تُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).

patch

 تعديلات على مؤسسة