Google Data Studio Search
CertifiedSearch Data Studio assets
Google Data Studio Search
Search Data Studio assets
Search reports and data sources the authenticated Workspace user can access. The API accepts one asset type per call; this task queries each type you list and merges the pages. The task fails when a query exceeds maxPages instead of returning a partial list. STORE writes each page to the Ion file as it arrives.
type: io.kestra.plugin.datastudio.assets.SearchExamples
List all reports owned by a user
id: assets_search
namespace: company.team
inputs:
- id: owner_email
type: STRING
defaults: owner@acme.com
tasks:
- id: search
type: io.kestra.plugin.datastudio.assets.Search
serviceAccount: "{{ secret('GCP_SERVICE_ACCOUNT_JSON') }}"
assetTypes:
- REPORT
owner: "{{ inputs.owner_email }}"
Properties
assetTypes *array
REPORTDATA_SOURCEUNKNOWNAsset types
Asset types to search. Each value is queried separately because the API accepts exactly one type per request. Allowed values are REPORT and DATA_SOURCE. UNKNOWN is output-only and is rejected here.
accessToken string
Access token
OAuth access token. When set, the service account exchange is skipped, so the token must already include datastudio.readonly for read tasks or datastudio for Add and Revoke.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://datastudio.googleapis.com/v1API base URL
Data Studio API root. Defaults to https://datastudio.googleapis.com/v1.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch type
STORE writes an Ion file and is the right choice for an organisation-wide inventory. FETCH returns every asset in the execution context and is meant for a small result set. FETCH_ONE returns the first asset from the first page that has one. NONE returns only the count.
includeTrashed booleanstring
falseInclude trashed assets
When true, only trashed assets are returned. When false, only assets that are not in the trash are returned.
maxPages integerstring
50Maximum pages
Fail when one asset type needs more pages than this. Default 50. A partial result is never returned.
orderBy string
TITLELAST_VIEWED_BY_MECREATE_TIMELAST_ACCESSED_TIMEIDOrder by
Sort field sent to the API. TITLE, LAST_VIEWED_BY_ME, CREATE_TIME, LAST_ACCESSED_TIME, or ID.
owner string
Owner
Email of the asset owner.
pageSize integerstring
Page size
Number of assets to request per page. Must be at least 1. The API default is 1000.
serviceAccount string
Service account JSON
Google service account key JSON. Read tasks request https://www.googleapis.com/auth/datastudio.readonly. Add and Revoke request https://www.googleapis.com/auth/datastudio. Grant the scope through domain-wide delegation in a Google Workspace or Cloud Identity organization. Use this or accessToken.
subject string
Delegated user
Workspace user email the service account impersonates. Required for domain-wide delegation. Ignored when accessToken is set.
title string
Search string
Matched against the asset title and description. Also accepts the API advanced filters, such as creator: me or parentWorkspace: <id>.
tokenUri string
https://oauth2.googleapis.com/tokenToken URI
OAuth token endpoint used to exchange a service account JWT.
Outputs
asset
First asset
Set only when fetchType is FETCH_ONE.
io.kestra.plugin.datastudio.models.Asset
REPORTDATA_SOURCEUNKNOWNAsset type
REPORT or DATA_SOURCE. An unexpected API value is UNKNOWN, so one asset does not fail the whole response.
date-timeCreation time
Creator email
Description
Asset name
The Data Studio asset ID.
Owner email
Title
Trashed
True when the asset is in the trash.
date-timeUpdate time
assets array
Assets
Set only when fetchType is FETCH.
io.kestra.plugin.datastudio.models.Asset
REPORTDATA_SOURCEUNKNOWNAsset type
REPORT or DATA_SOURCE. An unexpected API value is UNKNOWN, so one asset does not fail the whole response.
date-timeCreation time
Creator email
Description
Asset name
The Data Studio asset ID.
Owner email
Title
Trashed
True when the asset is in the trash.
date-timeUpdate time
size integer
Number of assets
uri string
uriInternal storage URI
Ion file of the assets. Set only when fetchType is STORE.
