如需本資源的方法清單,請見本頁結尾。
資源表示法
Enterprise 資源代表 EMM 與特定機構之間的繫結。您可使用這個 API,透過以下兩種方式之一將繫結例項化,方法如下:
- 如果是 Google 代管的網域客戶,這項程序涉及使用
Enterprises.enroll
和Enterprises.setAccount
(搭配從管理控制台和 Google API 控制台取得的成果),並透過更簡易或更簡易的手動程序提交給 EMM。 - 如果是 Google Play 管理版帳戶客戶,這項程序需要將
Enterprises.generateSignupUrl
和Enterprises.completeSignup
搭配 Google Play 管理版註冊 UI (Google 提供的機制) 使用,不必手動操作即可建立繫結。
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
資源名稱 | 值 | 說明 | 附註 |
---|---|---|---|
administrator[] |
list |
企業的管理員。這項功能僅適用於透過 EMM 啟動的流程建立的企業。 |
|
administrator[].email |
string |
管理員的電子郵件地址。 | |
id |
string |
企業的專屬 ID。 |
|
kind |
string |
||
name |
string |
企業名稱 (例如「Example, Inc」)。 | |
primaryDomain |
string |
公司的主網域,例如「example.com」。 |
方法
- acknowledgeNotificationSet
- 確認從 Enterprises.PullNotificationSet 收到的通知,避免後續呼叫傳回相同通知。
- completeSignup
- 指定完成權杖和 Enterprise 權杖,完成註冊流程。請勿針對特定企業權杖多次呼叫這項要求。
- createWebToken
- 傳回專屬權杖,來存取可嵌入的 UI。如要產生網路 UI,請將產生的權杖傳遞至 Google Play 管理版 JavaScript API。每個權杖都只能用於啟動一個 UI 工作階段。詳情請參閱 JavaScript API 說明文件。
- 註冊
- 使用呼叫式 EMM 為企業註冊。
- generateSignupUrl
- 產生註冊網址。
- get
- 擷取企業的名稱和網域。
- getServiceAccount
- 傳回服務帳戶和憑證。該服務帳戶可呼叫 setAccount 來繫結至企業。服務帳戶專屬於此企業和 EMM,如果企業未繫結,就會刪除。憑證包含私密金鑰資料,且不會儲存在伺服器端。
您必須等到呼叫 Enterprise.Register 或 Enterprises.CompleteSignup 後,才能呼叫這個方法,而 Enterprises.SetAccount 之前則會傳回錯誤。
第一個呼叫後的後續呼叫會產生一組新的不重複的憑證,而會使先前產生的憑證失效。
將服務帳戶與企業建立繫結後,即可使用 serviceAccountKeys 資源來管理服務帳戶。 - getStoreLayout
- 傳回企業的商店版面配置。如果尚未設定商店版面配置,則會傳回「基本」做為商店版面配置類型,且沒有首頁。
- list
- 依據網域名稱查詢企業。這項功能僅適用於透過 Google 啟動的建立流程建立的企業。如果是透過 EMM 啟動的流程建立的企業,則不需要查詢 ID,因為 EMM 會在 Enterprises.generateSignupUrl 呼叫中指定的回呼中學習企業 ID。
- pullNotificationSet
- 針對針對要求驗證的服務帳戶,提取並傳回相關企業的通知集。如果沒有待處理的通知,通知集可能會顯示空白。
除非通知集為空白,否則傳回的通知集必須在 20 秒內透過呼叫 Enterprises.AcknowledgeNotificationSet 進行確認。
未在 20 秒內確認的通知最終會再次納入其他 PullNotificationSet 要求的回應中,而未確認的通知最終將根據 Google Cloud Platform Pub/Sub 系統政策刪除。
系統可能會同時執行多項要求以擷取通知,在此情況下,如果有待處理的通知,系統會將待處理的通知 (如有) 分配給每個呼叫端。
如果沒有通知,會傳回空白通知清單。後續要求可能會在可用時傳回更多通知。 - sendTestPushNotification
- 傳送測試通知,為這個企業驗證 EMM 與 Google Cloud Pub/Sub 服務的整合。
- setAccount
- 設定要用來以企業身分驗證 API 的帳戶。
- setStoreLayout
- 設定企業的商店版面配置。根據預設,storeLayoutType 會設為「basic」,並啟用基本儲存庫版面配置。基本版面配置僅包含管理員核准的應用程式,且已新增至使用者可用的產品集 (使用 setAvailableProductSet 呼叫)。頁面上的應用程式會依產品 ID 值排序。如果建立自訂商店版面配置 (透過設定 storeLayoutType = "custom" 並設定首頁),基本商店版面配置就會停用。
- 取消註冊
- 為呼叫端的 EMM 取消註冊企業。