type Role (v202508)

  • A Role defines a user's permissions within the system.

  • Roles have a unique ID assigned by Google, which is read-only.

  • Roles also have a read-only name and description assigned by Google.

  • The status of a role can be ACTIVE or INACTIVE, determining its visibility in the UI.
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/v202508

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.