Method: datasets.get

Returns the dataset specified by datasetID.

HTTP request

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

The URL usesgRPC 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
datasetView

enum (DatasetView)

Optional. Specifies the view that determines which dataset information is returned. By default, metadata and ACL information are returned.

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 toIAM 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 referhttps://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 ofDataset.

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 theAuthentication Overview.

DatasetView

DatasetView specifies which dataset information is returned.

Enums
DATASET_VIEW_UNSPECIFIEDThe default value. Default to the FULL view.
METADATAView metadata information for the dataset, such as friendlyName, description, labels, etc.
ACLView ACL information for the dataset, which defines dataset access for one or more entities.
FULLView both dataset metadata and ACL information.

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 2025-12-22 UTC.