- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- أذونات "إدارة الهوية وإمكانية الوصول"
- الحالة
للحصول على جميع أخطاء مجموعة البيانات.
طلب HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{dataset=projects/*/datasets/*}:fetchDatasetErrors
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
dataset |
مطلوب. اسم مجموعة البيانات المطلوب سرد جميع أخطاءها. التنسيق: projects/{project}/datasets/{datasetId} |
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
تمثّل هذه السمة الحد الأقصى لعدد الأخطاء المطلوب عرضها لكل صفحة. الحد الأقصى للقيمة هو 500؛ القيم الأكبر من 500 سيتم وضع حد أقصى على 500 لها. وفي حال عدم تحديدها، سيتم عرض 50 خطأ كحدّ أقصى. |
pageToken |
الرمز المميّز للصفحة، الذي تم تلقّيه من استدعاء ListDatasetErrors السابق. يمكنك توفير هذا الحقل لاسترداد الصفحة التالية. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
كائن الاستجابة Data.fetchDatasetErrors.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"nextPageToken": string,
"errors": [
{
object ( |
الحقول | |
---|---|
nextPageToken |
رمز مميز يمكن إرساله كـ في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة. |
errors[] |
الأخطاء المرتبطة بمجموعة بيانات. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
أذونات "إدارة الهوية وإمكانية الوصول"
يجب الحصول على إذن IAM التالي في مورد "dataset
":
mapsplatformdatasets.datasets.get
ولمزيد من المعلومات، اطّلِع على مستندات إدارة الهوية وإمكانية الوصول.
الحالة
يحدّد النوع Status
نموذج خطأ منطقي مناسبًا لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة تطبيقات RPC. وتُستخدَم من قِبل gRPC. تحتوي كل رسالة Status
على ثلاث بيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.
يمكنك معرفة المزيد من المعلومات عن نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.
تمثيل JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
الحقول | |
---|---|
code |
رمز الحالة، الذي يجب أن يكون قيمة تعداد بقيمة |
message |
رسالة خطأ مواجهة للمطوِّر، ويجب أن تكون باللغة الإنجليزية |
details[] |
قائمة بالرسائل التي تتضمّن تفاصيل الخطأ. وهناك مجموعة شائعة من أنواع الرسائل التي يمكن لواجهات برمجة التطبيقات استخدامها. |