搜索用户的 Looker Studio 资源。
请求
HTTP 请求
GET https://datastudio.googleapis.com/v1/assets:search
参数
参数名称 | 类型 | 说明 |
---|---|---|
assetTypes | 数组<AssetType> | 必需。要搜索的资源类型。必须指定一种素材资源类型。 |
title | 字符串 | 搜索字符串。默认情况下,系统会根据素材资源的标题和说明检查该字符串。如需查看高级搜索字符串,请参阅示例部分。 |
includeTrashed | 布尔值 | 默认值为 false 。
|
所有者 | 字符串 | 资源所有者的电子邮件地址。 |
orderBy | 字符串 | 结果的顺序。您可以按以下字段进行排序:
|
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
字段中传递高级搜索字符串。
您可以在单个搜索字符串中使用多种搜索类型。
如需了解支持的搜索字符串语法,请参阅下表。您可以组合使用多个搜索字符串。
过滤 | 定义 | 示例 |
---|---|---|
创建者 | 搜索特定用户创建的素材资源。 |
|
所有者 | 搜索特定用户拥有的资源。 |
|
项目 | 搜索项目中的资源。 |
|
工作区 | 在工作区或文件夹中搜索素材资源。 |
|
发件人 | 搜索用户与您分享的素材资源。 |
|
收件人 | 搜索您与用户或群组共享的素材资源。 |
|