Method: projects.datasets.fetchDatasetErrors
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Pobiera wszystkie błędy zbioru danych.
Żądanie HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
dataset |
string
Wymagane. Nazwa zbioru danych, w którym będą wymienione wszystkie błędy. Format: projects/{project}/datasets/{datasetId}
|
Parametry zapytania
| Parametry |
pageSize |
integer
Maksymalna liczba błędów do zwrócenia na stronę. Maksymalna wartość to 500. wartości powyżej 500 będą ograniczane do 500. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 błędów.
|
pageToken |
string
Token strony otrzymany z poprzedniego wywołania ListDatasetErrors. Podaj go, aby pobrać kolejną stronę.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Obiekt odpowiedzi zbioru danych APIss.fetchDatasetErrors.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"nextPageToken": string,
"errors": [
{
object (Status)
}
]
} |
| Pola |
nextPageToken |
string
Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.
|
errors[] |
object (Status)
Błędy powiązane ze zbiorem danych.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cloud-platform
Uprawnienia
Wymaga tych uprawnień IAM w zasobie dataset:
mapsplatformdatasets.datasets.get
Więcej informacji znajdziesz w dokumentacji uprawnień.
Stan
Typ Status określa logiczny model błędów odpowiedni dla różnych środowisk programowania, w tym interfejsów API typu REST i RPC. Jest używany przez gRPC. Każdy komunikat Status zawiera 3 elementy danych: kod błędu, komunikat o błędzie i szczegóły błędu.
Więcej informacji na temat tego modelu błędów i sposobu jego działania znajdziesz w przewodniku API Design Guide (w języku angielskim).
| Zapis JSON |
{
"code": integer,
"message": string,
"details": [
{
"@type": string,
field1: ...,
...
}
]
} |
| Pola |
code |
integer
Kod stanu, który powinien być wartością wyliczeniową równą google.rpc.Code.
|
message |
string
komunikat o błędzie widoczny dla dewelopera. Powinien być w języku angielskim;
|
details[] |
object
Lista komunikatów ze szczegółami błędu. Istnieje typowy zestaw typów wiadomości, których mogą używać interfejsy API.
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
