يسرد التاريخ لمشروع معين.
يتم فرز التواريخ حسب الوقت المناسب بترتيب تنازلي. سيتم استخدام مفتاح HistoryId لترتيب السجل بنفس وقت التعديل.
قد يُرجع أيًا من رموز الخطأ الأساسية التالية:
- PERMISSION_DENIED - إذا كان المستخدم غير مصرح له بقراءة المشروع
- INVALID_ARGUMENT - إذا كان الطلب غير صحيح
- NOT_FOUND - إذا كان السجل غير موجود
طلب HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
يستخدم عنوان URL بناء جملة gRPC Transcoding .
معلمات المسار
حدود | |
---|---|
projectId | معرف المشروع. مطلوب. |
معلمات الاستعلام
حدود | |
---|---|
pageToken | رمز استمرار لاستئناف الاستعلام في العنصر التالي. خياري. |
pageSize | الحد الأقصى لعدد التواريخ المطلوب جلبها. القيمة الافتراضية: 20. سيستخدم الخادم هذه القيمة الافتراضية إذا لم يتم تعيين الحقل أو كانت قيمته 0. سيتم التعامل مع أي قيمة أكبر من 100 على أنها 100. خياري. |
filterByName | في حالة التعيين، قم بإرجاع التواريخ التي تحمل الاسم المحدد فقط. خياري. |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
رسالة الرد على HistoryService.List
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{
"histories": [
{
object ( |
مجالات | |
---|---|
histories[] | التاريخ. |
nextPageToken | رمز استمرار لاستئناف الاستعلام في العنصر التالي. سيتم تعيينه فقط إذا كان هناك المزيد من التواريخ لجلبها. الرموز صالحة لمدة تصل إلى ساعة واحدة من وقت طلب القائمة الأول. على سبيل المثال، إذا قمت بتقديم طلب قائمة في الساعة 1 ظهرًا واستخدمت الرمز المميز من هذا الطلب الأول بعد 10 دقائق، فسيكون الرمز المميز من هذا الرد الثاني صالحًا لمدة 50 دقيقة فقط. |
نطاقات التفويض
يتطلب نطاق OAuth التالي:
-
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .