Assets: search

ユーザーの Looker Studio アセットを検索します。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	型	説明
assetTypes	Array<AssetType>	必須。検索するアセットタイプ。アセットタイプは 1 つだけ指定する必要があります。
title	文字列	検索文字列。デフォルトでは、文字列はアセットのタイトルと説明に対してチェックされます。高度な検索文字列については、例のセクションをご覧ください。
includeTrashed	ブール値	デフォルトは false です。 このパラメータを true に設定すると、ゴミ箱内のアセットのみが含まれます。 このパラメータを false に設定すると、ゴミ箱に入っていないアセットのみが含まれます。
オーナー	文字列	アセットの所有者のメールアドレス。
orderBy	文字列	結果の順序。次のフィールドで並べ替えることができます。 title last_viewed_by_me create_time last_accessed_time id
pageSize	数値	1 ページに含める結果の数。デフォルトは 1,000 です。
pageToken	文字列	返される結果のページを特定するトークン。結果をページ設定するには、別のリクエストの nextPageToken 値または previousPageToken 値を使用します。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

スコープ
https://www.googleapis.com/auth/datastudio.readonly
https://www.googleapis.com/auth/datastudio

リクエストの本文

このメソッドでは、リクエストの本文を指定しません。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "assets": [Asset],
  "nextPageToken": string
}

プロパティ名	型	説明
アセット	Array<Asset>	アセットのリスト。
nextPageToken	文字列	結果の次のページを取得するためのトークン。 このプロパティは、結果の数がリクエストの pageSize より大きい場合にのみ存在します。nextPageToken が空の場合、返される結果は他にありません。
previousPageToken	文字列	結果の前のページを取得するためのトークン。空の previousPageToken は、結果セットの先頭を示します。

例

詳細検索文字列は title フィールドで渡すことができます。1 つの検索文字列で複数の検索タイプを使用できます。サポートされている検索文字列の構文については、次の表をご覧ください。複数の検索文字列を組み合わせることができます。

フィルタ	定義	例
作成者	特定のユーザーが作成したアセットを検索します。	creator:me creator:[e-mail]
オーナー	特定のユーザーが所有するアセットを検索します。	owner:me owner:[e-mail]
プロジェクト	プロジェクト内のアセットを検索します。	projectNumber:123456789
ワークスペース	ワークスペースまたはフォルダ内のアセットを検索する。	parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
差出人	ユーザーが共有したアセットを検索します。	from:[e-mail]
宛先	ユーザーまたはグループと共有したアセットを検索します。	to:[e-mail] to:[e-mail]