本頁面由 Cloud Translation API 翻譯而成。

註冊及佈建裝置

佈建是指設定要透過 enterprise的 policies。安裝裝置期間 Android Device Policy，用於接收及強制執行 policies。如果佈建成功後，API 會建立 devices 物件，並繫結將資料轉移至企業

Android Management API 會使用註冊權杖觸發布建作業上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作您使用的註冊權杖和佈建方法會裝置的擁有權 (個人擁有或公司擁有) 和管理模式 (工作) 設定檔或全代管裝置)，

個人擁有的裝置

Android 5.1 以上版本

員工擁有的裝置可以透過工作資料夾進行設定。工作資料夾為工作應用程式和資料提供獨立空間，與個人應用程式區隔應用程式和資料大多數的應用程式、資料和其他管理服務 policies 都適用於工作資料夾，員工的個人應用程式和資料則不會公開。

如要在個人裝置上設定工作資料夾，請建立註冊權杖 (請確認 allowPersonalUsage 已設為 PERSONAL_USAGE_ALLOWED)，並且使用下列其中一種佈建方法：

透過「設定」新增工作資料夾
下載 Android Device Policy
註冊權杖連結
登入網址

用於工作和個人用途的公司擁有裝置

Android 8 以上版本

設定公司擁有的裝置並設定了工作資料夾後，該裝置就能工作和個人用途在設有工作資料夾的公司裝置上：

大多數的應用程式、資料和其他管理服務policies都會套用到工作資料夾。
員工的個人資料夾不會對外公開。不過，企業強制執行特定裝置通用政策和個人使用政策。
企業可以透過 blockScope，對整個裝置，或只使用工作資料夾的工作資料夾。
devices.delete 和裝置指令適用於整部裝置。

如要使用工作資料夾設定公司擁有的裝置，請建立註冊事宜符記 allowPersonalUsage 設為 PERSONAL_USAGE_ALLOWED)，並且採用下列佈建方法：

零接觸註冊機制
QR 圖碼
登入網址
裝置政策控制器 (DPC) ID

僅限公司擁有的裝置處理工作

Android 5.1 以上版本

完整裝置管理功能適用於公司擁有的裝置用於工作用途企業可以管理裝置上的所有應用程式就能強制執行所有 Android Management API 政策和指令

也可以透過政策鎖定單一應用程式，或適用於特定用途或用途的小型應用程式。這是整個受管理的裝置稱為「專用裝置」。的註冊權杖這些裝置的「allowPersonalUsage」必須設為 PERSONAL_USAGE_DISALLOWED_USERLESS。

如要在公司擁有的裝置上設定完整管理服務，請建立註冊權杖。確認 allowPersonalUsage 已設為 PERSONAL_USAGE_DISALLOWED 或 PERSONAL_USAGE_DISALLOWED_USERLESS、並使用下列其中一種佈建方法。

零接觸註冊機制
QR 圖碼
登入網址 (不適用於專用裝置)
NFC
裝置政策控制器 (DPC) ID

政策可能會影響在裝置佈建過程中產生的 UI。這類政策包括：

PasswordPolicyScope：這項設定會決定密碼規定。
PermittedInputMethods：這會決定套件輸入法。
PermittedAccessibilityServices：這會決定全代管允許哪些無障礙服務裝置和工作資料夾。
SetupActions：這會決定在設定期間要執行的動作。
ApplicationsPolicy：這麼做可決定個別應用程式的政策。

您希望在工作應用程式安裝項目旁一併顯示密碼步驟和裝置註冊卡片，我們建議您更新政策，讓裝置隔離狀態，如果註冊時沒有相關聯的政策，就會發生這類狀態。除非為已填入項目的裝置設定指定最後選取的政策與設定需求相關完成佈建後完成後，您可以將政策變更為這通常代表交易不會十分要求關聯語意

建立註冊權杖

Android Management 簡介。 — **圖 1.**建立註冊並套用「policy1」的權杖而負責任的 AI 技術做法有助於達成這項目標1800 秒 (30 分鐘) 過後，符記就會失效。

您必須為要註冊的每部裝置取得註冊權杖 (您可以請對多部裝置使用相同的權杖)。如要申請註冊權杖，請呼叫 enterprises.enrollmentTokens.create。註冊權杖會在 1 天後失效預設為小時，但您可以指定自訂到期時間 (duration) 過去約 10,000 年

如果要求成功，會傳回 enrollmentToken 物件，其中包含 IT 管理員和使用者使用者可以使用的 enrollmentTokenId 和 qrcode 佈建裝置

指定政策

您也可以在套用政策的要求中指定 policyName 即可同時註冊裝置如果未指定 policyName，請參閱註冊沒有政策的裝置。

指定個人用途

allowPersonalUsage可決定是否要將工作資料夾新增至裝置佈建狀態設為 PERSONAL_USAGE_ALLOWED 可讓使用者建立工作資料夾 (個人裝置必須設定，公司擁有的裝置不一定要設定) 裝置)。

關於 QR code

QR code 是有效率的裝置佈建方法，適用於符合以下條件的企業：需要維護多個不同的政策傳回的 QR code enterprises.enrollmentTokens.create 是由鍵/值組合的酬載組成內含註冊權杖以及 Android 必備的所有資訊佈建裝置的裝置政策。

QR code 套裝組合範例

這個套件包含 Android Device Policy 的下載位置和註冊權杖

{
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME": "com.google.android.apps.work.clouddpc/.receivers.CloudDeviceAdminReceiver",
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM": "I5YvS0O5hXY46mb01BlRjq4oJJGs2kuUcHvVkAPEXlg",
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION": "https://play.google.com/managed/downloadManagingApp?identifier=setup",
    "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE":{
        "com.google.android.apps.work.clouddpc.EXTRA_ENROLLMENT_TOKEN": "{enrollment-token}"
    }
}

你可以使用「enterprises.enrollmentTokens.create」傳回的 QR code 或自訂內容如需可加入項目的完整清單 QR code 套件請參閱「建立 QR code」一文。

如要將 qrcode 字串轉換為可掃描的 QR code，請使用 QR code 產生器例如 ZXing。

佈建方法

本節說明不同的佈建裝置方法。

透過「設定」新增工作資料夾

Android 5.1 以上版本

如要在裝置上設定工作資料夾，使用者可以執行下列操作：

前往「設定」>Google >設定還原。
輕觸「設定工作資料夾」。

請按照下列步驟啟動設定精靈，將 Android Device Policy 下載到裝置上：裝置。接下來，系統會提示使用者掃描 QR code，或手動輸入註冊權杖，完成工作資料夾設定程序。

下載 Android Device Policy

Android 5.1 以上版本

如要在裝置上設定工作資料夾，使用者可以下載 Android 裝置 Google Play 商店的政策。應用程式安裝完畢後系統會提示使用者輸入 QR code 或手動輸入以完成工作資料夾設定程序。

註冊權杖連結

Android 5.1 以上版本

使用從 enrollmentTokens.create 傳回的註冊權杖或為企業的 signinEnrollmentToken 產生一個採用以下格式的網址：

https://enterprise.google.com/android/enroll?et=<enrollmentToken>

您可以將這個網址提供給 IT 管理員，由對方提供給使用者。使用者從裝置開啟連結時，系統會引導他們完成所有步驟工作資料夾設定。

登入網址

如使用這個方法，系統會將使用者導向頁面以進入完成佈建所需的必要資訊根據使用者您可以為使用者計算適當的政策，然後再繼續佈建裝置。例如：

在 enterprises.signInDetails[] 中指定登入網址。組合如要允許使用者將權限授予使用者，請allowPersonalUsage到 PERSONAL_USAGE_ALLOWED 建立工作資料夾 (個人裝置的必要設定，選用公司擁有的裝置)。

將產生的 signinEnrollmentToken 新增為 QR 的佈建額外項目代碼、NFC 酬載或零接觸或者，也可以提供將 signinEnrollmentToken 直接提供給使用者。
選擇下列任一選項：
1. 公司擁有的裝置：開機後或已恢復原廠設定後的裝置裝置，透過 QR code 和 NFC 將 signinEnrollmentToken 傳遞給裝置等代碼)，或要求使用者手動輸入符記。裝置將開啟步驟 1 指定的登入網址。
2. 個人擁有的裝置：請使用者從下列來源新增工作資料夾：「設定」。系統提示時，掃描包含 signinEnrollmentToken 的 QR code，或輸入權杖裝置會開啟在步驟中指定的登入網址 1.
3. 個人擁有的裝置：為使用者提供註冊權杖連結，註冊權杖是指 signinEnrollmentToken。裝置會開啟指定的登入網址。
檢查 Google 是否已驗證使用者。取得裝置使用 GET 參數佈建資訊 (在裝置註冊期間) provisioningInfo，並檢查該欄位的值 authenticatedUserEmail。如果這個欄位含有值，表示使用者已通過 Google 的驗證且無需進一步驗證
如果 Google 尚未驗證使用者，則您的登入網址就會提示使用者輸入認證依據他們的身分，你可以判斷適當的政策並取得裝置佈建程序使用 GET 參數的資訊 (在裝置註冊期間) provisioningInfo。

最佳做法：使用機構的單一登入 (SSO) 以便驗證使用者輸入的登入網址 (或任何後續重新導向)。登入網址是以 Chrome 自訂分頁和使用者系統會透過以下方式儲存單一登入 (SSO) 服務，供日後登入時使用：應用程式驗證。
呼叫 enrollmentTokens.create，指定適當的 policyId 根據使用者的憑證產生存取權

注意： 由於這個值是allowPersonalUsage 已在 enterprises.signInDetails[] 中指定。不可能變更個人使用價值。
使用網址重新導向，傳回步驟 5 產生的註冊權杖。表單 https://enterprise.google.com/android/enroll?et=<token>。

注意： 如果使用者無法完成佈建程序，可顯示自訂錯誤畫面，並重新導向至 https://enterprise.google.com/android/enroll/invalid可協助使用者重設裝置。

QR code 方法

Android 7.0 以上版本

如要佈建公司擁有的裝置，請產生 QR code 程式碼然後顯示在 EMM 控制台：

使用者 (通常是 IT 管理員) 會在新裝置或已恢復原廠設定的裝置上輕觸在同一處遊玩六次讓裝置發出提示使用者就能掃描 QR code
使用者掃描管理控制台中顯示的 QR code (或類似的應用程式)，註冊並佈建裝置。

NFC 方法

Android 6.0 以上版本

採用這個方法時，您必須建立 NFC 程式設計師應用程式，註冊權杖、初始政策和 Wi-Fi 設定、設定等客戶為了完整佈建或專屬裝置您或客戶安裝 NFC 後 Android 裝置上的程式設計師應用程式後，該裝置就能成為程式設計師裝置。

如需 NFC 方法的支援詳細指南，請參閱 Play EMM API 開發人員說明文件。該網站也包含預設程式碼已推送的參數傳送至 NFC 觸碰機。如要安裝 Android Device Policy，請設定下載項目以便執行以下動作：

https://play.google.com/managed/downloadManagingApp?identifier=setup

裝置政策控制器 (DPC) ID 方法

如果無法透過 QR code 或 NFC 新增 Android Device Policy，使用者或 IT 管理員如要佈建公司擁有的裝置，請按照下列步驟操作：

按照新裝置或已恢復原廠設定的裝置，按照設定精靈指示操作。
輸入 Wi-Fi 登入詳細資料，將裝置連上網際網路。
系統提示您登入帳戶時，請輸入 afw#setup，這會下載 Android 應用程式。裝置政策。
掃描 QR code 或手動輸入註冊權杖，佈建裝置

零接觸註冊機制

Android 8.0 以上版本 (Pixel 7.1 以上版本)

向授權零接觸經銷商購買的裝置可透過零接觸註冊機制，輕鬆預先設定裝置並自動佈建

機構可以建立設定，其中包含佈建詳細資料透過零接觸註冊機制入口網站安裝零接觸裝置或使用 EMM 控制台 (請參閱零接觸客戶 API)。第一項啟動，零接觸裝置會檢查裝置是否已獲派設定，如果是，裝置就會下載 Android Device Policy，然後完成裝置，藉此管理裝置。

如果客戶使用零接觸註冊機制入口網站，必須為每項設定選取「Android Device Policy」做為 EMM DPC 建立。詳細說明如何使用入口網站，包括建立方式您可以透過 Android Enterprise 取得 Android Enterprise 版本的功能，以及為裝置指派設定。說明中心。

如果您希望客戶直接透過 EMM 控制台，您必須整合零接觸客戶 API。時間建立設定時，您要在 dpcExtras 欄位。以下 JSON 程式碼片段示範要執行什麼動作的基本範例包含在 dpcExtras 中，並使用已新增的登入權杖。

{
   "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME":"com.google.android.apps.work.clouddpc/.receivers.CloudDeviceAdminReceiver",
   "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM":"I5YvS0O5hXY46mb01BlRjq4oJJGs2kuUcHvVkAPEXlg",
   "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE":{
      "com.google.android.apps.work.clouddpc.EXTRA_ENROLLMENT_TOKEN":"{Sign In URL token}"
   }
}

在設定期間啟動應用程式

設定動作 — **圖 2.**使用「`setupActions`」啟動應用程式設定期間。

在 policies 中，您可以指定一個要啟動 Android Device Policy 的應用程式即可。例如，您可以啟動 VPN 應用程式使用者可以在設定程序中調整 VPN 設定。應用程式必須傳回 RESULT_OK 以傳送完成信號，並允許 Android Device Policy 完成裝置或工作資料夾的佈建作業。如何在設定期間啟動應用程式：

確認應用程式的 installType 為 REQUIRED_FOR_SETUP。如果無法裝置安裝或啟動後，佈建作業就會失敗。

{
   "applications":[
      {
         "packageName":"com.my.vpnapp.",
         "installType":"REQUIRED_FOR_SETUP"
      }
   ]
}

在 setupActions 中新增應用程式的套件名稱。使用 title和 description：請指定面向使用者的指示。

{
   "setupActions":[
      {
         "title":{
            "defaultMessage":"Configure VPN"
         },
         "description":{
            "defaultMessage":"Enable your VPN client to access corporate resources."
         },
         "launchApp":{
            "packageName":"com.my.vpnapp."
         }
      }
   ]
}

為了區分應用程式啟動和 launchApp，活動首次於應用程式中啟動時，其中包含布林意圖額外項目 com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION (設為 true)。這項額外功能可讓您根據應用程式從 setupActions 或使用者啟動

應用程式傳回 RESULT_OK 後，Android Device Policy 就會完成剩餘的應用程式佈建裝置或工作資料夾所需的步驟。

在設定過程中取消註冊

應用程式以 SetupAction 的形式啟動，可取消並返回註冊 RESULT_CANCELED。

取消註冊會重設公司擁有的裝置或刪除工作儲存在個人裝置上的個人資料。

注意：取消註冊會觸發非使用者動作確認對話方塊。該應用程式有責任錯誤對話方塊。

對新註冊的裝置套用政策

決定新註冊的裝置套用政策的方式是由您決定，符合客戶需求以下說明幾種做法而是使用：

(建議做法) 建立註冊權杖時，您可以指定一開始會連結的政策名稱 (policyName) 裝置。使用權杖註冊裝置後，系統會自動執行政策套用於裝置。
將政策設為企業的預設政策。如果沒有政策名稱註冊權杖中指定的政策，但有一個政策名稱為 enterprises/<enterprise_id>/policies/default，每部新裝置會在註冊期間自動連結至預設政策。
訂閱 Cloud Pub/Sub 主題：接收新註冊裝置的相關通知。為了回應 ENROLLMENT通知，呼叫 enterprises.devices.patch 即可政策連結裝置與政策

註冊沒有政策的裝置

如果裝置在註冊時未提供有效政策，則會進入註冊模式隔離。遭到隔離的裝置在所有裝置皆無法使用，直到裝置已連結至政策

如果裝置未在 5 分鐘內連結至政策，則註冊裝置。，且裝置已恢復原廠設定。透過隔離裝置狀態，您可以有機會進行授權檢查或其他註冊驗證做為解決方案的一部分

授權檢查工作流程範例

已註冊裝置，但未設定預設政策或特定政策。
檢查企業剩餘的授權數量。
如果可用的授權，請透過 devices.patch 附加，授權數量就會減少。如果沒有可用的授權數，請使用devices.patch停用裝置。或者，如果裝置未連接裝置，則 API 會恢復原廠設定政策。