An entry must have exactly one of the allowed
xref_EntityTypes. If anything but view, routine,
or dataset are set, a role is also required. role is omitted for view,
routine, dataset, because they are always read-only.
Role granted to the entity. The following string values are supported: 'READER', 'WRITER', 'OWNER'. It may also be :data:None if the entity_type is view, routine, or dataset.
entity_type
typing.Optional[str]
Type of entity being granted the role. See EntityTypes for supported types.
If the entity_type is not 'view', 'routine', or 'dataset', the entity_id is the str ID of the entity being granted the role. If the entity_type is 'view' or 'routine', the entity_id is a dict representing the view or routine from a different dataset to grant access to in the following format for views:: { 'projectId': string, 'datasetId': string, 'tableId': string } For routines:: { 'projectId': string, 'datasetId': string, 'routineId': string } If the entity_type is 'dataset', the entity_id is a dict that includes a 'dataset' field with a dict representing the dataset and a 'target_types' field with a str value of the dataset's resource type:: { 'dataset': { 'projectId': string, 'datasetId': string, }, 'target_types: 'VIEWS' }
Properties
condition
Optional[Condition]: The IAM condition associated with this entry.
dataset
API resource representation of a dataset reference.
dataset_target_types
Which resources that the dataset in this entry applies to.
domain
A domain to grant access to.
entity_id
The entity_id of the entry.
entity_type
The entity_type of the entry.
group_by_email
An email address of a Google Group to grant access to.
role
The role of the entry.
routine
API resource representation of a routine reference.
[[["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-28 UTC."],[],[],null,["# Class AccessEntry (3.36.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.36.0 (latest)](/python/docs/reference/bigquery/latest/google.cloud.bigquery.dataset.AccessEntry)\n- [3.35.1](/python/docs/reference/bigquery/3.35.1/google.cloud.bigquery.dataset.AccessEntry)\n- [3.34.0](/python/docs/reference/bigquery/3.34.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.33.0](/python/docs/reference/bigquery/3.33.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.31.0](/python/docs/reference/bigquery/3.31.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.30.0](/python/docs/reference/bigquery/3.30.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.29.0](/python/docs/reference/bigquery/3.29.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.27.0](/python/docs/reference/bigquery/3.27.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.26.0](/python/docs/reference/bigquery/3.26.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.25.0](/python/docs/reference/bigquery/3.25.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.24.0](/python/docs/reference/bigquery/3.24.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.23.1](/python/docs/reference/bigquery/3.23.1/google.cloud.bigquery.dataset.AccessEntry)\n- [3.22.0](/python/docs/reference/bigquery/3.22.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.21.0](/python/docs/reference/bigquery/3.21.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.20.1](/python/docs/reference/bigquery/3.20.1/google.cloud.bigquery.dataset.AccessEntry)\n- [3.19.0](/python/docs/reference/bigquery/3.19.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.18.0](/python/docs/reference/bigquery/3.18.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.17.2](/python/docs/reference/bigquery/3.17.2/google.cloud.bigquery.dataset.AccessEntry)\n- [3.16.0](/python/docs/reference/bigquery/3.16.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.15.0](/python/docs/reference/bigquery/3.15.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.14.1](/python/docs/reference/bigquery/3.14.1/google.cloud.bigquery.dataset.AccessEntry)\n- [3.13.0](/python/docs/reference/bigquery/3.13.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.12.0](/python/docs/reference/bigquery/3.12.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.11.4](/python/docs/reference/bigquery/3.11.4/google.cloud.bigquery.dataset.AccessEntry)\n- [3.4.0](/python/docs/reference/bigquery/3.4.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.3.6](/python/docs/reference/bigquery/3.3.6/google.cloud.bigquery.dataset.AccessEntry)\n- [3.2.0](/python/docs/reference/bigquery/3.2.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.1.0](/python/docs/reference/bigquery/3.1.0/google.cloud.bigquery.dataset.AccessEntry)\n- [3.0.1](/python/docs/reference/bigquery/3.0.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.34.4](/python/docs/reference/bigquery/2.34.4/google.cloud.bigquery.dataset.AccessEntry)\n- [2.33.0](/python/docs/reference/bigquery/2.33.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.32.0](/python/docs/reference/bigquery/2.32.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.31.0](/python/docs/reference/bigquery/2.31.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.30.1](/python/docs/reference/bigquery/2.30.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.29.0](/python/docs/reference/bigquery/2.29.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.28.1](/python/docs/reference/bigquery/2.28.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.27.1](/python/docs/reference/bigquery/2.27.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.26.0](/python/docs/reference/bigquery/2.26.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.25.2](/python/docs/reference/bigquery/2.25.2/google.cloud.bigquery.dataset.AccessEntry)\n- [2.24.1](/python/docs/reference/bigquery/2.24.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.23.3](/python/docs/reference/bigquery/2.23.3/google.cloud.bigquery.dataset.AccessEntry)\n- [2.22.1](/python/docs/reference/bigquery/2.22.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.21.0](/python/docs/reference/bigquery/2.21.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.20.0](/python/docs/reference/bigquery/2.20.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.19.0](/python/docs/reference/bigquery/2.19.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.18.0](/python/docs/reference/bigquery/2.18.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.17.0](/python/docs/reference/bigquery/2.17.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.16.1](/python/docs/reference/bigquery/2.16.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.15.0](/python/docs/reference/bigquery/2.15.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.14.0](/python/docs/reference/bigquery/2.14.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.13.1](/python/docs/reference/bigquery/2.13.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.12.0](/python/docs/reference/bigquery/2.12.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.11.0](/python/docs/reference/bigquery/2.11.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.10.0](/python/docs/reference/bigquery/2.10.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.9.0](/python/docs/reference/bigquery/2.9.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.8.0](/python/docs/reference/bigquery/2.8.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.7.0](/python/docs/reference/bigquery/2.7.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.6.2](/python/docs/reference/bigquery/2.6.2/google.cloud.bigquery.dataset.AccessEntry)\n- [2.5.0](/python/docs/reference/bigquery/2.5.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.4.0](/python/docs/reference/bigquery/2.4.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.3.1](/python/docs/reference/bigquery/2.3.1/google.cloud.bigquery.dataset.AccessEntry)\n- [2.2.0](/python/docs/reference/bigquery/2.2.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.1.0](/python/docs/reference/bigquery/2.1.0/google.cloud.bigquery.dataset.AccessEntry)\n- [2.0.0](/python/docs/reference/bigquery/2.0.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.28.2](/python/docs/reference/bigquery/1.28.2/google.cloud.bigquery.dataset.AccessEntry)\n- [1.27.2](/python/docs/reference/bigquery/1.27.2/google.cloud.bigquery.dataset.AccessEntry)\n- [1.26.1](/python/docs/reference/bigquery/1.26.1/google.cloud.bigquery.dataset.AccessEntry)\n- [1.25.0](/python/docs/reference/bigquery/1.25.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.24.0](/python/docs/reference/bigquery/1.24.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.23.1](/python/docs/reference/bigquery/1.23.1/google.cloud.bigquery.dataset.AccessEntry)\n- [1.22.0](/python/docs/reference/bigquery/1.22.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.21.0](/python/docs/reference/bigquery/1.21.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.20.0](/python/docs/reference/bigquery/1.20.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.19.0](/python/docs/reference/bigquery/1.19.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.18.0](/python/docs/reference/bigquery/1.18.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.17.0](/python/docs/reference/bigquery/1.17.0/google.cloud.bigquery.dataset.AccessEntry)\n- [1.16.0](/python/docs/reference/bigquery/1.16.0/google.cloud.bigquery.dataset.AccessEntry) \n\n AccessEntry(\n role: typing.Optional[str] = None,\n entity_type: typing.Optional[str] = None,\n entity_id: typing.Optional[typing.Union[typing.Dict[str, typing.Any], str]] = None,\n **kwargs\n )\n\nRepresents grant of an access role to an entity.\n\nAn entry must have exactly one of the allowed\nxref_EntityTypes. If anything but `view`, `routine`,\nor `dataset` are set, a `role` is also required. `role` is omitted for `view`,\n`routine`, `dataset`, because they are always read-only.\n\nSee \u003chttps://cloud.google.com/bigquery/docs/reference/rest/v2/datasets\u003e.\n\nProperties\n----------\n\n### condition\n\nOptional\\[Condition\\]: The IAM condition associated with this entry.\n\n### dataset\n\nAPI resource representation of a dataset reference.\n\n### dataset_target_types\n\nWhich resources that the dataset in this entry applies to.\n\n### domain\n\nA domain to grant access to.\n\n### entity_id\n\nThe entity_id of the entry.\n\n### entity_type\n\nThe entity_type of the entry.\n\n### group_by_email\n\nAn email address of a Google Group to grant access to.\n\n### role\n\nThe role of the entry.\n\n### routine\n\nAPI resource representation of a routine reference.\n\n### special_group\n\nA special group to grant access to.\n\n### user_by_email\n\nAn email address of a user to grant access to.\n\n### view\n\nAPI resource representation of a view reference.\n\nMethods\n-------\n\n### from_api_repr\n\n from_api_repr(resource: dict) -\u003e google.cloud.bigquery.dataset.AccessEntry\n\nFactory: construct an access entry given its API representation\n\n### to_api_repr\n\n to_api_repr()\n\nConstruct the API resource representation of this access entry"]]