REST Resource: enterprises

Kaynak: Enterprise

Bir kuruluşa uygulanan yapılandırma.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
name

string

Oluşturma sırasında sunucu tarafından oluşturulan kuruluşun adı (enterprises/{enterpriseId} biçiminde).
enabledNotificationTypes[]

enum (NotificationType)

Kuruluş için etkinleştirilen Google Pub/Sub bildirim türleri.
pubsubTopic

string

Pub/Sub bildirimlerinin yayınlandığı konu (projects/{project}/topics/{topic} biçiminde). Bu alan yalnızca Pub/Sub bildirimleri etkinse gereklidir.
primaryColor

integer

Cihaz yönetimi uygulaması kullanıcı arayüzünde gösterilecek baskın rengi belirten RGB biçiminde bir renk. Renk bileşenleri şu şekilde depolanır: (red << 16) | (green << 8) | blue. Her bileşenin değeri 0 ile 255 arasında (0 ve 255 dahil) olur.
enterpriseDisplayName

string

Kullanıcılara gösterilen kuruluşun adı. Bu alanın maksimum uzunluğu 100 karakterdir.
termsAndConditions[]

object (TermsAndConditions)

Bu kuruluş için cihaz hazırlığı yapılırken kabul edilmesi gereken hükümler ve koşullar. Bu listedeki her değer için bir terim sayfası oluşturulur.
appAutoApprovalEnabled
(deprecated)

boolean

Desteği sonlandırılmış ve kullanılmayan.
signinDetails[]

object (SigninDetail)

İşletmenin oturum açma ayrıntıları.
contactInfo

object (ContactInfo)

EMM tarafından yönetilen bir kuruluşun kurumsal iletişim bilgileri.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Google tarafından sağlanan kullanıcı kimlik doğrulaması ayarları.

NotificationType

Cihaz yönetimi sunucusunun Google Pub/Sub üzerinden gönderebileceği bildirim türleri.

Sıralamalar
NOTIFICATION_TYPE_UNSPECIFIED Bu değer yoksayılır.
ENROLLMENT Bir cihaz kaydolduğunda gönderilen bildirim.
COMPLIANCE_REPORT

Kullanımdan kaldırıldı.
STATUS_REPORT Bir cihaz durum raporu yayınladığında gönderilen bildirim.
COMMAND Bir cihaz komutu tamamlandığında gönderilen bildirim.
USAGE_LOGS Cihaz BatchUsageLogEvents gönderdiğinde gönderilen bildirim.

ExternalData

Harici bir konumda barındırılan veriler. Veriler Android Device Policy tarafından indirilir ve karma değeriyle doğrulanır.

JSON gösterimi 
{
  "url": string,
  "sha256Hash": string
}
Alanlar
url

string

Verilerin mutlak URL'si. Bu URL, http veya https şemasını kullanmalıdır. Android Device Policy, GET isteğinde herhangi bir kimlik bilgisi sağlamaz. Bu nedenle, URL herkese açık olmalıdır. URL'ye uzun ve rastgele bir bileşen ekleyerek saldırganların URL'yi keşfetmesini önleyebilirsiniz.
sha256Hash

string

url adresinde barındırılan içeriğin base64 kodlu SHA-256 karması. İçerik bu karma oluşturma ile eşleşmezse Android Device Policy verileri kullanmaz.

TermsAndConditions

Hazırlama sırasında kabul edilecek bir hükümler ve koşullar sayfası.

JSON gösterimi 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Alanlar
header

object (UserFacingMessage)

HTML içeriğinin üzerinde görünen kısa bir başlık.
content

object (UserFacingMessage)

İyi biçimlendirilmiş bir HTML dizesi. android.text.Html#fromHtml ile istemcide ayrıştırılır.

SigninDetail

Bir kuruluşun oturum açma ayrıntılarını içeren bir kaynak. Belirli bir kuruluş için SigninDetail'ları yönetmek üzere enterprises kullanın.

Bir kuruluş için aşağıdaki üç alanın (signinUrl, allowPersonalUsage, tokenTag) kombinasyonuyla benzersiz şekilde tanımlanan herhangi sayıda SigninDetail olabilir. Aynı (signinUrl, allowPersonalUsage, tokenTag) ile iki SigninDetail oluşturulamaz. (tokenTag isteğe bağlı bir alandır).

Patch: İşlem, SigninDetails öğesinin mevcut listesini yeni SigninDetails listesiyle günceller.

  • Depolanan SigninDetail yapılandırması iletilirse aynı signinEnrollmentToken ve qrCode döndürülür.
  • Depolanmamış birden fazla aynı SigninDetail yapılandırması iletirsek bu SigninDetail yapılandırmaları arasından ilk yapılandırmayı depolar.
  • Yapılandırma zaten mevcutsa belirli bir yamalı API çağrısında birden fazla kez isteyemeyiz. Aksi takdirde yinelenen anahtar hatası verir ve tüm işlem başarısız olur.
  • İstekteki belirli SigninDetail yapılandırmalarını kaldırırsak bu yapılandırmalar depolama alanından da kaldırılır. Ardından, aynı SigninDetail yapılandırması için başka bir signinEnrollmentToken ve qrCode isteğinde bulunabiliriz.
JSON gösterimi 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Alanlar
signinUrl

string

Cihaz, oturum açma kaydı jetonuyla temel hazırlığı yapıldığında kimlik doğrulama için oturum açma URL'si. Oturum açma uç noktası, kimlik doğrulama akışını başarılı bir giriş için https://enterprise.google.com/android/enroll?et= veya başarısız bir giriş için https://enterprise.google.com/android/enroll/invalid biçiminde bir URL ile tamamlamalıdır.
signinEnrollmentToken

string

Özel oturum açma akışını tetiklemek için kullanılan kurumsal kayıt jetonu. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.
qrCode

string

UTF-8 gösterimi, bir cihazı bu kayıt jetonuyla kaydettirmek için QR kodu oluşturmak üzere kullanılabilen bir JSON dizesi. NFC kullanarak cihaz kaydettirmek için NFC kaydının, JSON'daki mülkleri serileştirilmiş bir java.util.Properties temsili içermesi gerekir. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.
allowPersonalUsage

enum (AllowPersonalUsage)

Bu kayıt jetonuyla temel hazırlığı yapılan bir cihazda kişisel kullanıma izin verilip verilmeyeceğini kontrol eder.

Şirkete ait cihazlar için:

  • Kişisel kullanım etkinleştirildiğinde kullanıcı cihazda bir iş profili oluşturabilir.
  • Kişisel kullanımı devre dışı bırakmak için kullanıcının cihazı tümüyle yönetilen cihaz olarak temel hazırlığını yapması gerekir.

Şahıslara ait cihazlar için:

  • Kişisel kullanım etkinleştirildiğinde kullanıcı cihazda bir iş profili oluşturabilir.
  • Kişisel kullanım devre dışı bırakılırsa cihazın temel hazırlığı yapılmaz. Kişisel kullanım, kişisel cihazlarda devre dışı bırakılamaz.
defaultStatus

enum (SigninDetailDefaultStatus)

İsteğe bağlı. Oturum açma URL'sinin kuruluş için varsayılan olarak kullanılıp kullanılmayacağını belirtir. defaultStatus öğesine sahip SigninDetail, Google Hesabı kayıt yöntemi için SIGNIN_DETAIL_IS_DEFAULT olarak kullanılır. Bir kuruluşun signinDetails'lerinden yalnızca birinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanabilir. Bir Enterprise'de en az bir signinDetails varsa ve bunların hiçbirinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanmamışsa listedeki ilk öğe seçilir ve defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanır. Enterprise için signinDetails belirtilmezse Google Hesabı cihaz kaydı başarısız olur.
tokenTag

string

SigninDetail örneklerini ayırt etmek için EMM tarafından belirtilen meta veriler.

SigninDetailDefaultStatus

Oturum açma URL'sinin kuruluş için varsayılan olarak kullanılıp kullanılmayacağını belirtir.

Sıralamalar
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED SIGNIN_DETAIL_IS_NOT_DEFAULT etiketine eş değer.
SIGNIN_DETAIL_IS_DEFAULT Oturum açma URL'si, kuruluş için varsayılan olarak kullanılır.
SIGNIN_DETAIL_IS_NOT_DEFAULT Oturum açma URL'si kuruluş için varsayılan olarak kullanılmaz.

ContactInfo

Managed Google Play gruplarının iletişim bilgileri.

JSON gösterimi 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Alanlar
contactEmail

string

Yönetilen Google Play ile ilgili önemli duyuruları göndermek için kullanılacak iletişim kişisinin e-posta adresi.
dataProtectionOfficerName

string

Veri koruma yetkilisinin adı.
dataProtectionOfficerEmail

string

Veri koruma yetkilisinin e-posta adresi. E-posta doğrulandı ancak doğrulanmadı.
dataProtectionOfficerPhone

string

Veri koruma yetkilisinin telefon numarası Telefon numarası doğrulandı ancak doğrulanmadı.
euRepresentativeName

string

AB temsilcisinin adı.
euRepresentativeEmail

string

AB temsilcisinin e-posta adresi. E-posta doğrulandı ancak doğrulanmadı.
euRepresentativePhone

string

AB temsilcisinin telefon numarası. Telefon numarası doğrulandı ancak doğrulanmadı.

GoogleAuthenticationSettings

Google tarafından sağlanan kullanıcı kimlik doğrulamasıyla ilgili ayarları içerir.

JSON gösterimi 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Alanlar
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Yalnızca çıkış. Kayıt işlemi sırasında kullanıcıların kimliklerinin Google tarafından doğrulanmasının gerekip gerekmediği. BT yöneticisi, bilgi çalışanı cihazları için Google kimlik doğrulamanın kuruluşta etkinleştirilip etkinleştirilmeyeceğini belirtebilir. Bu değer yalnızca Google Yönetici Konsolu üzerinden ayarlanabilir. Google kimlik doğrulaması signinUrl ile birlikte kullanılabilir. Google kimlik doğrulamasının zorunlu olduğu ve signinUrl değerinin belirtildiği durumlarda Google kimlik doğrulaması signinUrl tarihinden önce başlatılır.

GoogleAuthenticationRequired

Bu kuruluş için Google kimlik doğrulamasının gerekli olup olmadığına ilişkin ayar.

Sıralamalar
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Bu değer kullanılmaz.
NOT_REQUIRED Google kimlik doğrulaması gerekli değildir.
REQUIRED Kullanıcı kimliğinin Google tarafından başarıyla doğrulanması gerekir.

Yöntemler

create

 Bir grup oluşturur.

delete

 Bir kuruluşu ve onunla ilişkili tüm hesapları ve verileri kalıcı olarak siler.

get

 Bir kuruluş alır.

list

 EMM tarafından yönetilen kuruluşları listeler.

patch

 Bir kuruluşu günceller.