Enterprises

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

資源表示法

Enterprise 資源代表 EMM 與特定機構之間的繫結。您可使用這個 API，透過以下兩種方式之一將繫結例項化，方法如下：

如果是 Google 代管的網域客戶，這項程序涉及使用 Enterprises.enroll 和 Enterprises.setAccount (搭配從管理控制台和 Google API 控制台取得的成果)，並透過更簡易或更簡易的手動程序提交給 EMM。
如果是 Google Play 管理版帳戶客戶，這項程序需要將 Enterprises.generateSignupUrl 和 Enterprises.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。如要產生網路 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 取消註冊企業。