通知

Duet AI 现已更名为 Google Workspace 专用 Gemini。了解详情

批量添加和配置第三方应用

作为管理员,您可以使用逗号分隔值 (CSV) 文件添加和配置多个第三方应用。您可以在 Google 管理控制台中下载空白的 CSV 模板,也可以下载包含管理控制台中所有现有第三方应用的 CSV 文件并进行修改或添加。

开始前须知

  • CSV 文件的大小上限为 10 MB。
  • 上传文件时,“Type”(类型)、“Id”“Access”(访问权限)和“Org Unit”(组织部门)列中的信息将替换管理控制台中的现有信息。
  • 对于您不想更改的信息,您可以删除相应列、原样保留相应信息或删除这些信息。
  • 如果您删除某列中的所有信息,但在 CSV 文件中保留此列,那么当您上传文件时,系统不会移除管理控制台中的现有信息。
  • 如果您不想修改特定应用,可以在电子表格中保留相应行或移除该行。如果您从文件中移除某个应用,该应用不会被删除。

全部展开  |  全部收起

通过 CSV 文件添加和配置应用

第 1 步:下载 CSV 文件
  1. 登录您的 Google 管理控制台

    请使用拥有超级用户权限的帐号(不是以 @gmail.com 结尾)登录。

  2. 在管理控制台中,依次点击“菜单”图标 接着点击 安全性接着点击访问权限和数据控件接着点击API 控件接着点击管理第三方应用的访问权限
    您必须以超级用户身份登录,才能执行此任务。

  3. (可选)如要仅配置访问过 Google 数据的应用,请在访问过的应用部分,点击查看列表
  4. 点击批量更新列表,然后选择一个选项:
    • 如要下载空白的 CSV 模板,请点击下载空白模板
    • 如要下载包含管理控制台中列出的第三方应用的 CSV 文件,请点击下载已配置的应用的相关信息下载访问过的应用的相关信息。下载完成后,点击下载 CSV 文件。您可能需要先点击“任务”图标 
  5. 在电子表格应用(例如 Google 表格或 Microsoft Excel)中打开此 CSV 文件。
    此文件包含每个已配置应用的各种属性所对应的列。
第 2 步:输入应用信息并保存文件
  1. 对于您要配置的每个应用,请在电子表格的相应列中输入信息:
    • (可选)“App name”(应用名称)- 输入应用的名称。您在 CSV 文件中对应用名称所做的更改不会应用到管理控制台。
    • Type(类型)- 输入 AndroidiOSweb 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”)。
  2. 填好电子表格后,将其保存为 CSV (.csv) 文件。
第 3 步:上传文件
  1. 在管理控制台中,点击附加 CSV 文件。您可能需要先点击批量更新列表
  2. 找到并附加相应 CSV 文件。
  3. 点击上传

您可以查看上传进度。完成后,您会收到电子邮件报告。

如果出现错误,请输入漏掉的信息,然后重新上传文件。如果处理时出错,请从“任务”列表中下载日志文件。有关详情,请参阅下文中的解决错误

解决错误

上传 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 有误。

  • 如果是 Web 应用,请输入分配给应用的 OAuth 客户端 ID。
  • 如果是 Android 或 iOS 应用,请输入应用在 Google Play 或 App Store 中使用的 OAuth 客户端 ID 或程序包 ID/软件包 ID。
INVALID_ORG_UNIT_PATH 您输入的组织部门无效。请更新组织部门,然后重试。
CONFIGURATION_LIMIT_REACHED 您配置的应用数量已达到或超过 15,000 的上限。可配置的第三方应用总数不能超过 15,000 个(包括批量配置和单独配置的应用)。请移除多余的行,然后重试。
FIRST_PARTY_APP_ERROR 某个应用 ID 不属于第三方应用,无法配置。请从文件中移除该应用,然后重试。


“Google”、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
10911523350922167795
true
搜索支持中心
true
true
true
true
true
73010
false
false