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"}}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[[["\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)."]]