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"]],["最后更新时间 (UTC):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)."]]