Method: projects.histories.list

מפרט היסטוריות עבור פרויקט נתון.

ההיסטוריות ממוינות לפי זמן שינוי בסדר יורד. מפתח historyId ישמש להזמנת ההיסטוריה באותו זמן שינוי.

עשוי להחזיר כל אחד מקודי השגיאה הקנוניים הבאים:

  • PERMISSION_DENIED - אם המשתמש אינו מורשה לקרוא את הפרויקט
  • INVALID_ARGUMENT - אם הבקשה שגויה
  • NOT_FOUND - אם ההיסטוריה לא קיימת

בקשת HTTP

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

כתובת האתר משתמשת בתחביר 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:00 ותשתמש באסימון מהבקשה הראשונה הזו 10 דקות מאוחר יותר, האסימון מהתגובה השנייה הזו יהיה תקף למשך 50 דקות בלבד.

היקפי הרשאה

דורש את היקף ה-OAuth הבא:

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

למידע נוסף, עיין בסקירת האימות .