Method: projects.datasets.fetchDatasetErrors
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Xem tất cả các lỗi của một tập dữ liệu.
Yêu cầu HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số |
dataset |
string
Bắt buộc. Tên của tập dữ liệu để liệt kê tất cả lỗi. Định dạng: dự án/{project}/datasets/{datasetId}
|
Tham số truy vấn
Tham số |
pageSize |
integer
Số lỗi tối đa cần trả về trên mỗi trang. Giá trị tối đa là 500; các giá trị trên 500 sẽ bị giới hạn ở mức 500. Nếu bạn không chỉ định, trình xử lý sẽ trả về tối đa 50 lỗi.
|
pageToken |
string
Mã thông báo trang, nhận được từ lệnh gọi ListDatasetErrors trước đó. Cung cấp mã này để truy xuất trang tiếp theo.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Đối tượng phản hồi của name.fetchDatasetErrors.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"nextPageToken": string,
"errors": [
{
object (Status )
}
]
} |
Trường |
nextPageToken |
string
Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.
|
errors[] |
object (Status )
Các lỗi liên quan đến một tập dữ liệu.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/cloud-platform
Quyền quản lý danh tính và quyền truy cập (IAM)
Cần có quyền IAM sau đây đối với tài nguyên dataset
:
mapsplatformdatasets.datasets.get
Để biết thêm thông tin, hãy xem tài liệu về IAM.
Trạng thái
Loại Status
xác định mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. Hàm này được gRPC sử dụng. Mỗi thông báo Status
chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.
Bạn có thể tìm hiểu thêm về mô hình lỗi này cũng như cách xử lý trong Hướng dẫn thiết kế API.
Biểu diễn dưới dạng JSON |
{
"code": integer,
"message": string,
"details": [
{
"@type": string,
field1: ...,
...
}
]
} |
Trường |
code |
integer
Mã trạng thái, phải là một giá trị enum của google.rpc.Code .
|
message |
string
Thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh.
|
details[] |
object
Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một nhóm loại thông báo phổ biến để API sử dụng.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]