作为管理员,您可以使用逗号分隔值 (CSV) 文件添加和配置多个第三方应用。您可以在 Google 管理控制台中下载空白的 CSV 模板,也可以下载包含管理控制台中所有现有第三方应用的 CSV 文件并进行修改或添加。
开始前须知
- CSV 文件的大小上限为 10 MB。
- 上传文件时,“Type”(类型)、“Id”“Access”(访问权限)和“Org Unit”(组织部门)列中的信息将替换管理控制台中的现有信息。
- 对于您不想更改的信息,您可以删除相应列、原样保留相应信息或删除这些信息。
- 如果您删除某列中的所有信息,但在 CSV 文件中保留此列,那么当您上传文件时,系统不会移除管理控制台中的现有信息。
- 如果您不想修改特定应用,可以在电子表格中保留相应行或移除该行。如果您从文件中移除某个应用,该应用不会被删除。
通过 CSV 文件添加和配置应用
第 1 步:下载 CSV 文件
-
-
在管理控制台中,依次点击“菜单”图标 安全性访问权限和数据控件API 控件管理第三方应用的访问权限。
您必须以超级用户身份登录,才能执行此任务。 - (可选)如要仅配置访问过 Google 数据的应用,请在访问过的应用部分,点击查看列表。
- 点击批量更新列表,然后选择一个选项:
- 如要下载空白的 CSV 模板,请点击下载空白模板。
- 如要下载包含管理控制台中列出的第三方应用的 CSV 文件,请点击下载已配置的应用的相关信息或下载访问过的应用的相关信息。下载完成后,点击下载 CSV 文件。您可能需要先点击“任务”图标 。
- 在电子表格应用(例如 Google 表格或 Microsoft Excel)中打开此 CSV 文件。
此文件包含每个已配置应用的各种属性所对应的列。
第 2 步:输入应用信息并保存文件
- 对于您要配置的每个应用,请在电子表格的相应列中输入信息:
- (可选)“App name”(应用名称)- 输入应用的名称。您在 CSV 文件中对应用名称所做的更改不会应用到管理控制台。
- Type(类型)- 输入 Android、iOS 或 web application。
- Id - 如果是 Web 应用,请输入分配给应用的 OAuth 客户端 ID。如果是 Android 或 iOS 应用,请输入应用在 Google Play 或 Apple App Store 中使用的 OAuth 客户端 ID 或程序包 ID/软件包 ID。
- Access(访问权限)- 输入受信任、已屏蔽、受限或已取消配置(在“Org Unit”[组织部门]中指定的组织部门内取消配置应用)。
- Org Unit(组织部门)- 输入正斜线(“/”)以将应用访问权限设置应用于整个网域。如要向特定组织部门应用访问权限设置,请在电子表格中为每个组织部门添加一行,并重复使用应用名称、类型和 ID。输入所需的访问权限设置,然后在 Org Unit(组织部门)中输入完整的路径和名称(例如“/org_unit_1/sub_unit_1”)。
- 填好电子表格后,将其保存为 CSV (.csv) 文件。
第 3 步:上传文件
- 在管理控制台中,点击附加 CSV 文件。您可能需要先点击批量更新列表。
- 找到并附加相应 CSV 文件。
- 点击上传。
您可以查看上传进度。完成后,您会收到电子邮件报告。
如果出现错误,请输入漏掉的信息,然后重新上传文件。如果处理时出错,请从“任务”列表中下载日志文件。有关详情,请参阅下文中的解决错误。
解决错误
上传 CSV 文件时出现的错误
错误 | 原因和解决方案 |
---|---|
文件中没有内容 | 文件不包含任何信息。 |
文件格式有误或者列无效:列名称。 | 文件中的列应为“App Name”(应用名称)、“Type”(类型)、“Id”“Verification Status”(验证状态)、“Users”(用户)、“Requested Services”(请求的服务)、“Access”(访问权限)、“Requested Services with Scopes”(所请求服务的范围)和“Org Unit”(组织部门)。 |
缺少列名称列。 | 缺少必需的列。必需的列包括“Type”(类型)、“Id”“Access”(访问权限)和“Org Unit”(组织部门)。 |
第 nn 行:“<列名称>”为空 | 特定行中的必填列没有内容。举例来说,如果您未输入应用的访问权限级别,则会看到以下错误消息:第 2 行:“Access”为空。请添加相关信息,然后重试。 |
文件大小不得超过 10 MB。 | CSV 文件大小超过 10 MB。在这种情况下,请打开文件并将表格拆分为多个文件。请以 CSV 格式保存每个文件,请确保所有 CSV 文件均包含列标题行。 |
第 nn 行:列数不正确 | 列数与某一行的标题列数量不符。请检查该行的详细信息,然后重试。 |
无法读取文件。请检查,然后重试。 | 读取文件时出错。请检查文件,然后重试。 |
无法读取标题。请检查,然后重试。 | 上传的 CSV 文件的标题无效。文件中的标题应为“App Name”(应用名称)、“Type”(类型)、“Id”“Verification Status”(验证状态)、“Users”(用户)、“Requested Services”(请求的服务)、“Access”(访问权限)、“Requested Services with Scopes”(所请求服务的范围)和“Org Unit”(组织部门)。请检查列标题,然后重试。 |
文件中的“<列名称>”列重复。 | 上传的 CSV 文件包含重复的列。请移除重复的列,然后重试。 |
文件类型无效。仅上传 CSV 文件。 | 上传的文件不是 CSV 格式。请将其保存为 CSV 文件,然后重试。 |
第 nn 行:无法解析 | 无法解析 CSV 文件中的某一行。请检查该行的详细信息,然后重试。 |
第 nn 行:应用类型无效 | 文件中某一行的应用类型无效。接受的应用类型包括“Android”“iOS”或“web application”。 |
第 nn 行:状态无效 | 文件中的某一行包含无效的访问权限信息。“Access”(访问权限)列应设为“trusted”“blocked”或“limited”。请更新此列,然后重试。 |
第 nn 行:条目重复 | 有重复的行。请移除重复的行,然后重试。 |
第 nn 行:未知错误 | 解析某一行时发生未知错误。请检查该行的详细信息,然后重试。 |
日志文件中的错误
错误 | 原因和解决方案 |
---|---|
ACTION FAILED: Validation | 有条目包含不受支持的字符。请检查文件,然后重试。 |
ACTION FAILED: UNKNOWN ERROR | 出现临时错误。请重新上传 CSV 文件,或者将内容分批上传。 |
INVALID_APP_IDENTIFIER |
您输入的一个或多个应用 ID 有误。
|
INVALID_ORG_UNIT_PATH | 您输入的组织部门无效。请更新组织部门,然后重试。 |
CONFIGURATION_LIMIT_REACHED | 您配置的应用数量已达到或超过 15,000 的上限。可配置的第三方应用总数不能超过 15,000 个(包括批量配置和单独配置的应用)。请移除多余的行,然后重试。 |
FIRST_PARTY_APP_ERROR | 某个应用 ID 不属于第三方应用,无法配置。请从文件中移除该应用,然后重试。 |
“Google”、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。