---
canonical_url: "https://docs.composio.dev/toolkits/google_data_studio"
markdown_url: "https://docs.composio.dev/toolkits/google_data_studio.md"
product: "platform"
version: null
last_updated: null
---

# Google Data Studio

Google Data Studio is Google's business intelligence platform for creating dashboards and reports; its Asset API searches organizational assets and manages their sharing permissions.

- **Category:** business intelligence
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `GOOGLE_DATA_STUDIO`
- **Version:** 20260909_00

## Tools

### Add Members to Asset Role

**Slug:** `GOOGLE_DATA_STUDIO_ADD_MEMBERS_TO_ASSET_ROLE`

Ensure one or more members belong to a mutable asset role and verify each requested membership after the write.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("VIEWER" | "EDITOR" | "LINK_VIEWER" | "LINK_EDITOR") | Yes | Mutable role that should contain every requested member; OWNER cannot be changed. |
| `members` | array | Yes | Members to ensure in the role. VIEWER and EDITOR accept user:, group:, or serviceAccount: values; link roles accept allUsers or domain: values. |
| `asset_id` | string | Yes | Bare asset ID returned by Search Assets. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Asset Permissions

**Slug:** `GOOGLE_DATA_STUDIO_GET_ASSET_PERMISSIONS`

Get every populated permission role and the current concurrency etag for one Google Data Studio asset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asset_id` | string | Yes | Bare asset ID returned as asset_id by Search Assets; do not add a reports/ or dataSources/ prefix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Asset Permissions

**Slug:** `GOOGLE_DATA_STUDIO_REPLACE_ASSET_PERMISSIONS`

Replace all four mutable permission-role memberships for a Google Data Studio asset, preserving owners and rejecting stale etags. Every mutable role is required; pass an empty list to clear that role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Current etag returned by Get Asset Permissions; the call fails if permissions changed since it was read. |
| `asset_id` | string | Yes | Bare asset ID returned by Search Assets. |
| `editor_members` | array | Yes | Complete intended EDITOR membership. Each value must start with user:, group:, or serviceAccount:. Pass [] to clear this role. |
| `viewer_members` | array | Yes | Complete intended VIEWER membership. Each value must start with user:, group:, or serviceAccount:. Pass [] to clear this role. |
| `link_editor_members` | array | Yes | Complete intended LINK_EDITOR membership. Values must be allUsers or start with domain:. Pass [] to disable this link role. |
| `link_viewer_members` | array | Yes | Complete intended LINK_VIEWER membership. Values must be allUsers or start with domain:. Pass [] to disable this link role. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Revoke Asset Member Permissions

**Slug:** `GOOGLE_DATA_STUDIO_REVOKE_ASSET_MEMBER_PERMISSIONS`

Remove one or more members from every removable role on a Google Data Studio asset and verify whether each was removed or already absent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `members` | array | Yes | Members to remove from all removable roles. Each value must be allUsers or start with user:, group:, domain:, or serviceAccount:. Owners and the authorized user cannot be revoked. |
| `asset_id` | string | Yes | Bare asset ID returned by Search Assets. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Assets

**Slug:** `GOOGLE_DATA_STUDIO_SEARCH_ASSETS`

Search accessible Google Data Studio reports or data sources and return one page of asset metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Text matched against title and description, or an advanced expression using creator:, owner:, projectNumber:, parentWorkspace:, from:, or to:. |
| `cursor` | string | No | Opaque next cursor returned by an earlier search; omit for the first page and pass it back unchanged. |
| `order_by` | string ("title" | "last_viewed_by_me" | "create_time" | "last_accessed_time" | "id") | No | Field used to order results. |
| `page_size` | integer | No | Maximum assets to request in this page. Google documents a default of 1000 and no maximum. |
| `asset_type` | string ("REPORT" | "DATA_SOURCE") | Yes | The single asset type to search: REPORT or DATA_SOURCE. |
| `owner_email` | string | No | Return only assets owned by this email address. |
| `include_trashed` | boolean | No | When true, return only trashed assets; otherwise return only non-trashed assets. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |