To retrieve the next page of table data, set this field to the string provided in the pageToken field of the response body from your previous call to tabledata.list.
selectedFields
string
Subset of fields to return, supports select into sub fields. Example: selectedFields = "a,e.d.f";
Total rows of the entire table. In order to show default value "0", we have to present it as string.
pageToken
string
When this field is non-empty, it indicates that additional results are available. To request the next page of data, set the pageToken field of your next tabledata.list call to the string returned in this field.
[[["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 endpoint retrieves data from a specified table within a BigQuery dataset, using a GET request to a predefined URL structure.\u003c/p\u003e\n"],["\u003cp\u003eRequired path parameters include the \u003ccode\u003eprojectId\u003c/code\u003e, \u003ccode\u003edatasetId\u003c/code\u003e, and \u003ccode\u003etableId\u003c/code\u003e to uniquely identify the target table.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \u003ccode\u003estartIndex\u003c/code\u003e, \u003ccode\u003emaxResults\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e allow for pagination and control over the amount and location of the data returned.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, if successful, contains metadata like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003etotalRows\u003c/code\u003e, and a list of \u003ccode\u003erows\u003c/code\u003e, with each row being a set of field-value pairs.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires one of four specified OAuth scopes, ensuring proper access control and data security.\u003c/p\u003e\n"]]],[],null,["# Method: tabledata.list\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 - [JSON representation](#body.TableDataList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\ntabledata.list the content of a table in rows.\n\n### HTTP request\n\n`GET https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets/{datasetId}/tables/{tableId}/data`\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\nThe response of a tabledata.list request.\n\nIf successful, the response body contains data with the following structure:\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)."]]
