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

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

注意：此过滤条件不支持 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

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