REST Resource: enterprises

Kaynak: Enterprise

Yapılandırma bir kuruluşa uygulanır.

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 ve enterprises/{enterpriseId} biçimindeki işletmenin adı.
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 etkinleştirilmişse gereklidir.
primaryColor

integer

Cihaz yönetimi uygulaması kullanıcı arayüzünde gösterilecek baskın rengi belirten RGB biçimindeki 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) olmalıdır.
enterpriseDisplayName

string

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

object (TermsAndConditions)

Bu işletme için bir cihaz sağlarken kabul edilmesi gereken hükümler 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ılmıyor.
signinDetails[]

object (SigninDetail)

Kurumsal hesabın oturum açma bilgileri.
contactInfo

object (ContactInfo)

EMM tarafından yönetilen bir işletmenin kurumsal iletişim bilgileri.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

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

enum (EnterpriseType)

Yalnızca çıkış. İşletmenin 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önetim 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 kaydedildiğinde 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.
ENTERPRISE_UPGRADE Enterprise sürümüne yükseltme için gönderilen bildirim. Grup yükseltme, Managed Google Play Accounts grubunu yönetilen Google alanına yükseltme işlemidir.

ExternalData

Veriler harici bir konumda barındırılıyorsa. Veriler Android Device Policy tarafından indirilir ve karma ile karşılaştırılarak doğrulanır.

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

string

Verilere yönelik mutlak URL. Bu URL'de http veya https şeması kullanılmalıdır. Android Device Policy, GET isteğinde herhangi bir kimlik bilgisi sağlamadığından URL'ye herkese açık olarak erişilebilmelidir. URL'ye uzun ve rastgele bir bileşen eklemek, saldırganların URL'yi keşfetmesini önlemek için kullanılabilir.
sha256Hash

string

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

TermsAndConditions

Sağlama 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. Bu, android.text.Html#fromHtml ile istemcide ayrıştırılır.

SigninDetail

Bir işletmenin oturum açma ayrıntılarını içeren kaynak. Belirli bir işletmenin SigninDetaillerini yönetmek için enterprises kullanın.

Bir işletme için, aşağıdaki üç alanın (signinUrl, allowPersonalUsage, tokenTag) kombinasyonuyla benzersiz şekilde tanımlanan herhangi bir 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 değerleri döndürülür.
  • Depolanmayan birden fazla aynı SigninDetail yapılandırması iletilirse bu SigninDetail yapılandırmaları arasında ilk olan depolanır.
  • Yapılandırma zaten varsa belirli bir yama API çağrısında birden fazla kez isteyemeyiz. Aksi takdirde, yinelenen anahtar hatası verilir ve tüm işlem başarısız olur.
  • İstekten belirli bir 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, oturum açma kayıt jetonuyla sağlandığında kimlik doğrulama için kullanılan 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 bir URL ile, başarısız bir giriş için ise 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 geçerli bir 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 kaydetmek için QR kodu oluşturmak üzere kullanılabilen bir JSON dizesi. NFC kullanarak bir cihazı kaydetmek için NFC kaydında, JSON'daki özelliklerin seri hale getirilmiş bir java.util.Properties gösterimi bulunmalıdır. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.
allowPersonalUsage

enum (AllowPersonalUsage)

Bu kayıt jetonuyla sağlanan bir cihazda kişisel kullanıma izin verilip verilmediğini kontrol eder.

Şirkete ait cihazlar için:

  • Kişisel kullanımın etkinleştirilmesi, kullanıcının cihazda iş profili oluşturmasına olanak tanır.
  • Kişisel kullanımı devre dışı bırakmak için kullanıcının cihazı tümüyle yönetilen cihaz olarak sağlaması gerekir.

Şahıslara ait cihazlar için:

  • Kişisel kullanımın etkinleştirilmesi, kullanıcının cihazda iş profili oluşturmasına olanak tanır.
  • Kişisel kullanımın devre dışı bırakılması, cihazın temel hazırlığının yapılmasını engeller. Kişisel kullanım, kişisel olarak sahip olunan 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ğı. defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanmış SigninDetail, Google Hesabı kayıt yöntemi için kullanılır. Bir kuruluşun signinDetails öğelerinden yalnızca birinde defaultStatus, SIGNIN_DETAIL_IS_DEFAULT olarak ayarlanabilir. Bir Enterprise öğesinde 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 belirtilmemişse Google Hesabı cihaz kaydı başarısız olur.
tokenTag

string

SigninDetail örnekleri arasında ayrım yapmak 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ğı.

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ı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 bir iletişim kişisinin e-posta adresi.
dataProtectionOfficerName

string

Veri koruma yetkilisinin adı.
dataProtectionOfficerEmail

string

Veri koruma yetkilisinin e-posta adresi. E-posta doğrulanmış ancak onaylanmamış.
dataProtectionOfficerPhone

string

Veri koruma görevlisinin telefon numarası. Telefon numarası doğrulanmış ancak onaylanmamıştır.
euRepresentativeName

string

AB temsilcisinin adı.
euRepresentativeEmail

string

AB temsilcisinin e-posta adresi. E-posta doğrulanmış ancak onaylanmamış.
euRepresentativePhone

string

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

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 kimliklerinin doğrulanması gerekip gerekmediği. BT yöneticisi, bilgi çalışanlarının cihazlarında Google kimlik doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirleyebilir. 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 gerekli olduğu ve signinUrl belirtildiği durumlarda Google kimlik doğrulaması signinUrl'den önce başlatılır.

GoogleAuthenticationRequired

Google kimlik doğrulamasının bu kuruluş için gerekli olup olmadığını belirten ayar.

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

EnterpriseType

İşletmenin türü.

Sıralamalar
ENTERPRISE_TYPE_UNSPECIFIED Bu değer kullanılmaz.
MANAGED_GOOGLE_DOMAIN Kuruluş, yönetilen Google alanına ait olmalıdır.
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 (kullanımdan kaldırıldı).

ManagedGoogleDomainType

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

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

Yöntemler

create

 Kurumsal hesap oluşturur.

delete

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

generateEnterpriseUpgradeUrl

 Mevcut bir Managed Google Play Accounts grubunu yönetilen Google alanına yükseltmek için bir grup yükseltme URL'si oluşturur.

get

 Kurumsal hesap edinir.

list

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

patch

 Bir kuruluşu günceller.