สร้างและจัดการเซิร์ฟเวอร์การพิมพ์

คำขอตัวอย่างในหน้านี้แสดงวิธีจัดการเซิร์ฟเวอร์การพิมพ์ด้วย Chrome Printer Management API

คำขอตัวอย่างทั้งหมดใช้ตัวแปรต่อไปนี้

  • $TOKEN: โทเค็น OAuth 2.0 ของแอปพลิเคชัน
  • $CUSTOMER: รหัสลูกค้าที่ไม่ซ้ำกันของบัญชีองค์กร โดยจะมี "C" นำหน้า (เช่น C123abc4) นอกจากนี้ คุณยังป้อน my_customer เพื่อระบุรหัสลูกค้าขององค์กรของคุณเองได้ด้วย

แสดงรายการหรือค้นหาเซิร์ฟเวอร์การพิมพ์

ตัวอย่างนี้จะขอรายการเซิร์ฟเวอร์พิมพ์ทั้งหมดที่มองเห็นได้ในองค์กร

ส่งคำขอ

  curl -X GET  \
  --header "Authorization: Bearer $TOKEN" \
  "https://admin.googleapis.com/admin/directory/v1/customers/$CUSTOMER/chrome/printServers"

คำตอบ

{
  "printServers": [
     {
      "name": "customers/C0202nabg/chrome/printServers/0gjdgxs2zla0y7",
      "id": "0gjdgxs2zla0y7",
      "displayName": "Marketing Print Server",
      "description": "Queue for corp marketing oversize jobs",
      "uri": "ipp://192.168.10.13",
      "createTime": "2021-03-11T21:41:34.779587Z",
      "orgUnitId": "04fatzly26exj7b"
    },
    {
      "name": "customers/C0202nabg/chrome/printServers/0gjdgxs1eqkb32",
      "id": "0gjdgxs1eqkb32",
      "displayName": "Production",
      "description": "Production print server for user manuals",
      "uri": "ipp://192.168.10.11",
      "createTime": "2021-03-11T22:02:06.048469Z",
      "orgUnitId": "04fatzly4jbjho9",
    }
  ]
}

รับเซิร์ฟเวอร์การพิมพ์ที่เฉพาะเจาะจง

ตัวอย่างนี้ขอรายละเอียดสำหรับเซิร์ฟเวอร์การพิมพ์ที่มีรหัส 0gjdgxs2zla0y7

ส่งคำขอ

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

คำตอบ

{
  "name": "customers/C0234nab1/chrome/printServers/0gjdgxs2zla0y7",
  "id": "0gjdgxs2zla0y7",
  "displayName": "Marketing Print Server",
  "description": "Queue for corp marketing oversize jobs",
  "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": "hr-dept",
    "description": "HR queue for sensitive documents",
    "uri": "ipp://192.168.10.14",
    "orgUnitId": "04fatzly26exj7b"
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/$CUSTOMER/chrome/printServers"

คำตอบ

{
  "name": "customers/C0234nab1/chrome/printServers/0gjdgxs0o422uq",
  "id": "0gjdgxs0o422uq", // Note: This is the ID of the newly created print server.
  "displayName": "hr-dept",
  "description": "HR queue for sensitive documents",
  "uri": "ipp://192.168.10.14",
  "orgUnitId": "04fatzly26exj7b",
  "createTime": "2021-03-11T23:19:27.180846Z",
  "orgUnitId": "04fatzly26exj7b"
}

อัปเดตเซิร์ฟเวอร์การพิมพ์

ตัวอย่างนี้จะอัปเดตรายละเอียดของรหัสเซิร์ฟเวอร์การพิมพ์ 0gjdgxs0o422uq

ส่งคำขอ

curl -X PATCH \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer $TOKEN" \
  -d '{
    "description": "General HR dept print server",
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/$CUSTOMER/chrome/printServers/0gjdgxs0o422uq?updateMask=description"

คำตอบ

{
  "name": "customers/C0234nab1/chrome/printServers/0gjdgxs0o422uq",
  "id": "0gjdgxs0o422uq",
  "displayName": "hr-dept",
  "description": "General HR dept print server",
  "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/chrome/printServers/0gjdgxs0o422uq"

คำตอบ

การตอบกลับที่สำเร็จจะว่างเปล่า

สร้างเซิร์ฟเวอร์การพิมพ์หลายรายการในคำขอเดียว

ตัวอย่างนี้จะสร้างเซิร์ฟเวอร์การพิมพ์หลายรายการโดยใช้วิธี batchCreatePrintServers

ส่งคำขอ

curl -X POST \
  -H "Content-Type: application/json" \
  --header "Authorization: Bearer $TOKEN" \
  -d '{
    "requests": [
      {
        "parent": "customers/$CUSTOMER",
        "printServer": {
          "displayName": "General print server",
          "description": "Org-wide print queue",
          "uri": "ipp://192.168.10.15",
          "orgUnitId": "04fatzly26exj7b"
        }
    },
    {
        "parent": "customers/$CUSTOMER",
        "printServer": {
          "displayName": "Eng print server",
          "description": "Print server for Eng use only",
          "uri": "ipp://192.168.10.16",
          "orgUnitId": "04fatzly26exj7b"
        }
    }
  ]
  }' \
  "https://admin.googleapis.com/admin/directory/v1/customers/$CUSTOMER/chrome/printServers:batchCreatePrintServers"

คำตอบ

{
  "printServers": [
    {
      "name": "customers/C0234nab1/chrome/printServers/0gjdgxs0sbbh87",
      "id": "0gjdgxs0sbbh87",
      "displayName": "General print server",
      "description": "Org-wide print queue",
      "uri": "ipp://192.168.10.15",
      "createTime": "2021-03-12T01:10:32.957084Z",
      "orgUnitId": "04fatzly26exj7b"
    },
    {
      "name": "customers/C0234nab1/chrome/printServers/0gjdgxs2d6170e",
      "id": "0gjdgxs2d6170e",
      "displayName": "Eng print server",
      "description": "Print server for Eng use only",
      "uri": "ipp://192.168.10.16",
      "createTime": "2021-03-12T01:10:32.956735Z",
      "orgUnitId": "04fatzly26exj7b"
    }
  ]
}

ลบเซิร์ฟเวอร์การพิมพ์หลายรายการในคำขอเดียว

ตัวอย่างนี้จะลบเซิร์ฟเวอร์การพิมพ์หลายรายการในคําขอเดียวโดยใช้วิธี batchDeletePrintServers

ส่งคำขอ

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

คำตอบ

{
  "printServerIds": [ // Successfully deleted print servers.
    "0gjdgxs2d6170e",
    "0gjdgxs0sbbh87"
  ]
}