Types

Assets

A Looker Studio asset.

{
  "assetType": AssetType,
  "updateTime": Timestamp,
  "name": string,
  "title": string,
  "trashed": boolean,
  "updateByMeTime": Timestamp,
  "owner": string,
  "createTime": Timestamp,
  "lastViewByMeTime": Timestamp
}

Property name	Type	Description
assetType	AssetType	The type of asset.
updateTime	Timestamp	Date the asset was last modified.
name	string	The name (ID) of the asset.
title	string	The title of the asset.
trashed	boolean	Indicates if the asset is in the trash.
updateByMeTime	Timestamp	Date the asset was last modified by me.
owner	string	The owner of the asset.
createTime	Timestamp	Date the asset was created.
lastViewByMeTime	Timestamp	Date the asset was last viewed by me

AssetType

The types of Looker Studio assets.

Enum value	Description
REPORT	A report asset.
DATA_SOURCE	A data source asset.

Role

A role in a permission.

Enum value	Description
VIEWER	Describes members that have been granted view permissions.
EDITOR	Describes members that have been granted edit permissions.
OWNER	Describes members that are owners.
LINK_VIEWER	Describes members that have view permissions.
LINK_EDITOR	Describes members that have edit permissions.

Member

A member of a permissions object.

Members of the VIEWER and EDITOR Role are represented using the following prefixes:

Member prefix	Description	Example
`user:`	A Google account.	`user:gus@gmail.com`
`group:`	A Google Group.	`group:api@googlegroups.com`
`domain:`	The domain of a Google Workspace or Cloud Identity organization.	`domain:example.com`
`serviceAccount:`	A Google Cloud Project service account.	`serviceAccount:gus@project.iam.gserviceaccount.com`

Members of the LINK_VIEWER or LINK_EDITOR Role are represented using one of the following:

Member name/prefix	Description
`allUsers`	Indicates that Anyone with the link can view/edit.
`domain:`	Indicates that Anyone in domain with the link can view/edit.

Permissions

Looker Studio permissions for an asset.

{
  "permissions": {
    [Role]: {
      "members": Member[]
    }
  },
  "etag": string
}

Property name	Type	Description
permissions	{Role: Member[]}	A map of role to members.
etag	string	etag to detect and fail concurrent modifications.

Examples

A Looker Studio asset shared with a three editors:

{
  "permissions": {
    "OWNER": {
      "members": [
        "user:gus@gmail.com"
      ]
    },
    "EDITOR": {
      "members": [
        "user:jen@gmail.com",
        "user:amy@gmail.com",
        "group:api@googlegroups.com"
      ]
    }
  },
  "etag": "BwXe3ECCjl0="
}

A Looker Studio asset shared with one editor and viewable by anyone with the link.

{
  "permissions": {
    "OWNER": {
      "members": [
        "user:gus@example.com"
      ]
    },
    "EDITOR": {
      "members": [
        "group:gus-team@example.com"
      ]
    },
    "LINK_VIEWER": {
      "members": [
        "allUsers"
      ]
    }
  },
  "etag": "OBr4bWCCtl0"
}