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

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

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 في أيّ منها، يتم اختيار أول signinDetails من القائمة وضبط 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

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