Method: projects.datasets.fetchDatasetErrors

  • Retrieves all errors associated with a specific dataset within Google Maps Platform Datasets.

  • Allows for pagination to handle large lists of errors, specifying page size and using tokens for navigation.

  • Requires authentication with the https://www.googleapis.com/auth/cloud-platform OAuth scope and mapsplatformdatasets.datasets.get IAM permission.

  • Returns error details using a standardized Status object containing an error code, message, and optional details for debugging.

  • Provides details about the HTTP request structure, path and query parameters, and expected response format.

Gets all the errors of a dataset.

HTTP request

GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
dataset

string

Required. The name of the dataset to list all the errors for. Format: projects/{project}/datasets/{datasetId}

Query parameters

Parameters
pageSize

integer

The maximum number of errors to return per page.

The maximum value is 500; values above 500 will be capped to 500.

If unspecified, at most 50 errors will be returned.
pageToken

string

The page token, received from a previous ListDatasetErrors call. Provide this to retrieve the subsequent page.

Request body

The request body must be empty.

Response body

Response object of datasets.fetchDatasetErrors.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "nextPageToken": string,
  "errors": [
    {
      object (Status)
    }
  ]
}
Fields
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.
errors[]

object (Status)

The errors associated with a dataset.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

IAM Permissions

Requires the following IAM permission on the dataset resource:

  • mapsplatformdatasets.datasets.get

For more information, see the IAM documentation.

Status

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

You can find out more about this error model and how to work with it in the API Design Guide.

JSON representation 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Fields
code

integer

The status code, which should be an enum value of google.rpc.Code.
message

string

A developer-facing error message, which should be in English.
details[]

object

A list of messages that carry the error details. There is a common set of message types for APIs to use.