Method: projects.datasets.errors.list
Stay organized with collections
Save and categorize content based on your preferences.
Get all the errors of a Dataset (currently this only works for DDS use case).
HTTP request
GET https://mapsplatformdatasets.googleapis.com/v1alpha/{name=projects/*/datasets/*}/errors
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. Format: projects/${project}/datasets/{dataset_id}
|
Query parameters
| Parameters |
pageSize |
integer
The maximum number of versions to return per page. Defaults to 10.
|
pageToken |
string
The page token, received from a previous errors.list call. Provide this to retrieve the subsequent page.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
Response of errors.list. Returns a repeated string for error messages.
| JSON representation |
{
"errorMessages": [
string
],
"nextPageToken": string
} |
| Fields |
errorMessages[] |
string
The errors belonging to a Dataset.
|
nextPageToken |
string
A token that can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.
|
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
IAM Permissions
Requires the following IAM permission on the name resource:
mapsplatformdatasets.datasets.get
For more information, see the IAM documentation.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-27 UTC."],[[["\u003cp\u003eRetrieve a list of errors for a specific Dataset using the \u003ccode\u003eprojects/*/datasets/*\u003c/code\u003e path.\u003c/p\u003e\n"],["\u003cp\u003eCustomize the results by specifying \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e as query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of error messages and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ecloud-platform\u003c/code\u003e scope and \u003ccode\u003emapsplatformdatasets.datasets.get\u003c/code\u003e permission.\u003c/p\u003e\n"]]],["This document details retrieving dataset errors via a `GET` request to `https://mapsplatformdatasets.googleapis.com/v1alpha/{name=projects/*/datasets/*}/errors`. The request requires a dataset `name` parameter, and supports optional `pageSize` and `pageToken` query parameters for pagination. The request body must be empty. A successful response contains a list of `errorMessages` and an optional `nextPageToken`. Authorization requires the `cloud-platform` scope and the `mapsplatformdatasets.datasets.get` IAM permission.\n"],null,["# Method: projects.datasets.errors.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.ListDatasetErrorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nGet all the errors of a Dataset (currently this only works for DDS use case).\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1alpha/{name=projects/*/datasets/*}/errors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------|\n| `name` | `string` Required. Format: projects/${project}/datasets/{dataset_id} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of versions to return per page. Defaults to 10. |\n| `pageToken` | `string` The page token, received from a previous errors.list call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse of errors.list. Returns a repeated string for error messages.\n\n| JSON representation |\n|------------------------------------------------------------------|\n| ``` { \"errorMessages\": [ string ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `errorMessages[]` | `string` The errors belonging to a Dataset. |\n| `nextPageToken` | `string` A token that can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `mapsplatformdatasets.datasets.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
