如需本資源的方法清單,請見本頁結尾。
資源表示法
企業資源代表 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。如要產生 並把產生的權杖傳遞至 Google Play 管理版 JavaScript 也能使用 Google Cloud CLI 或 Compute Engine API每個權杖只能用來啟動一個 UI 工作階段。詳情請參閱 如需其他資訊,請參閱 JavaScript API 說明文件。
- 註冊
- 透過 EMM 為企業註冊。
- generateSignupUrl
- 產生註冊網址。
- 取得
- 擷取企業的名稱和網域。
- getServiceAccount
- 傳回服務帳戶和憑證。服務帳戶
即可呼叫 setAccount 與企業連結。服務帳戶
是這個企業和 EMM 的專屬 ID,如果是企業,就會遭到刪除
沒有繫結。憑證包含私密金鑰資料,不會儲存
伺服器端代碼
只有在呼叫 Enterprises.enroll 或 Enterprises.CompleteSignup 以及之前的之前 Enterprises.SetAccount;否則會傳回錯誤
則在第一個以後的後續呼叫中,將會產生一組新的不重複 憑證,並使先前產生的憑證失效。
將服務帳戶繫結至企業後,即可管理服務帳戶 使用 serviceAccountKeys 資源 - getStoreLayout
- 傳回企業的商店版面配置。如果商店版面配置 尚未設定,傳回「basic」設為商店版面配置類型, 首頁。
- list
- 依據網域名稱查詢企業。 這個選項僅適用於透過 Google 發起的 建立流程如果是透過 是從 EMM 啟動的流程,因為 EMM 會學習 Enterprises.generateSignupUrl 呼叫中指定的回呼。
- pullNotificationSet
- 擷取並傳回與
已依此要求完成驗證的服務帳戶。通知設定則可能是
如果沒有待處理的通知,則會空白。
傳回的通知集需要在 20 秒內確認 呼叫 Enterprises.AcknowledgeNotificationSet,除非 通知集空白。
如未在 20 秒內確認通知, 最終會再次包含在對另一個 PullNotificationSet 的回應中 任何從未確認過的要求都將遭到刪除 更新依據。
可能會同時執行多項要求來擷取 在這種情況下,系統會發出待處理通知 (如有) 就會分配給每個呼叫端 (如果有任何待處理)。
如果沒有任何通知,則會傳回空白的通知清單。 後續要求可能會在送出後傳回更多通知 廣告。 - sendTestPushNotification
- 傳送測試通知,驗證與 EMM 整合的結果 使用 Cloud Pub/Sub 服務
- setAccount
- 這個外掛程式能設定要用於驗證 API 的帳戶, 企業。
- setStoreLayout
- 設定企業的商店版面配置。根據預設,storeLayoutType 是設為「basic」並啟用基本商店版面配置基本 版面配置只包含經管理員核准,且 的方法是使用 setAvailableProductSet 呼叫)。頁面上的應用程式會按照 產品 ID 值如果您要建立自訂商店版面配置 (透過 storeLayoutType =「custom」以及設定首頁) 基本商店 版面配置已停用。
- 取消註冊
- 為企業取消註冊通話 EMM。