---
title: Android 管理 API
slug: nmdm/admin-guide/zhcn/vnow/android-api
createdAt: 2026-09-24T15:38:04.000Z
---

Android 管理 API (AMAPI) 是 Google 提供的云平台 API，用于将 Google Android UEM 功能集成到 Ivanti Neurons for MDM。 在 Android Enterprise 设置中，您可以启用 Android 管理 API 框架以管理 Android Enterprise 设备，无需将客户端应用安装到适用于设备管理的设备。 目前，不支持将 Go app 推送给设备的其他功能，如 MTD 等。

在设置中配置 Android Enterprise 帐户时，您将可以启用并使用 Android 管理 API 框架。 在启用后，您可以：

- 添加注册配置文件，以将 QR 码用于设备注册。
- 出于特定目的，为已注册设备创建专用设备配置（企业拥有的单用途或 COSU）。

目前，只有在运行 Android 版本 9 或更高版本并且安装 Google Play 和在专用模式中配置的设备，才支持 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 配置已分发到工作托管设备（设备所有者模式），以在自助服务终端模式中仅向用户提供一个应用。 不支持公司拥有设备上的工作配置文件中的设备。

使用此配置，管理员可以配置设备，以将应用固定到屏幕；这样，自助服务终端模式用户无法取消固定此应用，并导航离开应用到设备的其他屏幕，或在设备上使用任何其他应用。

:::hint{type="info"}
通过在“高级选项和应用配置”中选择“在设备上安装”选项，其他应用也可以在 AMA 设备上强制安装；但在自助服务终端应用通过配置固定到屏幕时，您将无法与其进行交互。 对于多应用自助服务终端，建议使用工作托管设备（设备所有者模式）的自助服务终端功能。 此功能将对应用和设备设置提供更多控制，并且也可以扩展到多用户模式。
:::

通过按需查看各种选项，管理员可以更改配置，例如允许系统导航，以及通过 Google DPC 使用推送到最终用户的设备的其他应用。

为用户分配的优先级确定 COSU 配置。 优先级最高的配置会用于将策略配置推送到 Google。 COSU 配置会应用于已定义空间中的设备。 如果在默认空间中定义，将委派到其他空间。

要配置：

1. 转到**配置 > + 添加**。
2. 在**锁定和自助服务终端：Android Enterprise 配置**中，单击**专用设备（企业拥有的单用途或 COSU）**。
3. 输入配置的名称。
4. 输入描述。
5. 通过单击相关选项卡，您可以配置以下设置：

- **应用设置**
- **通用锁定**
- **自助服务终端自定义**
- **系统设置**

下表会提供可配置字段的详细信息：

| **设置**        | **说明**                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **应用设置**      |                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **应用名称**      | 通过键入应用名称，或键入应用名称的首字母，选择要在设备上固定的应用，直到您在下拉列表中看到所需的应用。 如果您未在下拉列表中看到所需的应用，请确保要部署的应用是 Play Store 中的可用公共/私人应用，并且已添加到 App Catalog。<br />此字段是必填字段。 如果您未在此字段中选择要添加的应用，将不允许创建配置。 您仅可添加公共和私人应用。 无法添加内部应用和 Web 应用（私人）。                                                                                                                                                                                                        |
| **通用锁定**      |                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **保持屏幕开启**    | 对于需要保持开启状态的设备，将电池配置为插入模式。 选择以下任一选项：<br />- **AC** - 电源是交流充电器<br />- **无线**<br />- **USB** - 电源是 USB 端口<br />- **任意** - 电源来自交流充电器或 USB 端口，或者无线充电器。                                                                                                                                                                                                                                                                 |
| **自助服务终端自定义** |                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **自定义状态栏**    | 选择以下任意选项，以自定义目标设备中的状态栏：<br />- **通知和系统信息已启用** - 在状态栏中显示系统信息和通知。<br />- **仅启用系统信息** - 仅在状态栏中显示系统信息。                                                                                                                                                                                                                                                                                                                |
| **自定义系统导航**   | 选择以下任意选项，以指定在 kiosk 模式中对导航功能（主页和概览按钮）的访问权限：<br />- **已启用** - 启用主页和概览按钮导航。 如果选择此选项，用户可以导航到指定应用外部。<br />- **已禁用** - 禁用主页和概览按钮导航。<br />- **仅限主页按钮** - 仅启用主页按钮导航.<br />所有这些选项提供返回按钮。                                                                                                                                                                                                                                  |
| **启用全局操作**    | 选择以在自助服务终端模式中启用全局操作。 通过此选项，控制与电源按钮关联的重启和关机功能。                                                                                                                                                                                                                                                                                                                                                                     |
| **启用系统错误对话框** | 选择以在自助服务终端模式中启用崩溃或无响应应用的错误对话框。                                                                                                                                                                                                                                                                                                                                                                                    |
| **系统设置**      |                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **系统更新设置**    | 配置以下设置，以管理系统更新：<br />- **系统更新** - 选择所需的系统更新类型。<br />- **自动** - 在更新可用时立即自动安装。<br />- **推迟** - 自动安装最多推迟 30 天。<br />- **窗口化** - 在每日维护时段内自动安装。 设置维护时段的开始和结束时间。<br />在设备上安装的更新可能会因支持的功能集、Android 版本和在设备上安装的 Google DPC 版本而异。<br />- **冻结期** - 在冻结期期间设置设备时，将阻止所有传入系统更新，并且不会安装。 单击**添加冻结期**，以设置冻结期的**开始日期**和**结束日期**。<br />在设备冻结期结束时，将应用正常更新行为。 如果结束日期在开始日期前，冻结期将在当年和下一年之间延长。<br />冻结期可以设置为最多 90 天。 2 个连续冻结期必须间隔至少 60 天。 |

6. 单击**下一步**。
7. 选择下列分配选项之一：

- **所有设备**
- **无设备**（默认）
- **自定义**

8. 单击**完成**。

### 管理 AMAPI 设备中的应用

在将 COSU 配置分发到设备时，应用将推送并固定到 AMA 设备的屏幕。 无论 COSU 配置是否推送到设备，都可以管理在 AMA 设备上安装的应用。 以下是这些设备中的应用管理的详细信息：

- 仅支持公共私人应用；不支持内部应用和 Web 剪辑。
- 仅在安装设置启用“在设备上安装”或“静默安装”选项时，才可以推送应用。 在未启用其中任意选项的情况下，设备或设备的 Play Store 将不会显示分配到用户/设备的应用，以进行任何用户操作。
- 支持的应用配置是托管 Google Play 和工作托管设备 (Android for Work) 设置。 支持应用程序的托管配置，包括对 OEMConfig 应用程序的托管配置的支持。

:::hint{type="info"}
安装和卸载配置的完成时间可能会有所不同，具体取决于 Google（消息服务）发送的关于是否已执行所需操作的通知。
:::

- 现在，Go app 将默认作为 AMA 设备注册的一部分进行安装。 在注册过程中，应用程序将固定到屏幕，并将于设置完成后在后台运行。

:::hint{type="info"}
除了基于制造商、操作系统版本和安全补丁级别的设备注册要求强制实施之外，不支持其他策略。 支持“设备允许列表”功能，该功能仅允许列入允许列表的设备注册 Ivanti Neurons for MDM。
:::

### 管理 AMAPI 设备上的应用程序反馈支持

可以在 AMAPI (COSU) 设备上管理应用程序反馈支持。 当设备在 AMAPI (COSU) 模式下完成注册后，托管应用程序配置将直接从 Google 推送到 Ivanti Neurons for MDM，无需 Go app 进行任何干预。 可以通过**设备详细信息 > 安装的应用程序 > 查看反馈**在设备级别查看托管应用程序反馈信息，或者也可以在“应用程序配置反馈”选项卡下的应用程序目录中导航至特定的 Android 应用程序，在单个应用程序级别查看托管应用程序反馈信息，以便了解所有设备的总体报告。 有关应用程序反馈机制的信息，请参阅[同步和获取应用反馈](docId\:G6kewOoeHAZmZXLY6Vvgd)。

### AMAPI 局限性

AMAPI 目前具有以下限制：

- 仅支持专用设备（COSU 模式）。

### 支持的配置

AMAPI 支持以下配置：

- 应用分发（单个或多个应用）
- 应用的托管应用配置推送到设备
- Wi-Fi 配置
- Android 企业锁定专用 (COSU) 配置
- Always-on VPN 配置
