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

تعرض واجهة برمجة التطبيقات 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"
  }
}

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

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

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