Enterprises

Bu kaynak için yöntemlerin listesini görmek istiyorsanız bu sayfanın sonuna bakın.

Kaynak temsilleri

Bir Enterprises kaynağı, bir EMM ile belirli bir kuruluş arasındaki bağlamayı temsil eder. Bu bağlama, bu API kullanılarak iki farklı şekilde örnek oluşturulabilir:

  • Google tarafından yönetilen alan müşterileri için süreç, Enterprises.enroll ve Enterprises.setAccount'nin (Yönetici Konsolu ve Google API Konsolu'ndan elde edilen yapılarla birlikte) kullanılmasını ve EMM'ye az çok manuel bir süreçle gönderilmesini içerir.
  • Managed Google Play Hesapları müşterileri için bu işlem, bağlamayı manuel adımlar olmadan oluşturmak üzere Managed Google Play kayıt kullanıcı arayüzü (Google tarafından sağlanan mekanizma) ile birlikte Enterprises.generateSignupUrl ve Enterprises.completeSignup kullanmayı içerir.
EMM olarak, EMM konsolunuzda bu yaklaşımlardan birini veya her ikisini de destekleyebilirsiniz. Ayrıntılar için Kurumsal hesap oluşturma başlıklı makaleyi inceleyin. 

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
Mülk adı Değer Açıklama Notlar
administrator[] list Kuruluş yöneticileri Bu özellik yalnızca EMM tarafından başlatılan akış üzerinden oluşturulan işletmeler için desteklenir.

administrator[].email string Yöneticinin e-posta adresi.
enterpriseType string İşletmenin türü.

Kabul edilen değerler şunlardır:
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings nested object Google tarafından sağlanan kullanıcı kimlik doğrulama ayarları.
googleAuthenticationSettings.createdAt nested object Ayarların ilk oluşturulduğu veya değiştirildiği zamanın zaman damgası.
googleAuthenticationSettings.createdAt.nanos integer Nanosaniye çözünürlüğünde, negatif olmayan saniye kesirleri. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında (her iki değer de dahil) olmalıdır.
googleAuthenticationSettings.createdAt.seconds long Unix sıfır zamanı olan 1970-01-01T00:00:00Z tarihinden itibaren UTC saatinin saniyelerini gösterir. 0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z (ikisi de dahil) arasında olmalıdır.
googleAuthenticationSettings.dedicatedDevicesAllowed string Bir amaca özel ayrılmış cihazlara izin verilip verilmediği.

Kabul edilen değerler şunlardır:
  • "allowed"
  • "dedicatedDevicesAllowedUnspecified"
  • "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired string Google kimlik doğrulamasının gerekli olup olmadığı

Kabul edilen değerler şunlardır:
  • "googleAuthenticationRequiredUnspecified"
  • "notRequired"
  • "required"
googleAuthenticationSettings.updatedAt nested object Ayarların en son değiştirildiği anın zaman damgası.
googleAuthenticationSettings.updatedAt.nanos integer Nanosaniye çözünürlüğünde, negatif olmayan saniye kesirleri. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında (her iki değer de dahil) olmalıdır.
googleAuthenticationSettings.updatedAt.seconds long Unix sıfır zamanı olan 1970-01-01T00:00:00Z tarihinden itibaren UTC saatinin saniyelerini gösterir. 0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z (ikisi de dahil) arasında olmalıdır.
id string İşletmenin benzersiz kimliği.

id string İşletmenin benzersiz kimliği.

kind string
managedGoogleDomainType string Yönetilen Google alanı türü

Kabul edilen değerler:
  • "managedGoogleDomainTypeUnspecified"
  • "typeDomain"
  • "typeTeam"
name string İşletmenin adı (ör. "Örnek A.Ş.").
primaryDomain string İşletmenin birincil alanı (ör. "example.com").

Yöntemler

acknowledgeNotificationSet
Aynı bildirimlerin sonraki çağrılarda döndürülmesini önlemek için Enterprisess.PullNotificationSet'ten alınan bildirimleri onaylar.
completeSignup
Tamamlama jetonunu ve kuruluş jetonunu belirterek kayıt akışını tamamlar. Bu istek, belirli bir Enterprise Token için birden fazla kez çağrılmamalıdır.
createWebToken
Yerleştirilebilir bir kullanıcı arayüzüne erişmek için benzersiz bir jeton döndürür. Web kullanıcı arayüzü oluşturmak için oluşturulan jetonu Managed Google Play JavaScript API'ye iletin. Her jeton yalnızca bir kullanıcı arayüzü oturumu başlatmak için kullanılabilir. Daha fazla bilgi için JavaScript API belgelerine bakın.
kaydolma
Bir kuruluşu arayan EMM'ye kaydeder.
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. Daha ayrıntılı bilgi için kurumsal sürümü yükseltme kılavuzuna bakın.
generateSignupUrl
Kaydolma URL'si oluşturur.
get
Bir kuruluşun adını ve alanını alır.
getServiceAccount
Bir hizmet hesabı ve kimlik bilgileri döndürür. Hizmet hesabı, setAccount çağrılarak kuruluşa bağlanabilir. Hizmet hesabı bu kuruluşa ve EMM'ye özeldir ve kuruluşun bağlantısı kaldırılırsa silinir. Kimlik bilgileri özel anahtar verileri içerir ve sunucu tarafında depolanmaz.

Bu yöntem yalnızca Enterprises.Enroll veya Enterprises.CompleteSignup çağrıldıktan sonra ve Enterprises.SetAccount çağrılmadan önce çağrılabilir. Diğer zamanlarda hata döndürür.

İlk çağrıdan sonraki çağrılar, yeni ve benzersiz bir kimlik bilgileri grubu oluşturur ve daha önce oluşturulan kimlik bilgilerini geçersiz kılar.

Hizmet hesabı kuruluşa bağlandıktan sonra serviceAccountKeys kaynağı kullanılarak yönetilebilir.

.

.
getStoreLayout
Kuruluşun mağaza düzenini döndürür. Mağaza düzeni ayarlanmamışsa mağaza düzeni türü olarak "basic" değerini ve ana sayfa olmadığını döndürür.
list
Alan adına göre bir kuruluşu arar. Bu özellik yalnızca Google tarafından başlatılan oluşturma akışı aracılığıyla oluşturulan işletmeler için desteklenir. EMM tarafından başlatılan akış aracılığıyla oluşturulan kuruluşlar için kimliğin aranması gerekmez. Çünkü EMM, Enterprises.generateSignupUrl çağrısında belirtilen geri çağırmada kuruluş kimliğini öğrenir.
pullNotificationSet
İstek için kimliği doğrulanan hizmet hesabıyla ilişkili işletmeler için ayarlanan bir bildirimi çeker ve döndürür. Bekleyen bildirim yoksa bildirim kümesi boş olabilir.
Bildirim kümesi boş olmadığı sürece, döndürülen bildirim kümesinin 20 saniye içinde Enterprises.AcknowledgeNotificationSet çağrılarak onaylanması gerekir.
20 saniye içinde onaylanmayan bildirimler, başka bir PullNotificationSet isteğine verilen yanıta sonunda tekrar dahil edilir. Hiç onaylanmayan bildirimler ise Google Cloud Platform Pub/Sub sistem politikasına göre nihayetinde silinir.
Bildirimleri almak için eşzamanlı olarak birden fazla istek gönderilebilir. Bu durumda, bekleyen bildirimler (varsa) her arayan arasında paylaştırılır.
Bildirim yoksa boş bir bildirim listesi döndürülür. Sonraki istekler, kullanıma sunulduktan sonra daha fazla bildirim döndürebilir.
sendTestPushNotification
Bu kuruluş için EMM'nin Google Cloud Pub/Sub hizmetiyle entegrasyonunu doğrulamak üzere test bildirimi gönderir.
setAccount
API'de kimlik doğrulaması için kullanılacak hesabı kuruluş olarak ayarlar.
setStoreLayout
Kuruluş için mağaza düzenini ayarlar. Varsayılan olarak storeLayoutType "basic" olarak ayarlanır ve temel mağaza düzeni etkinleştirilir. Temel düzende yalnızca yönetici tarafından onaylanan ve bir kullanıcı için kullanılabilir ürün grubuna eklenen uygulamalar ( setAvailableProductSet çağrısı kullanılarak) bulunur. Sayfadaki uygulamalar, ürün kimliği değerlerine göre sıralanır. Özel bir mağaza düzeni oluşturursanız (storeLayoutType = "custom" değerini ayarlayarak ve bir ana sayfa belirleyerek) temel mağaza düzeni devre dışı bırakılır.
unenroll
Bir kuruluşu arama EMM'sinden kaydını siler.