Enterprises

如需本資源的方法清單,請見本頁結尾。

資源表示法

企業資源代表 EMM 和特定機構之間的繫結。使用此 API 時,可使用以下兩種方式之一為該繫結執行個體化:

  • 對 Google 管理的網域客戶來說,這項程序會使用 Enterprises.enrollEnterprises.setAccount (搭配從管理控制台和 Google API 控制台取得的構件),再透過更完整的手動程序提交至 EMM。
  • 對於 Google Play 管理版帳戶客戶,這項程序會使用 Enterprises.generateSignupUrlEnterprises.completeSignup 搭配 Google Play 管理版註冊 UI (Google 提供的機制),在不手動執行步驟的情況下建立繫結。
EMM 在 EMM 控制台中可以同時支援其中一種或兩種方法。詳情請參閱建立企業

{
  "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。