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)
  }
}
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ınlandığı konu, projects/{project}/topics/{topic} biçimindedir. Bu alan yalnızca Pub/Sub bildirimleri etkinse zorunludur.
primaryColor

integer

Cihaz yönetimi uygulamasının kullanıcı arayüzünde görüntülenecek 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 (ikisi de dahil) yer alır.
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 bir cihazın temel hazırlığı yapılırken kabul edilmesi gereken şartlar ve koşullar. Bu listedeki her değer için bir terimler sayfası oluşturulur.
appAutoApprovalEnabled
(deprecated)

boolean

Kullanımdan kaldırıldı ve kullanılmadı.
signinDetails[]

object (SigninDetail)

Kuruluşun oturum açma bilgileri.
contactInfo

object (ContactInfo)

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

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

ExternalData

Harici bir konumda barındırılan veriler. Veriler Android Device Policy tarafından indirilecek ve karma değerleriyle doğrulanmalıdır.

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

string

Verilerin http veya https şemasını kullanması gereken mutlak URL'dir. Android Device Policy, GET isteğinde kimlik bilgisi sağlamadığından URL'nin herkesin erişimine açık olması gerekir. Saldırganların URL'yi keşfetmesini engellemek için URL'ye uzun, rastgele bir bileşen eklenebilir.
sha256Hash

string

URL'de barındırılan içeriğin base-64 kodlanmış SHA-256 karması. İçerik bu karma ile eşleşmiyorsa Android Device Policy, verileri kullanmaz.

TermsAndConditions

Temel hazırlık 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 üstbilgi.
content

object (UserFacingMessage)

İyi biçimlendirilmiş bir HTML dizesi. İstemcide android.text.html#fromhtml ile ayrıştırılır.

SigninDetail

Bir kuruluşun oturum açma ayrıntılarını içeren kaynak. Belirli bir kuruluşta SigninDetail öğelerini 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 bir sayıda SigninDetail olabilir. Aynı alanla (signinUrl, allowPersonalUsage, tokenTag) iki SigninDetail oluşturulamaz. (tokenTag isteğe bağlı bir alandır.)

Patch: Bu işlem, mevcut SigninDetails listesini yeni SigninDetails listesiyle günceller.

  • Depolanan SigninDetail yapılandırması geçerse aynı signinEnrollmentToken ve qrCode değerlerini döndürür.
  • Depolanmayan birden fazla özdeş 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 bu yapılandırma için birden çok kez istekte bulunulamaz. 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 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),
  "tokenTag": string
}
Alanlar
signinUrl

string

Cihaza bir oturum açma kayıt jetonu sağlandığında kimlik doğrulama için kullanılacak oturum açma URL'si. Oturum açma uç noktası, 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 kimlik doğrulama akışını tamamlamalıdır.
signinEnrollmentToken

string

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

string

Bu kayıt jetonuna sahip bir cihazı kaydettirmek için QR kodu oluşturmak üzere UTF-8 temsili kullanılabilecek bir JSON dizesidir. Bir cihazı NFC kullanarak kaydettirmek için NFC kaydı, JSON'daki özelliklerin serileştirilmiş java.util.Properties temsilini içermelidir. 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 verilmediğ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ı devre dışı bırakmak, kullanıcının cihazın temel hazırlığını tümüyle yönetilen bir cihaz olarak yapmasını 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 yapmasını engeller. Kişiye ait cihazlarda kişisel kullanım devre dışı bırakılamaz.
tokenTag

string

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

ContactInfo

Managed Google Play enterprise 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 memurunun e-postası. E-posta doğrulandı ancak doğrulanmadı.
dataProtectionOfficerPhone

string

Veri koruma memurunun 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ı.

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.