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 للمؤسسات. إذا تضمّن 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

 تعديل مؤسسة