Method: projects.datasets.fetchDatasetErrors
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtiene todos los errores de un conjunto de datos.
Solicitud HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
dataset |
string
Obligatorio. El nombre del conjunto de datos para el que se enumerarán todos los errores. Formato: projects/{project}/datasets/{datasetId}
|
Parámetros de consulta
| Parámetros |
pageSize |
integer
La cantidad máxima de errores que se muestran por página. El valor máximo es 500. los valores superiores a 500 se limitarán a 500. Si no se especifica, se mostrarán 50 errores como máximo.
|
pageToken |
string
El token de la página, recibido de una llamada anterior ListDatasetErrors. Proporciona esto para recuperar la página siguiente.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Objeto de respuesta de datasets.fetchDatasetErrors.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"nextPageToken": string,
"errors": [
{
object (Status)
}
]
} |
| Campos |
nextPageToken |
string
Un token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.
|
errors[] |
object (Status)
Son los errores asociados con un conjunto de datos.
|
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
Permisos de IAM
Se requiere el siguiente permiso de IAM en el recurso dataset:
mapsplatformdatasets.datasets.get
Para obtener más información, consulta la documentación de IAM.
Estado
El tipo de Status define un modelo de error lógico que es adecuado para entornos de programación diferentes, incluidas las API de REST y las API de RPC. Lo usa gRPC. Cada mensaje Status contiene tres datos: código de error, mensaje de error y detalles del error.
Puedes obtener más información sobre este modelo de error y cómo trabajar con él en la guía de diseño de API.
| Representación JSON |
{
"code": integer,
"message": string,
"details": [
{
"@type": string,
field1: ...,
...
}
]
} |
| Campos |
code |
integer
El código de estado, que debe ser un valor enum de google.rpc.Code.
|
message |
string
Un mensaje de error dirigido al desarrollador, que debe estar en inglés.
|
details[] |
object
Una lista de mensajes que contienen los detalles del error. Hay un conjunto común de tipos de mensajes para que usen las API.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eRetrieves all errors associated with a specific dataset within Google Maps Platform Datasets.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to handle large lists of errors, specifying page size and using tokens for navigation.\u003c/p\u003e\n"],["\u003cp\u003eRequires authentication with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and \u003ccode\u003emapsplatformdatasets.datasets.get\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eReturns error details using a standardized \u003ccode\u003eStatus\u003c/code\u003e object containing an error code, message, and optional details for debugging.\u003c/p\u003e\n"],["\u003cp\u003eProvides details about the HTTP request structure, path and query parameters, and expected response format.\u003c/p\u003e\n"]]],["This describes how to retrieve dataset errors via a `GET` HTTP request to a specific URL, including the dataset path parameter. You can use optional `pageSize` (max 500) and `pageToken` query parameters for pagination. The request body is empty. The response body contains a `nextPageToken` for pagination and an `errors` array. Authorization requires the `cloud-platform` OAuth scope and `mapsplatformdatasets.datasets.get` IAM permission. Each `Status` error has a code, message, and details.\n"],null,["# Method: projects.datasets.fetchDatasetErrors\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.FetchDatasetErrorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Status](#Status)\n - [JSON representation](#Status.SCHEMA_REPRESENTATION)\n\nGets all the errors of a dataset.\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|------------------------------------------------------------------------------------------------------------------------|\n| `dataset` | `string` Required. The name of the dataset to list all the errors for. Format: projects/{project}/datasets/{datasetId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n| `pageToken` | `string` The page token, received from a previous ListDatasetErrors call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse object of datasets.fetchDatasetErrors.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"nextPageToken\": string, \"errors\": [ { object (/maps/documentation/datasets/reference/rest/v1/projects.datasets/fetchDatasetErrors#Status) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\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| `errors[]` | `object (`[Status](/maps/documentation/datasets/reference/rest/v1/projects.datasets/fetchDatasetErrors#Status)`)` The errors associated with a dataset. |\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 `dataset` resource:\n\n- `mapsplatformdatasets.datasets.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nStatus\n------\n\nThe `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](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------|\n| ``` { \"code\": integer, \"message\": string, \"details\": [ { \"@type\": string, field1: ..., ... } ] } ``` |\n\n| Fields ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `code` | `integer` The status code, which should be an enum value of [google.rpc.Code](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto). |\n| `message` | `string` A developer-facing error message, which should be in English. |\n| `details[]` | `object` A list of messages that carry the error details. There is a common set of message types for APIs to use. |"]]
