處理要求錯誤
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Maps Datasets API 會在回覆中傳回錯誤訊息。舉例來說,如果從要求中省略 OAuth 權杖,或權杖已過期,要求會傳回:
{
"error": {
"code": 401,
"message": "Request is missing required authentication credential.
Expected OAuth 2 access token, login cookie or other valid authentication credential.
See https://developers.google.com/identity/sign-in/web/devconsole-project.",
"status": "UNAUTHENTICATED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "CREDENTIALS_MISSING",
"domain": "googleapis.com",
"metadata": {
"method": "google.maps.mapsplatformdatasets.v1alpha.MapsPlatformDatasetsV1Alpha.ListDatasets",
"service": "mapsplatformdatasets.googleapis.com"
}
}
]
}
}
如果省略必要主體參數 (例如建立資料集時的 displayName
),要求會傳回:
{
"error": {
"code": 400,
"message": "display_name: Display name must be provided",
"status": "INVALID_ARGUMENT"
}
}
如果傳遞無效的資料集 ID,要求會傳回:
{
"error": {
"code": 404,
"message": "Dataset not found",
"status": "NOT_FOUND"
}
}
如要進一步瞭解錯誤和錯誤處理,請參閱「錯誤」。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-31 (世界標準時間)。
[null,null,["上次更新時間:2025-08-31 (世界標準時間)。"],[[["\u003cp\u003eThe Maps Datasets API returns errors with codes, messages, and status information to help you troubleshoot issues.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors include missing or expired authentication credentials (401), missing required parameters (400), and invalid dataset IDs (404).\u003c/p\u003e\n"],["\u003cp\u003eError responses provide details about the cause of the error, such as the missing credential or parameter.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the Google Cloud error documentation for comprehensive information on error handling and troubleshooting.\u003c/p\u003e\n"]]],[],null,["# Handle request errors\n\nThe Maps Datasets API returns error messages as part of the\nresponse. For example, if you omit the OAuth token from the\nrequest or if the token has expired, the request returns: \n\n```json\n{\n \"error\": {\n \"code\": 401,\n \"message\": \"Request is missing required authentication credential.\n Expected OAuth 2 access token, login cookie or other valid authentication credential.\n See https://developers.google.com/identity/sign-in/web/devconsole-project.\",\n \"status\": \"UNAUTHENTICATED\",\n \"details\": [\n {\n \"@type\": \"type.googleapis.com/google.rpc.ErrorInfo\",\n \"reason\": \"CREDENTIALS_MISSING\",\n \"domain\": \"googleapis.com\",\n \"metadata\": {\n \"method\": \"google.maps.mapsplatformdatasets.v1alpha.MapsPlatformDatasetsV1Alpha.ListDatasets\",\n \"service\": \"mapsplatformdatasets.googleapis.com\"\n }\n }\n ]\n }\n}\n```\n\nIf you omit a required body parameter, such as `displayName` when creating a\ndataset, the request returns: \n\n```json\n{\n \"error\": {\n \"code\": 400,\n \"message\": \"display_name: Display name must be provided\",\n \"status\": \"INVALID_ARGUMENT\"\n }\n}\n```\n\nIf you pass an invalid dataset ID, the request returns: \n\n```json\n{\n \"error\": {\n \"code\": 404,\n \"message\": \"Dataset not found\",\n \"status\": \"NOT_FOUND\"\n }\n}\n```\n\nFor more information on errors and error handling, see\n[Errors](https://cloud.google.com/apis/design/errors)."]]