Method: projects.datasets.fetchDatasetErrors
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recebe todos os erros de um conjunto de dados.
Solicitação HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
dataset |
string
Obrigatório. O nome do conjunto de dados para listar todos os erros. Formato: projects/{project}/datasets/{datasetId}
|
Parâmetros de consulta
| Parâmetros |
pageSize |
integer
O número máximo de erros a serem retornados por página. O valor máximo é 500. valores acima de 500 serão limitados a 500. Se não for especificado, serão retornados no máximo 50 erros.
|
pageToken |
string
O token da página, recebido de uma chamada ListDatasetErrors anterior. Forneça isso para recuperar a página subsequente.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Objeto de resposta de datasets.fetchDatasetErrors.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
{
"nextPageToken": string,
"errors": [
{
object (Status)
}
]
} |
| Campos |
nextPageToken |
string
Um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.
|
errors[] |
object (Status)
Os erros associados a um conjunto de dados.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
Permissões do IAM
Requer a seguinte permissão do IAM no recurso dataset:
mapsplatformdatasets.datasets.get
Para mais informações, consulte a documentação do IAM.
Status
O tipo Status define um modelo de erro lógico que é adequado a diferentes ambientes de programação, incluindo APIs REST e RPC. É usado por gRPC (em inglês). Cada mensagem Status contém três partes de dados: código do erro, mensagem de erro e detalhes do erro.
É possível descobrir mais sobre esse modelo de erro e como trabalhar com ele no Guia de design de API.
| Representação JSON |
{
"code": integer,
"message": string,
"details": [
{
"@type": string,
field1: ...,
...
}
]
} |
| Campos |
code |
integer
O código de status, que precisa ser um valor de enumeração de google.rpc.Code.
|
message |
string
Uma mensagem de erro em inglês para o desenvolvedor.
|
details[] |
object
Uma lista de mensagens com os detalhes do erro. Há um conjunto comum de tipos de mensagens para as APIs usarem.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 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. |"]]
