Method: customers.reports.enumeratePrintJobs

لیستی از کارهای چاپ را دریافت کنید.

درخواست HTTP

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

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

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

مولفه های
customer

string

ضروری. شناسه مشتری با پیشوند «customers/» یا «customers/my_customer» برای استفاده از مشتری مرتبط با حسابی که درخواست را ارائه می‌کند.

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

مولفه های
printerOrgUnitId

string

شناسه واحد سازمانی چاپگرها. در صورت مشخص شدن، فقط کارهای چاپی ارسالی به چاپگرها از واحد سازمانی مشخص شده بازگردانده می شود.

pageSize

integer

تعداد کارهای چاپی در صفحه از 0 تا 100 شامل، اگر pageSize مشخص نشده باشد یا صفر باشد، اندازه 50 خواهد بود.

pageToken

string

یک نشانه صفحه دریافت شده از یک تماس reports.enumeratePrintJobs قبلی.enumeratePrintJobs. این را برای بازیابی صفحه بعدی ارائه کنید. در صورت حذف، صفحه اول نتایج برگردانده می شود.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به reports.enumeratePrintJobs باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

filter

string

رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF.

توجه: عملیات OR در این فیلتر پشتیبانی نمی شود. توجه: فقط مقایسه کننده های >= و <= برای completeTime پشتیبانی می شوند. توجه: فقط = مقایسه کننده برای userId و printerId پشتیبانی می شود.

فیلدهای فیلتر پشتیبانی شده:

  • زمان کامل
  • شناسه چاپگر
  • شناسه کاربر
orderBy

string

فیلد مورد استفاده برای سفارش نتایج. اگر مشخص نشده باشد، نتایج به ترتیب نزولی فیلد completeTime مرتب خواهند شد.

سفارش پشتیبانی شده بر اساس فیلدها:

  • عنوان
  • حالت
  • createTime
  • زمان کامل
  • documentPageCount
  • colorMode
  • حالت duplex
  • چاپگر
  • ایمیل کاربر

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ حاوی لیستی از کارهای چاپی.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی 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)

چاپ مهر زمانی ایجاد شغل

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

completeTime

string ( Timestamp format)

چاپ مهر زمان اتمام کار

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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 کاربری که کار چاپ را ارسال کرده است.

حالت

وضعیت کار چاپ

Enums
STATE_UNSPECIFIED کار چاپ در حالت نامشخصی است.
PRINTED سند با موفقیت چاپ شد.
CANCELLED کار چاپ لغو شد.
FAILED کار چاپ انجام نشد.

ColorMode

حالت رنگ کار چاپ

Enums
COLOR_MODE_UNSPECIFIED نامشخص
BLACK_AND_WHITE سیاه و سفید.
COLOR رنگ.

DuplexMode

حالت دورو کار چاپ.

Enums
DUPLEX_MODE_UNSPECIFIED نامشخص
ONE_SIDED یک طرفه.
TWO_SIDED_LONG_EDGE چرخش دو طرفه روی لبه بلند.
TWO_SIDED_SHORT_EDGE چرخاندن دو طرفه روی لبه کوتاه.
،

لیستی از کارهای چاپ را دریافت کنید.

درخواست HTTP

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

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

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

مولفه های
customer

string

ضروری. شناسه مشتری با پیشوند «customers/» یا «customers/my_customer» برای استفاده از مشتری مرتبط با حسابی که درخواست را ارائه می‌کند.

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

مولفه های
printerOrgUnitId

string

شناسه واحد سازمانی چاپخانه ها. در صورت مشخص شدن، فقط کارهای چاپی ارسالی به چاپگرها از واحد سازمانی مشخص شده بازگردانده می شود.

pageSize

integer

تعداد کارهای چاپی در صفحه از 0 تا 100 شامل، اگر pageSize مشخص نشده باشد یا صفر باشد، اندازه 50 خواهد بود.

pageToken

string

یک نشانه صفحه دریافت شده از یک تماس reports.enumeratePrintJobs قبلی.enumeratePrintJobs. این را برای بازیابی صفحه بعدی ارائه دهید. در صورت حذف، صفحه اول نتایج برگردانده می شود.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به reports.enumeratePrintJobs باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

filter

string

رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF.

توجه: عملیات OR در این فیلتر پشتیبانی نمی شود. توجه: فقط مقایسه کننده های >= و <= برای completeTime پشتیبانی می شوند. توجه: فقط = مقایسه کننده برای userId و printerId پشتیبانی می شود.

فیلدهای فیلتر پشتیبانی شده:

  • زمان کامل
  • شناسه چاپگر
  • شناسه کاربر
orderBy

string

فیلد مورد استفاده برای سفارش نتایج. اگر مشخص نشده باشد، نتایج به ترتیب نزولی فیلد completeTime مرتب خواهند شد.

سفارش پشتیبانی شده بر اساس فیلدها:

  • عنوان
  • حالت
  • createTime
  • زمان کامل
  • documentPageCount
  • colorMode
  • حالت duplex
  • چاپگر
  • ایمیل کاربر

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ حاوی لیستی از کارهای چاپی.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی 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)

چاپ مهر زمانی ایجاد شغل

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

completeTime

string ( Timestamp format)

چاپ مهر زمان اتمام کار

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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 کاربری که کار چاپ را ارسال کرده است.

حالت

وضعیت کار چاپ

Enums
STATE_UNSPECIFIED کار چاپ در حالت نامشخصی است.
PRINTED سند با موفقیت چاپ شد.
CANCELLED کار چاپ لغو شد.
FAILED کار چاپ انجام نشد.

ColorMode

حالت رنگ کار چاپ

Enums
COLOR_MODE_UNSPECIFIED نامشخص
BLACK_AND_WHITE سیاه و سفید.
COLOR رنگ.

DuplexMode

حالت دورو کار چاپ.

Enums
DUPLEX_MODE_UNSPECIFIED نامشخص
ONE_SIDED یک طرفه.
TWO_SIDED_LONG_EDGE چرخش دو طرفه روی لبه بلند.
TWO_SIDED_SHORT_EDGE چرخاندن دو طرفه روی لبه کوتاه.