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

列出打印机配置。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

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

查询参数

参数
pageSize

integer

要返回的对象数量上限。服务返回的值可能会少于此值。

pageToken

string

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

orgUnitId

string

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

如果请求中包含 org_unit,则系统只会返回此组织部门可用的打印机(拥有的打印机或继承的打印机)。您可以查看 Printer.org_unit_id,了解此组织部门是否拥有或继承了打印机。

filter

string

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

orderBy

string

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

请求正文

请求正文必须为空。

响应正文

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

对列出打印机的响应。

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

object (Printer)

打印机列表。如果在请求中指定了 orgUnitId,系统将仅返回此组织部门可见的打印机。如果请求中未指定 orgUnitId,则会返回所有打印机。

nextPageToken

string

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

授权范围

需要以下 OAuth 范围之一:

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

有关详情,请参阅授权指南