Enterprises
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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. - Managed Google Play Hesapları müşterileri için bu işlem, manuel adımlar olmadan bağlamayı 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 ikisini birden destekleyebilirsiniz. Ayrıntılar için Kuruluş 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.
- generateEnterpriseUpgradeUrl
- Mevcut bir Managed Google Play Accounts grubunu yönetilen Google alanına yükseltmek için bir kurumsal yükseltme URL'si oluşturur.
Daha ayrıntılı bilgi için
kuruluş 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. 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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-28 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-28 UTC."],[[["\u003cp\u003eAn Enterprises resource represents the connection between an EMM and an organization, established through either manual enrollment for Google-managed domains or automated signup for managed Google Play Accounts.\u003c/p\u003e\n"],["\u003cp\u003eEMMs can support either or both enrollment methods, offering flexibility in binding with organizations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides various methods to manage enterprises, including enrollment, sign-up, retrieval of enterprise details, and more.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEnterprises\u003c/code\u003e resource includes properties like ID, primary domain, name, and administrators, offering comprehensive information about the enterprise.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the API's methods to interact with and manage enterprise data, enabling seamless integration with their EMM solutions.\u003c/p\u003e\n"]]],[],null,["# Enterprises\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nAn Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows:\n\n- For Google managed domain customers, the process involves using `Enterprises.enroll` and `Enterprises.setAccount` (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process.\n- For managed Google Play Accounts customers, the process involves using `Enterprises.generateSignupUrl` and `Enterprises.completeSignup` in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps.\n\nAs an EMM, you can support either or both approaches in your EMM console. See [Create an Enterprise](/android/work/play/emm-api/create-enterprise) for details. \n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#enterprise\",\n \"id\": string,\n \"primaryDomain\": string,\n \"name\": string,\n \"administrator\": [\n {\n \"email\": string\n }\n ],\n \"enterpriseType\": string,\n \"managedGoogleDomainType\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `administrator[]` | `list` | Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow. | |\n| administrator[].`email` | `string` | The admin's email address. | |\n| `enterpriseType` | `string` | The type of the enterprise. \u003cbr /\u003e Acceptable values are: - \"`enterpriseTypeUnspecified`\" - \"`managedGoogleDomain`\" - \"`managedGooglePlayAccountsEnterprise`\" | |\n| `id` | `string` | The unique ID for the enterprise. | |\n| `kind` | `string` | | |\n| `managedGoogleDomainType` | `string` | The type of managed Google domain \u003cbr /\u003e Acceptable values are: - \"`managedGoogleDomainTypeUnspecified`\" - \"`typeDomain`\" - \"`typeTeam`\" | |\n| `name` | `string` | The name of the enterprise, for example, \"Example, Inc\". | |\n| `primaryDomain` | `string` | The enterprise's primary domain, such as \"example.com\". | |\n\nMethods\n-------\n\n[acknowledgeNotificationSet](/android/work/play/emm-api/v1/enterprises/acknowledgeNotificationSet)\n: Acknowledges notifications that were received from\n Enterprises.PullNotificationSet to prevent subsequent calls from returning\n the same notifications.\n\n[completeSignup](/android/work/play/emm-api/v1/enterprises/completeSignup)\n: Completes the signup flow, by specifying the Completion token and\n Enterprise token.\n This request must not be called multiple times for a given Enterprise\n Token.\n\n[createWebToken](/android/work/play/emm-api/v1/enterprises/createWebToken)\n: Returns a unique token to access an embeddable UI. To generate a\n web UI, pass the generated token into the managed Google Play javascript\n API. Each token may only be used to start one UI session. See the\n [JavaScript API documentation](https://developers.google.com/api-client-library/javascript/apis/androidenterprise/v1) for further information.\n\n[enroll](/android/work/play/emm-api/v1/enterprises/enroll)\n: Enrolls an enterprise with the calling EMM.\n\n[generateEnterpriseUpgradeUrl](/android/work/play/emm-api/v1/enterprises/generateEnterpriseUpgradeUrl)\n: Generates an enterprise upgrade URL to upgrade an existing managed Google\n Play Accounts enterprise to a managed Google domain.\n See [the guide to upgrading an enterprise](/android/work/play/emm-api/upgrade-an-enterprise) for more details.\n\n[generateSignupUrl](/android/work/play/emm-api/v1/enterprises/generateSignupUrl)\n: Generates a sign-up URL.\n\n[get](/android/work/play/emm-api/v1/enterprises/get)\n: Retrieves the name and domain of an enterprise.\n\n[getServiceAccount](/android/work/play/emm-api/v1/enterprises/getServiceAccount)\n: Returns a service account and credentials. The service account\n can be bound to the enterprise by calling setAccount. The service account\n is unique to this enterprise and EMM, and will be deleted if the enterprise\n is unbound. The credentials contain private key data and are not stored\n server-side.\n\n \u003cbr /\u003e\n\n\n This method can only be called after calling\n Enterprises.Enroll or Enterprises.CompleteSignup, and before\n Enterprises.SetAccount; at other times it will return an error.\n\n \u003cbr /\u003e\n\n\n Subsequent calls after the first will generate a new, unique set of\n credentials, and invalidate the previously generated credentials.\n\n \u003cbr /\u003e\n\n\n Once the service account is bound to the enterprise, it can be managed\n using the serviceAccountKeys resource.\n\n \u003cbr /\u003e\n\n\n \u003cbr /\u003e\n\n | **Note:** After you create a key, you might need to wait for 60 seconds or more before you perform another operation with the key. If you try to perform an operation with the key immediately after you create the key, and you receive an error, you can [retry\n | the request with exponential backoff](https://cloud.google.com/iam/docs/retry-strategy)\n\n \u003cbr /\u003e\n\n .\n\n[getStoreLayout](/android/work/play/emm-api/v1/enterprises/getStoreLayout)\n: Returns the store layout for the enterprise. If the store layout\n has not been set, returns \"basic\" as the store layout type and no\n homepage.\n\n[list](/android/work/play/emm-api/v1/enterprises/list)\n: Looks up an enterprise by domain name.\n This is only supported for enterprises created via the Google-initiated\n creation flow. Lookup of the id is not needed for enterprises created via\n the EMM-initiated flow since the EMM learns the enterprise ID in the\n callback specified in the Enterprises.generateSignupUrl call.\n\n[pullNotificationSet](/android/work/play/emm-api/v1/enterprises/pullNotificationSet)\n: Pulls and returns a notification set for the enterprises associated with\n the service account authenticated for the request. The notification set may\n be empty if no notification are pending.\n\n\n A notification set returned needs to be acknowledged within 20 seconds\n by calling Enterprises.AcknowledgeNotificationSet, unless the\n notification set is empty.\n\n\n Notifications that are not acknowledged within the 20 seconds will\n eventually be included again in the response to another PullNotificationSet\n request, and those that are never acknowledged will ultimately be deleted\n according to the Google Cloud Platform Pub/Sub system policy.\n\n\n Multiple requests might be performed concurrently to retrieve\n notifications, in which case the pending notifications (if any) will be\n split among each caller, if any are pending.\n\n\n If no notifications are present, an empty notification list is returned.\n Subsequent requests may return more notifications once they become\n available.\n\n[sendTestPushNotification](/android/work/play/emm-api/v1/enterprises/sendTestPushNotification)\n: Sends a test notification to validate the EMM integration with\n the Google Cloud Pub/Sub service for this enterprise.\n\n[setAccount](/android/work/play/emm-api/v1/enterprises/setAccount)\n: Sets the account that will be used to authenticate to the API as the\n enterprise.\n\n[setStoreLayout](/android/work/play/emm-api/v1/enterprises/setStoreLayout)\n: Sets the store layout for the enterprise. By default, storeLayoutType\n is set to \"basic\" and the basic store layout is enabled. The basic\n layout only contains apps approved by the admin, and that have\n been added to the available product set for a user (using the\n [setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet) call). Apps on the page are sorted in order of\n their product ID value. If you create a custom store layout (by setting\n storeLayoutType = \"custom\" and setting a homepage), the basic store\n layout is disabled.\n\n[unenroll](/android/work/play/emm-api/v1/enterprises/unenroll)\n: Unenrolls an enterprise from the calling EMM."]]
