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

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

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

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

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