Method: providers.tasks.list

הפונקציה מקבלת את כל הערכים של Task שעומדים בקריטריונים לסינון שצוינו.

בקשת HTTP

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. הפורמט הנדרש הוא providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project.

פרמטרים של שאילתה

פרמטרים
header

object (DeliveryRequestHeader)

זה שינוי אופציונלי. הכותרת הרגילה של בקשה ל-Delivery API.

pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של משימות להחזרה. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים את הערך הזה, השרת קובע את מספר התוצאות שיוחזר.

pageToken

string

זה שינוי אופציונלי. אסימון דף שהתקבל משיחה קודמת של tasks.list. אפשר לספק את הפרמטר הזה כדי לאחזר את הדף הבא.

כשמחלקים את הדפים, כל הפרמטרים האחרים שסופקו ל-tasks.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.

filter

string

זה שינוי אופציונלי. שאילתת סינון שתחול כשמציגים את המשימות. דוגמאות לתחביר של מסננים זמינות בכתובת http://aip.dev/160. אם לא מציינים ערך או מסננים לפי מחרוזת ריקה, כל המשימות יוחזרו. מידע על מאפייני המשימות שאפשר לסנן לפיהם זמין במאמר רשימת משימות.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

התשובה tasks.list שמכילה את קבוצת המשימות שעומדות בקריטריונים לסינון ב-ListTasksRequest.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
שדות
tasks[]

object (Task)

קבוצת המשימות שעומדות בקריטריונים המבוקשים לסינון. אם לא מציינים מסנן, הבקשה מחזירה את כל המשימות. תגובה מוצלחת יכולה גם להיות ריקה. תגובה ריקה מציינת שלא נמצאו משימות שתואמות לקריטריוני הסינון המבוקשים.

nextPageToken

string

מעבירים את האסימון הזה ב-ListTasksRequest כדי להמשיך להציג את התוצאות. אם כל התוצאות הוחזרו, השדה הזה הוא מחרוזת ריקה או שהוא לא מופיע בתשובה.

totalSize

string (int64 format)

המספר הכולל של משימות שתואמות לקריטריוני הבקשה, בכל הדפים.