Method: projects.histories.list

يسرد السجلات لمشروع معيّن.

يتم فرز السجلات حسب وقت التعديل بترتيب تنازلي. سيتم استخدام مفتاح HistoryId لترتيب السجلّ في وقت التعديل نفسه.

قد يعرض أيًا من رموز الخطأ الأساسية التالية:

  • permissions_DENIED - إذا لم يكن المستخدم مصرحًا له بقراءة المشروع
  • nofollow_verification - إذا تمت كتابة الطلب بطريقة غير صحيحة
  • NOT_FOUND - في حالة عدم وجود السجل

طلب HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
projectId

string

رقم تعريف المشروع

مطلوب.

معامِلات طلب البحث

المَعلمات
pageToken

string

رمز مميز للمتابعة لاستئناف الاستعلام عند العنصر التالي.

هذه السمة اختيارية.
pageSize

integer

الحد الأقصى لعدد السجلّات التي يمكن جلبها.

القيمة التلقائية: 20. وسيستخدم الخادم هذا الخيار التلقائي إذا لم يتم ضبط الحقل أو إذا كانت قيمته 0. وسيتم التعامل مع أي قيمة أكبر من 100 على أنها 100.

هذه السمة اختيارية.
filterByName

string

وفي حال ضبطها، يمكنك عرض السجلّات بالاسم الذي تم إدخاله فقط.

هذه السمة اختيارية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الرد لـ HistoryService.List

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
الحقول
histories[]

object (History)

السجلّات
nextPageToken

string

رمز مميز للمتابعة لاستئناف الاستعلام عند العنصر التالي.

لن يتم ضبطه إلا إذا كانت هناك سجلّات إضافية يمكن استرجاعها.

تكون الرموز المميزة صالحة لمدة تصل إلى ساعة واحدة من وقت طلب القائمة الأول. على سبيل المثال، إذا أرسلت طلب قائمة في الساعة 1 ظهرًا واستخدمت الرمز المميز من هذا الطلب الأول بعد 10 دقائق، سيكون الرمز المميز من هذه الاستجابة الثانية صالحًا لمدة 50 دقيقة فقط.

نطاقات الأذونات

يتطلب نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.