---
title: Android 管理 API
slug: nmdm/admin-guide/zhtw/vnow/android-api
createdAt: 2026-09-24T15:39:05.000Z
---

Android 管理 API (AMAPI) 是 Google 的雲端平台 API，將 Google Android UEM 功能整合至 Ivanti Neurons for MDM。 在 Android Enterprise 設定中，您可以啟用 Android 管理 API 架構以管理 Android Enterprise 裝置，無需在裝置上安裝用戶端應用程式就能進行裝置管理。 目前，不支援針對其他功能 (例如 MTD 等) 將 Go app 推送至裝置。

當您在設定中已設定 Android Enterprise 帳戶時，您將可以啟用和使用 Android 管理 API 架構。 啟用後，您就可以：

- 新增註冊描述檔，為 Device Enrollment 使用 QR 碼。
- 針對註冊的裝置建立專屬的裝置配置 (公司擁有的單一使用，或 COSU) 以符合特定目的。

僅在已安裝 Google Play 並在專屬模式中佈建的 Android 第 9 版或更新版本裝置支援 Android 管理 API。 企業專屬模式也是指公司擁有的單一使用 (COSU) 是一種裝置擁有者模式。 此外，此功能也支援以下裝置動作：

- 鎖定
- 重新開機
- 同步至伺服器
- 抹除

定期排定裝置登記 (每小時)。 如要立即採取行動，在裝置詳細資料頁面中使用裝置動作「同步至伺服器」。 AMAPI 裝置不會傳送強制簽入至 Ivanti Neurons for MDM。 當裝置上有活動時，會執行庫存更新。

## 啟用 Android 管理 API

若要啟用 Android 管理 API，請前往**管理員 > Android Enterprise > 授權 Google (需要有效的 Google 位址) > 已啟用 Android Enterprise**。

已啟用 Android 管理 API 功能的狀態 (**是**表示已啟用，而**否**表示已停用) 也會顯示在「裝置詳細資訊」頁面中。

:::hint{type="info"}
COSU 目前不支援 GSuite 帳戶。
:::

## 新增註冊描述檔

需要建立註冊描述檔才能使用 QR 碼掃描或權杖的英數字元字串註冊 Android 裝置。 只有在啟用 Android 管理 API 後，才能建立註冊描述檔。 您也可以建立與註冊描述檔關聯的自訂裝置屬性。

1. 選擇**管理 > Android Enterprise > 註冊描述檔**。
2. 在**註冊描述檔 - 公司擁有的專屬裝置**視窗中進行以下設定。
3. 按一下**儲存**。 **描述檔摘要**視窗顯示以下權杖詳細資料：

| **設定**     | **描述**                                                                                                                                                                                                             |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **名稱**     | 輸入可識別此註冊描述檔的名稱。                                                                                                                                                                                                    |
| **描述**     | 輸入可說明此註冊描述檔用途的描述。                                                                                                                                                                                                  |
| **使用者名稱**  | 輸入有效使用者名稱的前幾個字母，然後從顯示的相符結果中做選擇。<br />有效的使用者名稱可來自本機使用者或 LDAP 使用者。<br />針對個別使用者建立註冊描述檔，註冊描述檔會在描述檔中使用 QR 碼標記要顯示為屬於該使用者的已註冊裝置。                                                                                         |
| **權杖有效性**  | 輸入驗證權杖 QR 碼掃描的有效天數。 輸入的數字應在 1-30 之間。 如果您使用權杖或註冊後註冊描述檔有效期，裝置會重設。                                                                                                                                                    |
| **自訂裝置屬性** | 在動作欄中，按一下 **+新增**以新增要與註冊描述檔建立關聯的自訂裝置屬性。<br />1. 從**屬性名稱**欄中的下拉清單中選擇自訂裝置屬性。<br />2. 在**值**欄中，輸入自訂屬性的值。<br />3. 按一下**儲存**。 表格中會顯示新增的自訂裝置屬性。 如要刪除，在「動作」欄中按一下**刪除**選項。<br />自訂屬性只能在設定檔建立期間新增至註冊設定檔。 在建立描述檔後，就無法編輯屬性欄位。 |

- 名稱
- 描述
- 使用者名稱
- 權杖建立日期
- 權杖到期日
- 權杖值
- QR 碼
- 自訂裝置屬性。

:::hint{type="info"}
如果在註冊過後 10 分鐘內無法取得裝置的適當配置，裝置將會重設。 在此情況下，您應使用註冊權杖/QR 碼重新註冊。
:::

在建立註冊描述檔後，它會列在**註冊描述檔**頁面。 您可以執行**動作**欄中下列其中任何一項動作。

- 在描述檔摘要視窗中，按一下檢視圖示以檢視註冊描述檔的詳細資料。 QR 碼也會顯示在此視窗中。
- 按一下編輯圖示以編輯註冊描述檔的詳細資料。

:::hint{type="info"}
您只能編輯權杖有效性。 無法編輯其他的屬性。
:::

按一下刪除圖示以刪除註冊描述檔。

## 建立 COSU 配置

管理員可使用 Android Enterprise 設定用於特定目的之專屬裝置 (公司擁有的單一使用，或 COSU) 配置。COSU 配置會發佈至受工作管理的裝置 (裝置擁有者模式)，僅在單一應用模式下為使用者提供一種可用的 app。 不支援啟用公司擁有裝置上的工作描述檔的裝置。

使用此配置，管理員可以將裝置設為將 app 釘選至畫面，如此單一應用模式使用者就無法取消釘選此 app，並離開此 app 前往裝置的其他畫面，或使用裝置上的任何其他 app。

:::hint{type="info"}
在「進階選項與 App 配置」之下選擇「在裝置上安裝」選項，也可以將其他 app 強制安裝在 AMA 裝置上，但是當透過配置將單一應用 app 釘選至畫面上時，您將無法與它們互動。 針對多個 app 單一應用，建議使用受工作管理的裝置 (裝置擁有者) 的單一應用功能。 這可讓您更能控制 app 和裝置設定，並可延伸至多使用者模式。
:::

管理員可以根據需求檢視不同的選項變更配置，例如允許系統導覽和可以使用透過 Google DPC 為使用者推送至裝置的其他 app。

會依所指派給配置的優先順序來判斷 COSU 配置。 在推送原則配置至 Google 時使用最高優先順序配置。 COSU 配置會套用至定義空間內的裝置。 如果在預設空間已定義，則可以委派給其他空間。

如要配置：

1. 前往**配置 > +新增**。
2. 在**鎖定與單一應用：Android Enterprise 配置**中，按一下**專屬裝置 (公司擁有的單一使用，或 COSU)**。
3. 輸入配置的名稱。
4. 輸入描述。
5. 按一下相關標籤，您可進行以下設定：

- **App 設定**
- **一般鎖定**
- **單一應用自訂**
- **系統設定**

下表提供可設定欄位的詳細資料：

| **設定**         | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **App 設定**     |                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **App 名稱**     | 輸入 app 的名稱時，輸入 app 的名稱開頭的幾個字母直到您在下拉式清單清單中看到所需的 app，然後選擇要釘選在 app 上的裝置。 如果您在下拉清單中未看到所需的 app，請確定您要部署的 app 在 Play Store 中為公用/私人 app，而且已新增至 App Catalog。<br />此欄位為必填。 如果您在此欄位中未選取要新增的 app，將無法建立配置。 您只能新增公用和私人 app。 無法新增內部開發的 app 和 Web app (私人)。                                                                                                                                                                            |
| **一般鎖定**       |                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **保持顯示**       | 針對裝置所處的模式設定連接的電源。 請選擇下列任何選項：<br />- **AC** - 電源為 AC 充電器<br />- **無線**<br />- **USB** - 電源為 USB 連接埠<br />- **任意** - 電源是來自 AC 充電器或 USB 連接埠或無線充電器。                                                                                                                                                                                                                                                                        |
| **單一應用自訂**     |                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **自訂狀態列**      | 請選擇下列任何選項，在目標裝置上自訂狀態列：<br />- **通知與系統資訊已啟用** - 在狀態列中顯示系統資訊和通知。<br />- **僅系統資訊已啟用** - 在狀態列中僅顯示系統資訊。                                                                                                                                                                                                                                                                                                                     |
| **自訂系統導覽**     | 請選擇下列任何一個選項，在 kiosk 模式下指定導覽功能的存取 (「首頁」及「概覽」按鈕):<br />- **已啟用** - 啟用主畫面和概覽按鈕導覽。 如果此選項已選取，使用者可離開指定的 app。<br />- **已停用** - 停用主畫面和概覽按鈕導覽。<br />- **僅限首頁按鈕** - 僅啟用首頁按鈕導覽。<br />所有這些選項都可使用返回按鈕。                                                                                                                                                                                                                              |
| **啟用全域動作**     | 選擇在單一應用模式中啟用的全域動作。 您可透過此選項來控制重新啟動並關閉與電源按鈕關聯的功能。                                                                                                                                                                                                                                                                                                                                                                        |
| **啟用系統錯誤對話方塊** | 選擇此選項，為單一應用模式中當機或無回應的 app 啟用錯誤對話方塊。                                                                                                                                                                                                                                                                                                                                                                                    |
| **系統設定**       |                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **系統更新設定**     | 設定以下管理系統更新設定：<br />- **系統更新** - 選擇所需的系統更新類型。<br />- **自動** – 有可用的更新時，就會自動安裝。<br />- **延後** - 將自動安裝延後最長 30 天。<br />- **範圍限制** - 在每日維護期間自動安裝。 為維護期間設定開始和結束時間。<br />在裝置上安裝更新視支援的功能集、Android 版本，以及安裝在裝置上的 Google DPC 版本而定。<br />- **凍結期間** - 當裝置設在凍結期間內，將會封鎖而且不會安裝所有傳入的系統更新。 按一下**新增凍結期間**，以設定凍結期間的**開始日期**和**結束日期**。<br />當裝置不在凍結期間，會套用正常的更新行為。 如果結束日期早於開始日期，凍結期間會延長至當年到來年之間。<br />凍結期間可設為最長 90 天。 兩個連續凍結期間之間必須相隔至少 60 天。 |

6. 按**下一步**。
7. 請選擇下列發佈選項之一：

- **所有裝置**
- **沒有裝置** (預設)
- **自訂**

8. 按一下**完成**。

### 管理 AMAPI 裝置上的 app。

當 COSU 配置發佈至裝置時，會將 app 推送並釘選至 AMA 裝置的畫面上。 不論推送至裝置的 COSU 配置為何，仍可以管理已安裝在 AMA 裝置上的 app。 以下為這些裝置上的 app 管理詳細資訊：

- 僅支援公用、私人 app；不支援內部開發 app 和 Web Clip。
- 僅當「在裝置上安裝」或「無訊息自動安裝」選項已啟用時，才會推送 app。 未啟用這些選項之下，在裝置或在裝置的 Play Store 上的任何使用者動作將不會看到指派至使用者/裝置的 app。
- 支援的 app 配置為 Managed Google Play 和工作管理裝置 (Android for Work) 設定。 支援應用程式的受管理組態，包括用於 OEMConfig 應用程式的受管理組態。

:::hint{type="info"}
組態安裝和解除安裝的完成時間視 Google (傳訊服務) 關於是否已執行所需動作的通知而定。
:::

- 現在作為 AMA 裝置註冊的一部分，將會依預設安裝 Go app。 在註冊程序期間，應用程式將會釘選在畫面上，並且在設定完成時於背景中執行。

:::hint{type="info"}
不支援基於製造商、OS 版本和安全性修補程式等級實施的裝置註冊要求以外之原則。 裝置允許清單功能，僅允許列入允許清單的裝置向 Ivanti Neurons for MDM 註冊。
:::

### 管理 AMAPI 裝置上的應用程式回饋支援

可以在 AMAPI (COSU) 裝置上管理應用程式回饋支援。 當裝置在 AMAPI (COSU) 模式下註冊時，受管理的應用程式組態將直接從 Google 推送至 Ivanti Neurons for MDM 而不會受到 Go app 的任何干預。 您可以在**裝置詳細資訊 > 已安裝的應用程式 > 檢視回饋**中檢視裝置層級的受管理應用程式回饋資訊，或者可瀏覽到「應用程式組態回饋」索引標籤下方應用程式目錄中的特定 Android 應用程式，檢視個別應用程式層級的相關資訊，瞭解所有裝置的整體報告。 如需有關應用程式回饋機制的資訊，請參閱[同步並擷取 App 回饋](docId:9vHjcA8G1eHNV0XZ38x2U)。

### AMAPI 限制

目前，AMAPI 有以下限制:

- 僅支援專屬的裝置 (COSU 模式)。

### 支援的配置

以下配置支援 AMAPI：

- App 發佈 (單一或多個 app)
- 受管理的 App 配置用於推送至裝置的 app
- Wi-Fi 配置
- Android Enterprise 鎖定專屬 (COSU) 配置
- Always-on VPN 組態
