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
veEnterprises.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
veEnterprises.completeSignup
kullanarak Managed Google Play'e kaydolma kullanıcı arayüzü (Google'ın sağladığı mekanizma) ile birlikte bağlantı oluşturmayı içerir.
{ "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.