type Role (v202505)

  • A Role provides users with permissions to perform specific operations in the system.

  • The Role object has fields for id, name, description, and status, all of which are readonly.

  • The status field indicates whether the role is active or inactive and determines its visibility in the UI.

  • The id field is a unique value assigned by Google, with negative IDs indicating roles created by Google.
Service
UserService
Dependencies
getAllRoles()
▼
Role

Each Role provides a user with permissions to perform specific operations in the system.

Namespace
https://www.google.com/apis/ads/publisher/v202505

Field

id

xsd:long

The unique ID of the role. This value is readonly and is assigned by Google. Roles that are created by Google will have negative IDs.

name

xsd:string

The name of the role. This value is readonly and is assigned by Google.

description

xsd:string

The description of the role. This value is readonly and is assigned by Google.

status

RoleStatus

The status of the Role. This field is read-only and can have the values RoleStatus.ACTIVE (default) or RoleStatus.INACTIVE, which determines the visibility of the role in the UI.

Enumerations
ACTIVE
The status of an active role. (i.e. visible in the UI)
INACTIVE
The status of an inactive role. (i.e. hidden in the UI)
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.