Optional. The version of the access policy schema to fetch. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected.
Requests for conditional access policy binding in datasets must specify version 3. Dataset with no conditional role bindings in access policy may specify any valid value or leave the field unset.
This field will be mapped to IAM Policy version and will be used to fetch policy from IAM.
If unset or if 0 or 1 value is used for dataset with conditional bindings, access entry with condition will have role string appended by 'withcond' string followed by a hash value. For example : { "access": [ { "role": "roles/bigquery.dataViewer_with_conditionalbinding_7a34awqsda", "userByEmail": "user@example.com", } ] } Please refer https://cloud.google.com/iam/docs/troubleshooting-withcond for more details.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Dataset.
[[["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-07-02 UTC."],[[["\u003cp\u003eThis page details how to retrieve a specific dataset using a \u003ccode\u003eGET\u003c/code\u003e request to the BigQuery API.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eprojectId\u003c/code\u003e and \u003ccode\u003edatasetId\u003c/code\u003e as mandatory path parameters within the URL.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eaccessPolicyVersion\u003c/code\u003e query parameter can be included to specify the version of the access policy schema to fetch.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty for this operation.\u003c/p\u003e\n"],["\u003cp\u003eA successful request will return a response body containing a \u003ccode\u003eDataset\u003c/code\u003e resource, and it requires specific authorization scopes.\u003c/p\u003e\n"]]],[],null,["# Method: datasets.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the dataset specified by datasetID.\n\n### HTTP request\n\n`GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets/{datasetId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Dataset](/bigquery/docs/reference/rest/v2/datasets#Dataset).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/bigquery`\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/bigquery.readonly`\n- `https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
