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 bildirimlerinin türleri.

pubsubTopic

string

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

primaryColor

integer

Cihaz yönetimi uygulamasının 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. Burada her bileşenin değeri 0 ile 255 arasında (bu değerler dahil) olur.

enterpriseDisplayName

string

Kuruluşun kullanıcılara gösterilen 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)

Kuruluşun oturum açma bilgileri.

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 bildirim gönderilir.
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 bildirim gönderilir.

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 kimlik bilgileri sağlamadığından URL'nin herkes tarafından erişilebilir olması gerekir. URL'ye uzun, rastgele bir bileşen eklemek, saldırganların URL'yi keşfetmesini engellemek için kullanılabilir.

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.

HükümlerVeKoşullar

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. Kimlik, istemcide android.text.html#fromHTML ile 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ın bir oturum açma kayıt 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. Bir cihazı NFC kullanarak kaydettirmek için NFC kaydının, JSON dosyasındaki özelliklerin serileştirilmiş java.util.Properties temsilini 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ın devre dışı bırakılması, kullanıcının cihazın temel hazırlığını tümüyle yönetilen bir cihaz olarak gerçekleştirmesini gerektirir.

Şahıslara ait cihazlar için:

  • Kişisel kullanımı etkinleştirmek, kullanıcının cihazda bir iş profili oluşturmasına olanak tanır.
  • 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. Kuruluşun signinDetails özelliklerinden 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 birbirinden 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 kuruluşları için 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ış. Kullanıcıların kayıt işlemi sırasında Google tarafından kimlik doğrulamasının yapılması 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ı gerekmez.
REQUIRED Kullanıcı kimliğinin Google tarafından başarıyla doğrulanması gerekir.

Yöntemler

create

Kuruluş oluşturur.

delete

Bir grubu ve onunla ilişkili tüm hesap ve verileri kalıcı olarak siler.

get

Bir kuruluş alır.

list

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

patch

Bir grubu günceller.