资源:搜索

搜索用户的 Looker Studio 资源。

请求

HTTP 请求

GET https://datastudio.googleapis.com/v1/assets:search

参数

参数名称 类型 说明
assetTypes 数组<AssetType> 必需。要搜索的资源类型。必须指定一种素材资源类型。
title 字符串 搜索字符串。默认情况下,系统会根据素材资源的标题和说明检查该字符串。如需查看高级搜索字符串,请参阅示例部分。
includeTrashed 布尔值 默认值为 false
  • 如果将此参数设置为 true,则仅包含回收站中的资源。
  • 如果此参数设置为 false,则仅包含不在回收站中的资源。
所有者 字符串 资源所有者的电子邮件地址。
orderBy 字符串 结果的顺序。您可以按以下字段进行排序:
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
pageSize 数值 每页包含的结果数。默认值为 1000。
pageToken 字符串 标识要返回的结果页面的令牌。如需对结果进行分页,请使用来自其他请求的 nextPageToken 值或 previousPageToken 值。

授权

此请求需要获得以下至少一个范围的授权:

范围
https://www.googleapis.com/auth/datastudio.readonly
https://www.googleapis.com/auth/datastudio

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回采用以下结构的响应正文:

{
  "assets": [Asset],
  "nextPageToken": string
}
属性名称 类型 说明
素材资源 数组<资源> 资源列表。
nextPageToken 字符串 用于检索下一页结果的令牌。仅当结果数大于请求的 pageSize 时,此属性才会显示。如果 nextPageToken 为空,则表示没有更多结果可返回。
previousPageToken 字符串 用于检索上一页结果的令牌。空 previousPageToken 表示结果集的开头。

示例

您可以在 title 字段中传递高级搜索字符串。 您可以在单个搜索字符串中使用多种搜索类型。 如需了解支持的搜索字符串语法,请参阅下表。您可以组合使用多个搜索字符串。

过滤 定义 示例
创建者 搜索特定用户创建的素材资源。
  • creator:me
  • creator:user@example.com
所有者 搜索特定用户拥有的资源。
  • owner:me
  • owner:user@example.com
项目 搜索项目中的资源。
  • projectNumber:123456789
工作区 在工作区或文件夹中搜索素材资源。
  • parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
发件人 搜索用户与您分享的素材资源。
  • from:user@example.com
收件人 搜索您与用户或群组共享的素材资源。
  • to:user@example.com
  • to:example-group@googlegroups.com