Enterprises

Bu kaynak için yöntemlerin listesi bu sayfanın sonuna verilmiştir.

Kaynak temsilleri

Enterprises kaynağı, bir EMM ile belirli bir kuruluş arasındaki bağlamayı temsil eder. Bu bağlama, aşağıdaki API kullanılarak iki farklı yöntemden biriyle örnek oluşturulabilir:

  • Google yönetilen alan müşterileri için süreç, Enterprises.enroll ve Enterprises.setAccount'ün (Yönetici Konsolu ve Google API Konsolu'ndan elde edilen yapı taşlarıyla birlikte) kullanılmasını ve az çok manuel bir süreçle EMM'ye gönderilmesini içerir.
  • Yönetilen Google Hesabı müşterileri için bu işlem, manuel adımlar olmadan bağlamayı oluşturmak üzere yönetilen 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 ikisini birden destekleyebilirsiniz. Ayrıntılar için Enterprise oluşturma başlıklı makaleyi inceleyin.

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

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

Kabul edilen değerler şunlardır:
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
id string Kuruluşun benzersiz kimliği.

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

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

Yöntemler

acknowledgeNotificationSet
Sonraki çağrıların aynı bildirimleri döndürmesini önlemek için Enterprises.PullNotificationSet kaynağından alınan bildirimleri onaylar.
completeSignup
Tamamlama jetonunu ve kurum jetonunu belirterek kayıt akışını tamamlar. Bu istek, belirli bir Enterprise jetonu için birden çok kez çağrılmamalıdır.
createWebToken
Yerleştirilebilir 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'sine 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.
kaydol
Bir kuruluşu arayan EMM'ye kaydeder.
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. setAccount çağrısı yapılarak hizmet hesabı kuruluşa bağlanabilir. Hizmet hesabı bu kuruluşa ve EMM'ye özgüdür ve kuruluşun bağlayıcılığı kaldırılırsa silinir. Kimlik bilgileri özel anahtar verilerini 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. Aksi takdirde hata döndürür.

İlk çağrıdan sonraki çağrılar yeni ve benzersiz bir kimlik bilgisi 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
Kurum için mağaza düzenini döndürür. Mağaza düzeni ayarlanmamışsa mağaza düzeni türü olarak "temel" döndürülür ve ana sayfa döndürülmez.
list
Bir kuruluşu alan adına göre arar. Bu özellik yalnızca Google tarafından başlatılan oluşturma akışı aracılığıyla oluşturulan kuruluşlar için desteklenir. EMM, Enterprises.generateSignupUrl çağrısında belirtilen geri çağırma işlevinde kuruluş kimliğini öğrendiği için EMM tarafından başlatılan akış aracılığıyla oluşturulan kuruluşlar için kimliğin aranması gerekmez.
pullNotificationSet
İstek için kimliği doğrulanmış hizmet hesabıyla ilişkili kuruluşlar için bir bildirim grubunu alır ve döndürür. Bekleyen bildirim yoksa bildirim grubu boş olabilir.
İade edilen bir bildirim grubunun, bildirim grubu boş olmadığı sürece 20 saniye içinde Enterprises.AcknowledgeNotificationSet çağrısı yapılarak onaylanması gerekir.
20 saniye içinde onaylanmayan bildirimler, başka bir PullNotificationSet isteğinin yanıtına tekrar dahil edilir. Hiçbir zaman onaylanmayan bildirimler ise Google Cloud Platform Pub/Sub sistem politikasına göre silinir.
Bildirimleri almak için eşzamanlı olarak birden fazla istek gönderilebilir. Bu durumda, bekleyen bildirimler (varsa) her bir arayanın arasında paylaştırılır.
Bildirim yoksa boş bir bildirim listesi döndürülür. Daha sonra yapılan istekler, kullanılabilir hale geldiklerinde daha fazla bildirim döndürebilir.
sendTestPushNotification
Bu kuruluş için EMM entegrasyonunu Google Cloud Pub/Sub hizmetiyle doğrulamak amacıyla bir test bildirimi gönderir.
setAccount
API'de kimlik doğrulaması yapmak için kullanılacak hesabı kuruluş olarak ayarlar.
setStoreLayout
Kuruluş için mağaza düzenini ayarlar. storeLayoutType varsayılan olarak "temel" olarak ayarlanır ve temel mağaza düzeni etkinleştirilir. Temel düzen yalnızca yönetici tarafından onaylanan ve bir kullanıcının kullanılabilir ürün grubuna eklenen uygulamaları içerir ( setAvailableProductSet çağrısı kullanılarak). 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.
kaydımı iptal etme
Bir işletmenin arayan EMM'den kaydını iptal eder.