Method: customers.reports.enumeratePrintJobs

הצגת רשימה של משימות הדפסה.

בקשת HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:enumeratePrintJobs

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
customer

string

חובה. מספר לקוח עם הקידומת 'customers/‎' או 'customers/my_customer', כדי להשתמש בלקוח שמשויך לחשבון ששולח את הבקשה.

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

פרמטרים
printerOrgUnitId

string

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

integer

מספר משימות ההדפסה בדף, מ-0 עד 100 כולל. אם לא צוין ערך של pageSize או שהערך הוא אפס, הערך יהיה 50.
pageToken

string

אסימון דף שהתקבל משיחה קודמת של reports.enumeratePrintJobs. צריך לספק אותו כדי לאחזר את הדף הבא. אם לא צוין, יוחזר הדף הראשון של התוצאות.

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

string

מחרוזת שאילתה לסינון תוצאות, שדות מופרדים ב-AND בסינטקס EBNF.

הערה: המסנן הזה לא תומך בפעולות OR. הערה: יש תמיכה רק בקומפרטורים >= ו-<= עבור completeTime. הערה: רק משווה מסוג ‎ = נתמך עבור userId ו-printerId.

שדות מסנן נתמכים:

  • completeTime
  • printerId
  • userId
orderBy

string

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

שדות נתמכים לסדר לפי:

  • title
  • הסמוי הסופי
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • מדפסת
  • userEmail

גוף הבקשה

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

גוף התשובה

תגובה שמכילה רשימה של משימות הדפסה.

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

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

object (PrintJob)

רשימה של משימות ההדפסה שהוזמנו.
nextPageToken

string

אסימון, שיכול להשתמש בבקשה הבאה כדי לאחזר את הדף הבא. אם השדה הזה לא יצוין, לא יהיו דפים נוספים.
totalSize

string (int64 format)

המספר הכולל של בקשות תואמות לעבודות הדפסה.

היקפי הרשאה

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

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

PrintJob

מייצג בקשה להדפסת מסמך שנשלח למדפסת.

ייצוג ב-JSON 
{
  "id": string,
  "title": string,
  "state": enum (State),
  "createTime": string,
  "completeTime": string,
  "documentPageCount": integer,
  "colorMode": enum (ColorMode),
  "duplexMode": enum (DuplexMode),
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userEmail": string,
  "userId": string
}
שדות
id

string

המזהה הייחודי של משימת ההדפסה.
title

string

כותרת המסמך.
state

enum (State)

המצב הסופי של המשימה.
createTime

string (Timestamp format)

חותמת הזמן של יצירת משימת ההדפסה.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
completeTime

string (Timestamp format)

חותמת הזמן של השלמת משימת ההדפסה.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
documentPageCount

integer

מספר הדפים במסמך.
colorMode

enum (ColorMode)

מצב צבע.
duplexMode

enum (DuplexMode)

מצב דופלקס.
copyCount

integer

מספר העותקים.
printerId

string

מזהה ה-API של המדפסת ששימשה להדפסה.
printer

string

שם המדפסת שמשמשת להדפסה.
userEmail

string

כתובת האימייל הראשית של המשתמש ששלח את משימת ההדפסה.
userId

string

המזהה הייחודי של Directory API של המשתמש ששלח את משימת ההדפסה.

מדינה

המצב של עבודת ההדפסה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED משימת ההדפסה במצב לא מוגדר.
PRINTED המסמך הודפס בהצלחה.
CANCELLED משימת ההדפסה בוטלה.
FAILED משימת ההדפסה נכשלה.

ColorMode

מצב הצבע של משימת ההדפסה.

טיפוסים בני מנייה (enum)
COLOR_MODE_UNSPECIFIED לא צוין.
BLACK_AND_WHITE שחור-לבן.
COLOR צבע.

DuplexMode

מצב הדפסה דו-צדדית של משימת הדפסה.

טיפוסים בני מנייה (enum)
DUPLEX_MODE_UNSPECIFIED לא צוין.
ONE_SIDED חד-צדדי.
TWO_SIDED_LONG_EDGE היפוך דו-צדדי בצד הארוך.
TWO_SIDED_SHORT_EDGE היפוך דו-צדדי עם קצה קצר.