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

Kuruluşun, oluşturma işlemi sırasında sunucu tarafından oluşturulan enterprises/{enterpriseId} biçiminde adı.

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 bir cihaz temel 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

Kullanımdan kaldırıldı ve kullanılmıyor.

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 Cihaz kaydolduğunda bildirim gönderilir.
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 bildirim gönderilir.

ExternalData

Harici bir konumda barındırılan veriler. Veriler, Android Device Policy tarafından indirilecek ve karma oluşturma işlemine göre doğrulanacaktı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'de barındırılan içeriğin base-64 ile kodlanmış SHA-256 karması. İçerik bu karma ile eşleşmezse Android Device Policy verileri kullanmaz.

TermsAndConditions

Temel hazırlık sırasında kabul edilecek şartlar 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 üstbilgidir.

content

object (UserFacingMessage)

İyi biçimlendirilmiş bir HTML dizesi. Kimlik, istemcide android.text.html#fromHTML ile ayrıştırılır.

SigninDetail

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 elimizde aşağıdaki üç alanın (signinUrl, allowPersonalUsage, tokenTag) kombinasyonuyla benzersiz şekilde tanımlanan herhangi bir sayıda SigninDetail olabilir. Biri aynı olan iki SigninDetail oluşturamaz (signinUrl, allowPersonalUsage, tokenTag). (tokenTag isteğe bağlı bir alandır.)

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

  • Depolanan SigninDetail yapılandırması geçirilirse aynı signinEnrollmentToken ve qrCode değerlerini döndürür.
  • Depolanmayan birden fazla benzer SigninDetail yapılandırması iletirsek söz konusu SigninDetail yapılandırmaları arasından ilkini depolar.
  • Yapılandırma zaten mevcutsa belirli bir yama API çağrısında birden fazla kez istekte bulunamayız. Aksi takdirde, yinelenen anahtar hatası verilir ve tüm işlem başarısız olur.
  • İstekten belirli SigninDetail yapılandırmasını kaldırırsak bu yapılandırma, depolama alanından da kaldırılır. Ardından aynı SigninDetail yapılandırması için başka bir signinEnrollmentToken ve qrCode isteyebiliriz.
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= biçiminde, başarısız 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, kuruluş genelinde kullanılan bir kayıt jetonu. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.

qrCode

string

Bir cihazı bu kayıt jetonuyla kaydettirmek üzere bir QR kodu oluşturmak için UTF-8 temsili kullanılabilecek 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ştirmek, kullanıcının cihazda bir iş profili oluşturmasına olanak tanır.
  • 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ın devre dışı bırakılması, cihazın temel hazırlık işlemini yapmasını engeller. Şahıslara ait cihazlarda kişisel kullanım devre dışı bırakılamaz.
defaultStatus

enum (SigninDetailDefaultStatus)

İsteğe bağlı. Kuruluş için oturum açma URL'sinin varsayılan olarak kullanılıp kullanılmayacağı. 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. Enterprise için en az bir signinDetails varsa ve hiçbirinde defaultStatus değeri SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanmadıysa listedeki ilk öğe seçilir ve defaultStatus değeri SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanır. Enterprise için signinDetails belirtilmemişse 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

Kuruluş için oturum açma URL'sinin varsayılan olarak kullanılıp kullanılmayacağı.

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ılacak.
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

Managed Google Play ile ilgili önemli duyuruları göndermek için kullanılacak olan ilgili kişinin 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ı ayarlarını 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 kuruluşta Google kimlik doğrulamasının 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

Bir grup 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.