Method: projects.histories.list

تاریخچه های یک پروژه معین را فهرست می کند.

تاریخچه ها بر اساس زمان اصلاح به ترتیب نزولی مرتب شده اند. از کلید historyId برای سفارش دادن تاریخچه با همان زمان اصلاح استفاده می شود.

ممکن است هر یک از کدهای خطای متعارف زیر را برگرداند:

  • PERMISSION_DENIED - اگر کاربر مجاز به خواندن پروژه نباشد
  • INVALID_ARGUMENT - اگر درخواست بد شکل باشد
  • NOT_FOUND - اگر تاریخچه وجود نداشته باشد

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

یک نشانه ادامه برای از سرگیری پرس و جو در مورد بعدی.

فقط در صورتی تنظیم می شود که تاریخچه های بیشتری برای واکشی وجود داشته باشد.

توکن ها از زمان اولین درخواست لیست تا یک ساعت معتبر هستند. به عنوان مثال، اگر در ساعت 13 بعد از ظهر یک درخواست لیست ارائه دهید و 10 دقیقه بعد از رمز این درخواست اول استفاده کنید، رمز این پاسخ دوم فقط برای 50 دقیقه معتبر خواهد بود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.