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

הבקשות לדוגמה שמופיעות בדף הזה ממחישות איך לנהל מדפסות באמצעות Chrome Printer Management API.

כל הבקשות לדוגמה משתמשות במשתנים הבאים:

• ‫TOKEN: אסימון OAuth 2.0 של האפליקציה.
• ‫CUSTOMER_ID: מספר הלקוח הייחודי של חשבון Enterprise, עם האות C בתחילתו. (דוגמה: C123abc4) אפשר גם להזין my_customer כדי לציין את מספר הלקוח של החשבון שלכם.

רשימת דגמי מדפסות

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

בקשה

curl -X GET \
  --header "Authorization: Bearer TOKEN" \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers:listPrinterModels"

תשובה

{
  "printerModels": [
    {
      "manufacturer": "Anitech",
      "displayName": "Anitech M24",
      "makeAndModel": "anitech m24"
    },
    {
      "manufacturer": "Apollo",
      "displayName": "Apollo P-2100",
      "makeAndModel": "apollo apollo 2100"
    },
    //...
    {
      "manufacturer": "Brother",
      "displayName": "Brother DCP-7025",
      "makeAndModel": "brother dcp-7025"
    },
    //...
  ],
  "nextPageToken": "CGQQAQ=="
}

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

בדוגמה הזו מוצגת בקשה לקבלת רשימה של כל המדפסות שגלויות במזהה היחידה הארגונית 04fatzly26exj7b ומכילות את המילה Lobby בשם או בתיאור של המדפסת. מדפסות שנוספו ליחידה ארגונית אב גלויות ליחידות ארגוניות צאצא, ולכן יכול להיות שהתשובה תכלול מדפסות שלא נמצאות ביחידה הארגונית 04fatzly26exj7b.

בקשה

curl -X GET \
  --header "Authorization: Bearer TOKEN" \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers?orgUnitId=04fatzly26exj7b&filter=Lobby"

תשובה

{
  "printers": [
     {
      "name": "customers/C0202nabg/chrome/printers/0gjdgxs2zla0y7",
      "id": "0gjdgxs2zla0y7",
      "displayName": "Jupiter",
      "description": "Guest printer in lobby Building C.",
      "makeAndModel": "xerox able 1406",
      "uri": "ipp://192.168.10.13",
      "createTime": "2021-03-11T21:41:34.779587Z",
      "orgUnitId": "04fatzly26exj7b"
    },
    {
      "name": "customers/C0202nabg/chrome/printers/0gjdgxs1eqkb60",
      "id": "0gjdgxs1eqkb60",
      "displayName": "Mars",
      "description": "Printer in Lobby Building A",
      "uri": "ipp://192.168.10.11",
      "createTime": "2021-03-11T22:02:06.048469Z",
      "orgUnitId": "04fatzly4jbjho9",
      "useDriverlessConfig": true
    }
  ]
}

קבלת מדפסת מסוימת

בדוגמה הזו נבקש פרטים על מדפסת עם המזהה 0gjdgxs2zla0y7.

הערה: אפשר למצוא את מזהה המדפסת בדף הפרטים שלה במסוף Admin.

בקשה

curl -X GET \
  --header "Authorization: Bearer TOKEN" \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers/0gjdgxs2zla0y7"

תשובה

{
  "name": "customers/C0202nabg/chrome/printers/0gjdgxs2zla0y7",
  "id": "0gjdgxs2zla0y7",
  "displayName": "Jupiter",
  "description": "Guest printer in lobby Building C.",
  "makeAndModel": "xerox able 1406",
  "uri": "ipp://192.168.10.13",
  "createTime": "2021-03-11T21:41:34.779587Z",
  "orgUnitId": "04fatzly26exj7b"
}

יצירת מדפסת

בדוגמה הזו מוסיפים מדפסת חדשה ביחידה הארגונית עם המזהה 04fatzly26exj7b.

הערה: אם יוצרים מדפסת ביחידה ארגונית, המדפסת תהיה גלויה בכל יחידות הצאצא, אבל לא ביחידות הארגוניות ברמה העליונה.

בקשה

curl -X POST \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer TOKEN" \
  -d '{
    "displayName": "Mercury",
    "description": "Printer in the kitchen",
    "makeAndModel": "xerox able 1406",
    "uri": "ipp://192.168.10.14",
    "orgUnitId": "04fatzly26exj7b"
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers"

תשובה

תגובה מוצלחת כוללת את המזהה של המדפסת החדשה שנוצרה:

{
  "name": "customers/C0202nabg/chrome/printers/0gjdgxs0o422uq",
  "id": "0gjdgxs0o422uq",
  "displayName": "Mercury",
  "description": "Printer in the kitchen",
  "makeAndModel": "xerox able 1406",
  "uri": "ipp://192.168.10.14",
  "createTime": "2021-03-11T23:19:27.180846Z",
  "orgUnitId": "04fatzly26exj7b"
}

עדכון מדפסת

בדוגמה הזו מתעדכנת ההגדרה של תיאור המדפסת עם המזהה 0gjdgxs0o422uq.

בקשה

curl -X PATCH \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer TOKEN" \
  -d '{
    "description": "Printer in the office"
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers/0gjdgxs0o422uq?updateMask=description"

תשובה

{
  "name": "customers/C0202nabg/chrome/printers/0gjdgxs0o422uq",
  "id": "0gjdgxs0o422uq",
  "displayName": "Mercury",
  "description": "Printer in the office",
  "makeAndModel": "xerox able 1406",
  "uri": "ipp://192.168.10.14",
  "createTime": "2021-03-11T23:19:27.180846Z",
  "orgUnitId": "04fatzly26exj7b"
}

מחיקת מדפסת

בדוגמה הזו נמחקת המדפסת עם מזהה המדפסת 0gjdgxs0o422uq.

בקשה

curl -X DELETE \
  --header "Authorization: Bearer TOKEN" \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers/0gjdgxs0o422uq"

תשובה

תגובה מוצלחת היא ריקה. {}

יצירה של כמה מדפסות בבקשה אחת

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

הערה: כל המדפסות בבקשה לאצווה צריכות להיות שייכות לאותה יחידה ארגונית.

בקשה

curl -X POST \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer TOKEN" \
  -d '{
    "requests": [
      {
        "parent": "customers/CUSTOMER_ID",
        "printer": {
          "displayName": "Earth",
          "description": "Color printer",
          "useDriverlessConfig": true,
          "uri": "ipp://192.168.10.15",
          "orgUnitId": "04fatzly26exj7b"
        }
    },
    {
        "parent": "customers/CUSTOMER_ID",
        "printer": {
          "displayName": "Saturn",
          "description": "Color printer",
          "useDriverlessConfig": true,
          "uri": "ipp://192.168.10.16",
          "orgUnitId": "04fatzly26exj7b"
        }
    }
  ]
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers:batchCreatePrinters"

תשובה

{
  "printers": [
    {
      "name": "customers/C0202nabg/chrome/printers/0gjdgxs0sbbh87",
      "id": "0gjdgxs0sbbh87",
      "displayName": "Saturn",
      "description": "Color printer",
      "uri": "ipp://192.168.10.16",
      "createTime": "2021-03-12T01:10:32.957084Z",
      "orgUnitId": "04fatzly26exj7b",
      "useDriverlessConfig": true
    },
    {
      "name": "customers/C0202nabg/chrome/printers/0gjdgxs2d6170e",
      "id": "0gjdgxs2d6170e",
      "displayName": "Earth",
      "description": "Color printer",
      "uri": "ipp://192.168.10.15",
      "createTime": "2021-03-12T01:10:32.956735Z",
      "orgUnitId": "04fatzly26exj7b",
      "useDriverlessConfig": true
    }
  ]
}

מחיקה של כמה מדפסות בבקשה אחת

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

בקשה

curl -X POST \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer TOKEN" \
  -d '{
    "printerIds": ["0gjdgxs0sbbh87", "0gjdgxs2d6170e"]
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID/chrome/printers:batchDeletePrinters"

תשובה

תגובה מוצלחת כוללת את המזהים של שרתי ההדפסה שנמחקו:

{
  "printerIds": [
    "0gjdgxs2d6170e",
    "0gjdgxs0sbbh87"
  ]
}