Enterprises

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Kuruluş kaynağı, EMM ile belirli bir kuruluş arasındaki bağlantıyı temsil eder. Bu bağlama, bu API aşağıdaki gibi kullanılarak iki farklı yöntemden biriyle örneklenebilir:

  • Google tarafından yönetilen alan müşterileri için bu işlem, Enterprises.enroll ve Enterprises.setAccount (Yönetici Konsolu'ndan ve Google API Konsolu'ndan edinilen yapılar ile birlikte) kullanılmasını ve daha fazla veya daha az manuel bir işlemle EMM'ye gönderilmesini içerir.
  • Managed Google Play Hesapları müşterileri için bu süreç, manuel adımlara gerek kalmadan Enterprises.generateSignupUrl ve Enterprises.completeSignup kullanarak Managed Google Play'e kaydolma kullanıcı arayüzü (Google'ın sağladığı mekanizma) ile birlikte bağlantı oluşturmayı içerir.
EMM olarak EMM konsolunuzda bu yaklaşımlardan birini veya her ikisini de destekleyebilirsiniz. Ayrıntılı bilgi için Kuruluş oluşturma başlıklı makaleyi inceleyin. 

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

administrator[].email string Yöneticinin e-posta adresi.
id string Kuruluşun benzersiz kimliği.

kind string
name string Kuruluşun adı; örneğin, "Örnek A.Ş."
primaryDomain string Kuruluşun birincil alan adı (ör. "example.com").

Yöntemler

acknowledgeNotificationSet
Sonraki çağrıların aynı bildirimleri döndürmesini engellemek için Enterprises.PullBildirimSet'ten alınan bildirimleri onaylar.
completeSignup
Tamamlama jetonunu ve Enterprise jetonunu belirterek kayıt işlemini 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. Bir 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'si belgelerine bakın.
kaydet
Bir kuruluşu çağıran EMM'ye kaydeder.
generateSignupUrl
Kaydolma URL'si oluşturur.
al
Bir kuruluşun adını ve alan adını getirir.
getServiceAccount
Bir hizmet hesabı ve kimlik bilgileri döndürür. Hizmet hesabı, setAccount çağrısı yapı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 saklanmaz.

Bu yöntem yalnızca Enterprises.enroll veya Enterprises.CompleteSignup çağrısından sonra ve Enterprises.SetAccount'tan önce çağrılabilir. Bazen de hata döndürür.

İlk çağrıdan sonra yapılan sonraki çağrılar, yeni ve benzersiz bir kimlik bilgisi grubu oluşturur ve önceden oluşturulmuş kimlik bilgilerini geçersiz kılar.

Hizmet hesabı kuruluşa bağlandığında, serviceAccountKeys kaynağı kullanılarak yönetilebilir.
getStoreLayout
Kuruluş için mağaza düzenini döndürür. Mağaza düzeni ayarlanmazsa mağaza düzeni türü olarak "temel" değerini döndürür, ana sayfa değerini içermez.
list
Alan adına göre kuruluş arar. Bu 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ğırmada kurumsal kimliği öğrendiğinden, EMM tarafından başlatılan akış aracılığıyla oluşturulan kuruluşlar için kimlik araması gerekli değildir.
pullNotificationSet
İstek için kimliği doğrulanan hizmet hesabıyla ilişkili kuruluşlar için bir bildirim grubu çeker ve döndürür. Bekleyen bildirim yoksa bildirim grubu boş olabilir.
Döndürülen bildirim grubunun, Enterprises.AcknowledgenotificationSet kullanılarak 20 saniye içinde onaylanması gerekir (bildirim grubu boş değilse).
20 saniye içinde onaylanmayan bildirimler ileride başka bir PullNotificationSet isteğine verilen yanıta tekrar eklenir ve hiçbir zaman kabul edilmeyen bildirimler Google Cloud Platform Pub/Sub sistem politikasına göre silinir.
Bildirimleri almak için aynı anda birden fazla istek gerçekleştirilebilir. Bu durumda, bekleyen bildirimler (varsa) bekleyen bildirimler (varsa) her bir arayan arasında bölünür.
Bildirim yoksa boş bir bildirim listesi döndürülür. Sonraki istekler, kullanıma sunulduğunda daha fazla bildirim döndürebilir.
sendTestPushNotification
Bu kuruluş için Google Cloud Pub/Sub hizmetiyle EMM entegrasyonunu doğrulamak amacıyla bir test bildirimi gönderir.
setAccount
API'nin kimliğini doğrulamak için kullanılacak hesabı kuruluş olarak belirler.
setStoreLayout
Kuruluşlar için mağaza düzenini ayarlar. Varsayılan olarak storeLayoutType "basic" (temel) olarak ayarlanmıştır ve temel mağaza düzeni etkindir. Temel düzen yalnızca yönetici tarafından onaylanmış ve kullanıcı için mevcut ürün grubuna eklenmiş ( setAvailableProductSet çağrısı kullanılarak) uygulamaları içerir. Sayfadaki uygulamalar, ürün kimliği değerlerine göre sıralanır. Özel mağaza düzeni oluşturursanız (storeLayoutType = "custom" ayarını ve bir ana sayfa ayarlayarak) temel mağaza düzeni devre dışı bırakılır.
kaydı iptal et
Bir kuruluşun çağrı yapan EMM'deki kaydını iptal eder.