Method: customers.reports.findInstalledAppDevices

生成已安装指定应用的受管理 Chrome 浏览器设备的报告。

HTTP 请求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

必需。客户 ID 或“my_customer”，用于使用与发出请求的账号关联的客户。

查询参数

参数
orgUnitId

string

组织部门的 ID。
appId

string

应用的唯一标识符。对于 Chrome 应用和扩展程序，该值为 32 个字符的 ID（例如 ehoadneljpdggcbbknedodolkkjodefl）。对于 Android 应用，是软件包名称（例如 com.evernote）。
appType

enum (AppType)

应用类型。
pageSize

integer

返回的结果数上限。最大值和默认值均为 100。
pageToken

string

用于指定要返回的请求的页面的令牌。
orderBy

string

用于对结果进行排序的字段。

支持的排序字段：

  • 机器
  • deviceId
filter

string

用于过滤结果的查询字符串，以及采用 EBNF 语法且以 AND 分隔的字段。

注意：此过滤条件不支持 OR 运算。

支持的过滤条件字段：

  • last_active_date

请求正文

请求正文必须为空。

响应正文

包含已安装查询应用的设备列表的响应。

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

JSON 表示法 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
字段
devices[]

object (Device)

已安装此应用的设备的列表。已在 Device.machine 字段中按字母顺序升序排序。
nextPageToken

string

用于指定请求的下一页的令牌。
totalSize

integer

与请求匹配的设备总数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

设备

描述报告 Chrome 浏览器信息的设备。

JSON 表示法 
{
  "deviceId": string,
  "machine": string
}
字段
deviceId

string

仅限输出。报告此 Chrome 浏览器信息的设备的 ID。
machine

string

仅限输出。计算机在其本地网络中的名称。