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)
  }
}
الحقول
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).

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),
  "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)

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

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

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

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

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

string

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

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

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

الطُرق

create

ينشئ مؤسسة.

delete

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

get

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

list

يسرد المؤسسات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).

patch

تحديثات مؤسسة.