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)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
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ılmamaktadır.
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ı.
enterpriseType

enum (EnterpriseType)

Yalnızca çıkış. Kuruluşun türü.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Yalnızca çıkış. Managed Google Play Accounts grubunun türü.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Yalnızca çıkış. Yönetilen Google alanının türü.

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 gönderdiğinde 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 ile 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'ye herkes erişebilmelidir. 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şun SigninDetail'larını yönetmek için 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, mevcut SigninDetails 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 bir SigninDetail yapılandırmasını kaldırırsak bu yapılandırma depolama alanından 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ı, başarılı bir giriş için https://enterprise.google.com/android/enroll?et= , başarısız bir giriş için ise https://enterprise.google.com/android/enroll/invalid biçiminde bir URL ile kimlik doğrulama akışını 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ıdır. Oturum açma URL'sinin kuruluş için varsayılan olarak kullanılıp kullanılmayacağını belirtir. defaultStatus değeri SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanmış SigninDetail, Google Hesabı kayıt yöntemi için kullanılır. Bir kuruluşun signinDetails'lerinden yalnızca birinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanabilir. Bir Enterprise en az bir signinDetails içeriyorsa 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, varsayılan olarak kuruluş için 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 sorumlusunun 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ı ayarlarını içerir.

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

enum (GoogleAuthenticationRequired)

Yalnızca çıkış. Kullanıcıların kayıt işlemi sırasında Google tarafından kimlik doğrulaması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 kullanılabilir. Google kimlik doğrulamasının gerekli olduğu ve bir signinUrl belirtildiği durumlarda Google kimlik doğrulaması, signinUrl'ten önce başlatılır.

GoogleAuthenticationRequired

Bu kuruluş için Google kimlik doğrulamasının gerekli olup olmadığıyla ilgili ayar.

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

EnterpriseType

Kuruluşun türü.

Sıralamalar
ENTERPRISE_TYPE_UNSPECIFIED Bu değer kullanılmaz.
MANAGED_GOOGLE_DOMAIN Kuruluş, yönetilen bir Google alanına aittir.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE Kuruluş, Managed Google Play Accounts grubu olmalıdır.

ManagedGooglePlayAccountsEnterpriseType

Managed Google Play Accounts grubunun türü.

Sıralamalar
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED Managed Google Play Accounts grubu türü belirtilmemiş.
CUSTOMER_MANAGED Kuruluş müşteri tarafından yönetiliyor
EMM_MANAGED Kuruluş EMM tarafından yönetiliyor (desteklenmiyor).

ManagedGoogleDomainType

Yönetilen Google alanının türü.

Sıralamalar
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED Yönetilen Google alanı türü belirtilmemiş.
TYPE_TEAM Yönetilen Google alanı, e-posta doğrulaması yapılmış bir ekiptir.
TYPE_DOMAIN Yönetilen Google alanı, alan doğrulaması yapılmış olmalıdır.

Yöntemler

create

 Kuruluş 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.