# REST Resource: resources.calendars

## Resource: CalendarResource

Public API: Resources.calendars

| JSON representation |
|---|
| ``` { "kind": string, "etags": string, "resourceName": string, "resourceDescription": string, "resourceType": string, "resourceEmail": string, "resourceCategory": string, "userVisibleDescription": string, "generatedResourceName": string, "featureInstances": value, "resourceId": string, "capacity": integer, "floorName": string, "buildingId": string, "floorSection": string } ``` |

| Fields ||
|---|---|
| `kind` | `string` The type of the resource. For calendar resources, the value is `admin#directory#resources#calendars#CalendarResource`. |
| `etags` | `string` ETag of the resource. |
| `resourceName` | `string` The name of the calendar resource. For example, "Training Room 1A". |
| `resourceDescription` | `string` Description of the resource, visible only to admins. |
| `resourceType` | `string` The type of the calendar resource, intended for non-room resources. |
| `resourceEmail` | `string` The read-only email for the calendar resource. Generated as part of creating a new calendar resource. |
| `resourceCategory` | `string` The category of the calendar resource. Either CONFERENCE_ROOM or OTHER. Legacy data is set to CATEGORY_UNKNOWN. |
| `userVisibleDescription` | `string` Description of the resource, visible to users and admins. |
| `generatedResourceName` | `string` The read-only auto-generated name of the calendar resource which includes metadata about the resource such as building name, floor, capacity, etc. For example, "NYC-2-Training Room 1A (16)". |
| `featureInstances` | ``value (`https://protobuf.dev/reference/protobuf/google.protobuf#value` format)`` Instances of features for the calendar resource. |
| `resourceId` | `string` The unique ID for the calendar resource. |
| `capacity` | `integer` Capacity of a resource, number of seats in a room. |
| `floorName` | `string` Name of the floor a resource is located on. |
| `buildingId` | `string` Unique ID for the building a resource is located in. |
| `floorSection` | `string` Name of the section within a floor a resource is located in. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/delete` | Deletes a calendar resource. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/get` | Retrieves a calendar resource. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/insert` | Inserts a calendar resource. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/list` | Retrieves a list of calendar resources for an account. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/patch` | Patches a calendar resource. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/resources.calendars/update` | Updates a calendar resource. |