Method: admin.directory.v1.customers.chrome.printers.list

列出打印机配置。

HTTP 请求

GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。拥有此打印机集合的客户的名称。格式:customers/{customer_id}

查询参数

参数
pageSize

integer

要返回的最大对象数。服务返回的数量可能小于此值。

pageToken

string

从上一个调用收到的页面令牌。

orgUnitId

string

我们要为其列出打印机的组织部门。如果请求中不存在 org_unit,则会返回(或过滤)客户的所有打印机。

如果请求中包含 org_unit,则系统将仅返回此组织部门可用的打印机(自有或继承)。您可以通过查看 Printer.org_unit_id,了解打印机是归此 OU 所有还是继承自此 OU。

filter

string

搜索查询。此 API 和管理控制台打印机页面之间共用搜索语法。

orderBy

string

结果的排序顺序。必须是 displayName、description、makeAndModel 或 createTime 中的一种。默认顺序是升序,但可以通过向 orderBy 字段附加“desc”来返回降序。例如,“description desc”会返回按说明降序排序的打印机。

请求正文

请求正文必须为空。

响应正文

用于列出打印机的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "printers": [
    {
      object (Printer)
    }
  ],
  "nextPageToken": string
}
字段
printers[]

object (Printer)

打印机列表。如果请求中提供了 orgUnitId,则系统只会返回此 OU 可见的打印机。如果请求中未指定 orgUnitId,则系统会返回所有打印机。

nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段,则不存在后续页面。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/admin.chrome.printers
  • https://www.googleapis.com/auth/admin.chrome.printers.readonly

如需了解详情,请参阅授权指南