Send feedback Class Identity (2.37.0) Stay organized with collections Save and categorize content based on your preferences. Version 2.37.0keyboard_arrow_down
public final class Identity implements Serializable An identity in aPolicy . The following types of identities are permitted in IAM policies:
Google account Service account Google group Google Apps domain
There are also two special identities that represent all users and all Google-authenticated accounts.See Also:Concepts related to identity
Static Methods allAuthenticatedUsers()
public static Identity allAuthenticatedUsers () Returns a new identity representing anyone who is authenticated with a Google account or a service account.
allUsers()
public static Identity allUsers () Returns a new identity representing anyone who is on the internet; with or without a Google account.
domain(String domain)
public static Identity domain ( String domain ) Returns a new domain identity.
Parameter Name Description domainString A Google Apps domain name that represents all the users of that domain. For example,google.com orexample.com .
group(String email)
public static Identity group ( String email ) Returns a new group identity.
Parameter Name Description emailString An email address that represents a Google group. For example,admins@example.com .
projectEditor(String projectId)
public static Identity projectEditor ( String projectId ) Returns a new project editor identity.
Parameter Name Description projectIdString A Google Cloud Platform project ID. For example,my-sample-project .
projectOwner(String projectId)
public static Identity projectOwner ( String projectId ) Returns a new project owner identity.
Parameter Name Description projectIdString A Google Cloud Platform project ID. For example,my-sample-project .
projectViewer(String projectId)
public static Identity projectViewer ( String projectId ) Returns a new project viewer identity.
Parameter Name Description projectIdString A Google Cloud Platform project ID. For example,my-sample-project .
serviceAccount(String email)
public static Identity serviceAccount ( String email ) Returns a new service account identity.
Parameter Name Description emailString An email address that represents a service account. For example,my-other-app@appspot.gserviceaccount.com .
user(String email)
public static Identity user ( String email ) Returns a new user identity.
Parameter Name Description emailString An email address that represents a specific Google account. For example,alice@gmail.com orjoe@example.com .
valueOf(String identityStr)
public static Identity valueOf ( String identityStr ) Converts a string to anIdentity. Used primarily for converting protobuf-generated policy identities toIdentity objects.
Parameter Name Description identityStrString
Methods equals(Object obj)
public boolean equals ( Object obj ) Parameter Name Description objObject
Overrides getType()
public Identity . Type getType () getValue() Returns the string identifier for this identity. The value corresponds to:
email address (for identities of typeUSER,SERVICE_ACCOUNT, and GROUP) domain (for identities of typeDOMAIN) null (for identities of typeALL_USERS and ALL_AUTHENTICATED_USERS)hashCode() Returns Type Description int
Overrides strValue() Returns the string value associated with the identity. Used primarily for converting fromIdentity objects to strings for protobuf-generated policies.
toString() Overrides Send feedback
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License , and code samples are licensed under theApache 2.0 License . For details, see theGoogle Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-31 UTC.
Need to tell us more? [[["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 2026-01-31 UTC."],[],[]]