When Role is used in CreateRole, the role name must not be set.
When Role is used in output and other input such as UpdateRole, the role
name is the complete path, e.g., roles/logging.viewer for predefined roles
and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
When Role is used in CreateRole, the role name must not be set.
When Role is used in output and other input such as UpdateRole, the role
name is the complete path, e.g., roles/logging.viewer for predefined roles
and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
The current launch stage of the role. If the ALPHA launch stage has been
selected for a role, the stage field will not be included in the
returned definition for the role.
The current launch stage of the role. If the ALPHA launch stage has been
selected for a role, the stage field will not be included in the
returned definition for the role.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-16 UTC."],[],[],null,["# Interface RoleOrBuilder (3.67.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.67.0 (latest)](/java/docs/reference/google-iam-admin/latest/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.65.0](/java/docs/reference/google-iam-admin/3.65.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.63.0](/java/docs/reference/google-iam-admin/3.63.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.62.0](/java/docs/reference/google-iam-admin/3.62.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.59.0](/java/docs/reference/google-iam-admin/3.59.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.58.0](/java/docs/reference/google-iam-admin/3.58.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.57.0](/java/docs/reference/google-iam-admin/3.57.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.55.0](/java/docs/reference/google-iam-admin/3.55.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.54.0](/java/docs/reference/google-iam-admin/3.54.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.53.0](/java/docs/reference/google-iam-admin/3.53.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.52.0](/java/docs/reference/google-iam-admin/3.52.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.51.0](/java/docs/reference/google-iam-admin/3.51.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.50.0](/java/docs/reference/google-iam-admin/3.50.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.49.0](/java/docs/reference/google-iam-admin/3.49.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.48.0](/java/docs/reference/google-iam-admin/3.48.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.47.0](/java/docs/reference/google-iam-admin/3.47.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.44.0](/java/docs/reference/google-iam-admin/3.44.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.43.0](/java/docs/reference/google-iam-admin/3.43.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.42.0](/java/docs/reference/google-iam-admin/3.42.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.41.0](/java/docs/reference/google-iam-admin/3.41.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.40.0](/java/docs/reference/google-iam-admin/3.40.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.39.0](/java/docs/reference/google-iam-admin/3.39.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.38.0](/java/docs/reference/google-iam-admin/3.38.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.37.0](/java/docs/reference/google-iam-admin/3.37.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.36.0](/java/docs/reference/google-iam-admin/3.36.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.35.0](/java/docs/reference/google-iam-admin/3.35.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.34.0](/java/docs/reference/google-iam-admin/3.34.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.32.0](/java/docs/reference/google-iam-admin/3.32.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.31.0](/java/docs/reference/google-iam-admin/3.31.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.30.0](/java/docs/reference/google-iam-admin/3.30.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.29.0](/java/docs/reference/google-iam-admin/3.29.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.28.0](/java/docs/reference/google-iam-admin/3.28.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.27.0](/java/docs/reference/google-iam-admin/3.27.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.26.0](/java/docs/reference/google-iam-admin/3.26.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.25.0](/java/docs/reference/google-iam-admin/3.25.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.24.0](/java/docs/reference/google-iam-admin/3.24.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.23.0](/java/docs/reference/google-iam-admin/3.23.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.22.0](/java/docs/reference/google-iam-admin/3.22.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.19.0](/java/docs/reference/google-iam-admin/3.19.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.18.0](/java/docs/reference/google-iam-admin/3.18.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.17.0](/java/docs/reference/google-iam-admin/3.17.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.16.0](/java/docs/reference/google-iam-admin/3.16.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.15.0](/java/docs/reference/google-iam-admin/3.15.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.14.0](/java/docs/reference/google-iam-admin/3.14.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.13.0](/java/docs/reference/google-iam-admin/3.13.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.12.0](/java/docs/reference/google-iam-admin/3.12.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.11.0](/java/docs/reference/google-iam-admin/3.11.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.10.0](/java/docs/reference/google-iam-admin/3.10.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.9.0](/java/docs/reference/google-iam-admin/3.9.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.8.0](/java/docs/reference/google-iam-admin/3.8.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.7.0](/java/docs/reference/google-iam-admin/3.7.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.6.0](/java/docs/reference/google-iam-admin/3.6.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.4.0](/java/docs/reference/google-iam-admin/3.4.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.3.0](/java/docs/reference/google-iam-admin/3.3.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.2.0](/java/docs/reference/google-iam-admin/3.2.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.1.0](/java/docs/reference/google-iam-admin/3.1.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [3.0.0](/java/docs/reference/google-iam-admin/3.0.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [2.0.0](/java/docs/reference/google-iam-admin/2.0.0/com.google.iam.admin.v1.RoleOrBuilder)\n- [1.2.5](/java/docs/reference/google-iam-admin/1.2.5/com.google.iam.admin.v1.RoleOrBuilder)\n- [1.1.8](/java/docs/reference/google-iam-admin/1.1.8/com.google.iam.admin.v1.RoleOrBuilder)\n- [0.2.0](/java/docs/reference/google-iam-admin/0.2.0/com.google.iam.admin.v1.RoleOrBuilder) \n\n public interface RoleOrBuilder extends MessageOrBuilder\n\nImplements\n----------\n\n[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)\n\nMethods\n-------\n\n### getDeleted()\n\n public abstract boolean getDeleted()\n\nThe current deleted state of the role. This field is read only.\nIt will be ignored in calls to CreateRole and UpdateRole.\n\n`bool deleted = 11;`\n\n### getDescription()\n\n public abstract String getDescription()\n\nOptional. A human-readable description for the role.\n\n`string description = 3;`\n\n### getDescriptionBytes()\n\n public abstract ByteString getDescriptionBytes()\n\nOptional. A human-readable description for the role.\n\n`string description = 3;`\n\n### getEtag()\n\n public abstract ByteString getEtag()\n\nUsed to perform a consistent read-modify-write.\n\n`bytes etag = 9;`\n\n### getIncludedPermissions(int index)\n\n public abstract String getIncludedPermissions(int index)\n\nThe names of the permissions this role grants when bound in an IAM policy.\n\n`repeated string included_permissions = 7;`\n\n### getIncludedPermissionsBytes(int index)\n\n public abstract ByteString getIncludedPermissionsBytes(int index)\n\nThe names of the permissions this role grants when bound in an IAM policy.\n\n`repeated string included_permissions = 7;`\n\n### getIncludedPermissionsCount()\n\n public abstract int getIncludedPermissionsCount()\n\nThe names of the permissions this role grants when bound in an IAM policy.\n\n`repeated string included_permissions = 7;`\n\n### getIncludedPermissionsList()\n\n public abstract List\u003cString\u003e getIncludedPermissionsList()\n\nThe names of the permissions this role grants when bound in an IAM policy.\n\n`repeated string included_permissions = 7;`\n\n### getName()\n\n public abstract String getName()\n\nThe name of the role.\n\nWhen Role is used in CreateRole, the role name must not be set.\n\nWhen Role is used in output and other input such as UpdateRole, the role\nname is the complete path, e.g., roles/logging.viewer for predefined roles\nand organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.\n\n`string name = 1;`\n\n### getNameBytes()\n\n public abstract ByteString getNameBytes()\n\nThe name of the role.\n\nWhen Role is used in CreateRole, the role name must not be set.\n\nWhen Role is used in output and other input such as UpdateRole, the role\nname is the complete path, e.g., roles/logging.viewer for predefined roles\nand organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.\n\n`string name = 1;`\n\n### getStage()\n\n public abstract Role.RoleLaunchStage getStage()\n\nThe current launch stage of the role. If the `ALPHA` launch stage has been\nselected for a role, the `stage` field will not be included in the\nreturned definition for the role.\n\n`.google.iam.admin.v1.Role.RoleLaunchStage stage = 8;`\n\n### getStageValue()\n\n public abstract int getStageValue()\n\nThe current launch stage of the role. If the `ALPHA` launch stage has been\nselected for a role, the `stage` field will not be included in the\nreturned definition for the role.\n\n`.google.iam.admin.v1.Role.RoleLaunchStage stage = 8;`\n\n### getTitle()\n\n public abstract String getTitle()\n\nOptional. A human-readable title for the role. Typically this\nis limited to 100 UTF-8 bytes.\n\n`string title = 2;`\n\n### getTitleBytes()\n\n public abstract ByteString getTitleBytes()\n\nOptional. A human-readable title for the role. Typically this\nis limited to 100 UTF-8 bytes.\n\n`string title = 2;`"]]