معالجة أخطاء الطلبات

تعرض واجهة برمجة تطبيقات مجموعات بيانات الخرائط رسائل الخطأ كجزء من الاستجابة. على سبيل المثال، إذا حذفت رمز 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 عند إنشاء مجموعة data set، يعرض الطلب ما يلي:

{
  "error": {
    "code": 400,
    "message": "display_name: Display name must be provided",
    "status": "INVALID_ARGUMENT"
  }
}

في حال ضبط معرّف مجموعة بيانات غير صالح، يعرض الطلب ما يلي:

{
  "error": {
    "code": 404,
    "message": "Dataset not found",
    "status": "NOT_FOUND"
  }
}

لمزيد من المعلومات حول الأخطاء ومعالجة الأخطاء، راجع الأخطاء.