# REST Resource: admin.directory.v1.customers.chrome.printers

## Resource: Printer

Printer configuration.

| JSON representation |
|---|
| ``` { "name": string, "id": string, "displayName": string, "description": string, "makeAndModel": string, "uri": string, "createTime": string, "orgUnitId": string, "auxiliaryMessages": [ { object (`https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#AuxiliaryMessage`) } ], "useDriverlessConfig": boolean } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the Printer object, in the format customers/{customer-id}/printers/{printer-id} (During printer creation leave empty) |
| `id` | `string` Id of the printer. (During printer creation leave empty) |
| `displayName` | `string` Editable. Name of printer. |
| `description` | `string` Editable. Description of printer. |
| `makeAndModel` | `string` Editable. Make and model of printer. e.g. Lexmark MS610de Value must be in format as seen in printers.listPrinterModels response. |
| `uri` | `string` Editable. Printer URI. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Time when printer was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `orgUnitId` | `string` Organization Unit that owns this printer (Only can be set during Printer creation) |
| `auxiliaryMessages[]` | ``object (`https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#AuxiliaryMessage`)`` Output only. Auxiliary messages about issues with the printer configuration if any. |
| `useDriverlessConfig` | `boolean` Editable. flag to use driverless configuration or not. If it's set to be true, makeAndModel can be ignored |

## AuxiliaryMessage

Auxiliary message about issues with printers or settings. Example: {messageType:AUXILIARY_MESSAGE_WARNING, fieldMask:makeAndModel, message:"Given printer is invalid or no longer supported."}

| JSON representation |
|---|
| ``` { "severity": enum (`https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Severity`), "fieldMask": string, "auxiliaryMessage": string } ``` |

| Fields ||
|---|---|
| `severity` | ``enum (`https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Severity`)`` Message severity |
| `fieldMask` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#field-mask` format)`` Field that this message concerns. This is a comma-separated list of fully qualified names of fields. Example: `"user.displayName,photo"`. |
| `auxiliaryMessage` | `string` Human readable message in English. Example: "Given printer is invalid or no longer supported." |

## Severity

Auxiliary message severity

| Enums ||
|---|---|
| `SEVERITY_UNSPECIFIED` | Message type unspecified. |
| `SEVERITY_INFO` | Message of severity: info. |
| `SEVERITY_WARNING` | Message of severity: warning. |
| `SEVERITY_ERROR` | Message of severity: error. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/batchCreatePrinters` | Creates printers under given Organization Unit. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/batchDeletePrinters` | Deletes printers in batch. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/create` | Creates a printer under given Organization Unit. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/delete` | Deletes a `Printer`. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/get` | Returns a `Printer` resource (printer's config). |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/list` | List printers configs. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/listPrinterModels` | Lists the supported printer models. |
| ### `https://developers.google.com/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers/patch` | Updates a `Printer` resource. |