REST Resource: enterprises

{
  "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)
  }
}

string

نام شرکتی که در حین ایجاد توسط سرور تولید می‌شود، به شکل enterprises/{enterpriseId} .

enum ( NotificationType )

انواع اعلان‌های Google Pub/Sub فعال شده برای شرکت.

string

موضوعی که اعلان‌های Pub/Sub به شکل projects/{project}/topics/{topic} برای آن منتشر می‌شوند. این فیلد فقط در صورتی لازم است که اعلان‌های Pub/Sub فعال باشند .

integer

رنگی با فرمت RGB که نشان دهنده رنگ غالب برای نمایش در رابط کاربری برنامه مدیریت دستگاه است. اجزای رنگ به صورت زیر ذخیره می شوند: (red << 16) | (green << 8) | blue ، که در آن مقدار هر جزء بین 0 تا 255 است.

object ( ExternalData )

تصویری که به عنوان لوگو در حین تهیه دستگاه نمایش داده می شود. انواع پشتیبانی شده عبارتند از: image/bmp، image/gif، image/x-ico، image/jpeg، image/png، image/webp، image/vnd.wap.wbmp، image/x-adobe-dng.

string

نام شرکتی که به کاربران نمایش داده می شود. حداکثر طول این فیلد 100 کاراکتر است.

object ( TermsAndConditions )

شرایط و ضوابطی که باید هنگام تهیه دستگاه برای این شرکت پذیرفته شود. یک صفحه از اصطلاحات برای هر مقدار در این لیست ایجاد می شود.

boolean

منسوخ و استفاده نشده.

object ( SigninDetail )

جزئیات ورود به سیستم شرکت

object ( ContactInfo )

اطلاعات تماس سازمانی یک شرکت تحت مدیریت EMM.

object ( GoogleAuthenticationSettings )

تنظیمات برای احراز هویت کاربر ارائه شده توسط Google.

{
  "url": string,
  "sha256Hash": string
}

string

URL مطلق به داده ها، که باید از طرح http یا https استفاده کند. خط‌مشی دستگاه Android هیچ اعتباری را در درخواست GET ارائه نمی‌کند، بنابراین URL باید برای عموم قابل دسترسی باشد. گنجاندن یک جزء طولانی و تصادفی در URL ممکن است برای جلوگیری از کشف URL توسط مهاجمان استفاده شود.

string

Bas-64 هش SHA-256 محتوای میزبانی شده در url را رمزگذاری کرد. اگر محتوا با این هش مطابقت نداشته باشد، خط‌مشی دستگاه Android از داده‌ها استفاده نخواهد کرد.

{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}

object ( UserFacingMessage )

یک هدر کوتاه که در بالای محتوای HTML ظاهر می شود.

object ( UserFacingMessage )

یک رشته HTML با فرمت مناسب. در کلاینت با android.text.Html#fromHtml تجزیه خواهد شد.

{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}

string

URL ورود به سیستم برای احراز هویت زمانی که دستگاه دارای کد ثبت نام ورود به سیستم است. نقطه پایانی ورود به سیستم باید جریان احراز هویت را با یک URL به شکل https://enterprise.google.com/android/enroll?et= به پایان برساند. برای ورود موفقیت آمیز، یا https://enterprise.google.com/android/enroll/invalid برای ورود ناموفق.

string

یک رمز ثبت نام گسترده سازمانی که برای راه اندازی جریان ورود به سیستم سفارشی استفاده می شود. این یک فیلد فقط خواندنی است که توسط سرور ایجاد شده است.

string

یک رشته JSON که نمایش UTF-8 آن می تواند برای ایجاد یک کد QR برای ثبت دستگاه با این نشانه ثبت نام استفاده شود. برای ثبت نام دستگاهی با استفاده از NFC، رکورد NFC باید حاوی نمایش خصوصیات در JSON java.util.Properties . این یک فیلد فقط خواندنی است که توسط سرور ایجاد شده است.

enum ( AllowPersonalUsage )

کنترل می کند که آیا استفاده شخصی در دستگاهی که با این کد ثبت نام ارائه شده مجاز است یا خیر.

برای دستگاه های متعلق به شرکت:

• فعال کردن استفاده شخصی به کاربر امکان می‌دهد یک نمایه کاری در دستگاه تنظیم کند.
• غیرفعال کردن استفاده شخصی مستلزم ارائه دستگاه به عنوان یک دستگاه کاملاً مدیریت شده توسط کاربر است.

برای دستگاه های شخصی:

• فعال کردن استفاده شخصی به کاربر امکان می‌دهد یک نمایه کاری در دستگاه تنظیم کند.
• غیرفعال کردن استفاده شخصی از تامین دستگاه جلوگیری می کند. استفاده شخصی را نمی توان در دستگاه شخصی غیرفعال کرد.

enum ( SigninDetailDefaultStatus )

اختیاری. آیا URL ورود به سیستم باید به طور پیش فرض برای شرکت استفاده شود یا خیر. SigninDetail با defaultStatus تنظیم شده روی SIGNIN_DETAIL_IS_DEFAULT برای روش ثبت نام حساب Google استفاده می شود. فقط یکی از signinDetails یک شرکت می‌تواند defaultStatus روی SIGNIN_DETAIL_IS_DEFAULT تنظیم کند. اگر یک Enterprise حداقل یک signinDetails داشته باشد و هیچ یک از آنها defaultStatus را روی SIGNIN_DETAIL_IS_DEFAULT تنظیم نکرده باشد، اولین مورد از لیست انتخاب می شود و defaultStatus روی SIGNIN_DETAIL_IS_DEFAULT تنظیم کرده است. اگر هیچ signinDetails برای Enterprise مشخص نشده باشد، ثبت نام دستگاه حساب Google ناموفق خواهد بود.

string

یک ابرداده مشخص شده توسط EMM برای تمایز بین نمونه‌های SigninDetail .

{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}

string

آدرس ایمیل یک نقطه تماس، که برای ارسال اعلان‌های مهم مربوط به Google Play مدیریت‌شده استفاده می‌شود.

string

نام افسر حفاظت از داده ها.

string

ایمیل افسر حفاظت از داده ها. ایمیل تأیید شده است اما تأیید نشده است.

string

شماره تلفن افسر حفاظت از داده ها شماره تلفن تأیید شده است اما تأیید نشده است.

string

نام نماینده اتحادیه اروپا

string

ایمیل نماینده اتحادیه اروپا ایمیل تأیید شده است اما تأیید نشده است.

string

شماره تلفن نماینده اتحادیه اروپا شماره تلفن تأیید شده است اما تأیید نشده است.

{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}

enum ( GoogleAuthenticationRequired )

فقط خروجی اینکه آیا کاربران در طول فرآیند ثبت نام باید توسط Google احراز هویت شوند یا خیر. سرپرست فناوری اطلاعات می‌تواند تعیین کند که آیا احراز هویت Google برای دستگاه‌های دانش‌آموز برای شرکت فعال است یا خیر. این مقدار را فقط می توان از طریق کنسول مدیریت گوگل تنظیم کرد. احراز هویت Google را می توان با signinUrl استفاده کرد در مواردی که احراز هویت Google مورد نیاز باشد و یک signinUrl مشخص شده باشد، احراز هویت Google قبل از signinUrl راه اندازی می شود.