Method: datasets.get

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Returns the dataset specified by datasetID.

HTTP request

GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets/{datasetId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId	string Required. Project ID of the requested dataset
datasetId	string Required. Dataset ID of the requested dataset

Query parameters

Parameters

accessPolicyVersion

integer 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": "[e-mail]", } ] } 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.

Authorization scopes

Requires one of the following OAuth scopes:

• https://www.googleapis.com/auth/bigquery
• https://www.googleapis.com/auth/cloud-platform
• https://www.googleapis.com/auth/bigquery.readonly
• https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the Authentication Overview.