示波器简介

范围是 Genesys 定义的名称，用于在 Genesys Cloud Public API 中对端点进行分类。当应用程序被授权具有特定范围时，它只能访问 API 中需要该作用域的终端节点。应用程序不能调用需要它没有的作用域的终端节点。

每个 API 调用都需要一个范围，该范围可以是只读或读写。带有:readonly 后缀的范围 是只读的。没有后缀的作用域允许读写操作。

例如，考虑两个允许访问 Genesys Cloud 用户的范围。要授予应用程序访问与用户相关的终端节点的权限，管理员应根据管理员是否希望应用程序能够修改用户数据，为应用程序分配以下范围之一。

范围名称 users users:readonly

描述

用户范围将允许应用读取和修改有关 Genesys Cloud 用户的数据。

该应用程序可以使用 GET、POST、PUT、PATCH 和 DELETE 方法调用与用户相关的 API 端点。

用户:只读 范围仅允许应用从 Genesys Cloud 读取用户数据。

只读作用域使用 GET 方法，但必须使用 POST 向 API 调用提交数据以获取分析数据或搜索的情况除外。

在这些情况下，应用程序不是在修改数据，只是从 POST 中获取数据。即使必须发送信息才能获取响应数据，整个场景仍然是只读的。

Genesys Cloud 支持许多其他范围，例如群组、语音邮件、架构师、电台、搜索等的范围。大多数作用域都可以使用或不带有:readonly 后缀。有关范围的完整列表，请参阅 Genesys Cloud 开发人员中心中的 Scope 。

注意： 如果应用程序具有终端节点所需的范围，则只有在有权访问或修改该数据的用户正在使用 API 终端节点时才能调用该终端节点。仅作用域并不授权访问权限。应用的当前用户必须具有允许 API 调用执行操作的权限。作用域和权限都是必需的。