Set up Calendar so users can book shared resources, such as rooms, projectors, company cars, or bicycles. To make it easy for your employees to find and book the resources they need, it is best practice to add as much detail as possible. Your users will see details like the building and floor where a room or resource is located, and the key features, such as video conferencing equipment or whiteboards.
Step 1: Add buildings
Start by listing all the buildings in your company. Google Calendar uses buildings as the foundation for all your resources.
Note: Building addresses are not used for map navigation.
Add a building in the Admin console
You can create up to 10,000 buildings for your company or in each domain.
Add the required fields now. You can come back and fill in the optional fields later.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- At the bottom of the page, click Manage Buildings.
- Point to and click Add Add new building.
- Enter the building information.
To add the address:
- Click Edit Edit address.
-
Enter the address information for each location using the official postal address format for its region. The Google map panel on the right shows a pin at the address. Addresses associated with a known business location will be stored using the local language. Note: Building addresses are not used for map navigation.
- If needed, drag the pin to the best or correct location. We recommend that you place the pin at the center of the building's rooftop. The latitude and longitude fields appear.
- Click Done.
- Click Add Building.
Add buildings in bulk
You can create up to 10,000 buildings for your company or in each domain.
To save time, upload all or multiple buildings in your domain.
Upload your spreadsheet
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
-
In the Resource management section, click Open.
-
At the bottom of the page, click Manage buildings.
- Point to Add and click Upload Bulk upload buildings.
- Click Attach CSV and follow the steps to attach the CSV file.
- Click Upload.
To view the required fields and descriptions, go to Format for bulk updates on this page.
Use the API for bulk building updates
Step 2: Add audio, video, or other features
If you want people to know what equipment or other features come with a room or other resource, add them using the Admin console. For example, you might want to let people know which rooms have a Jamboard, or which company cars have a navigation system.
Note: To add features, use the Admin console or API. You can't add features by uploading feature details in a CSV file.
Add features one by one in Admin console
You can create up to 100 features for your company or in each domain.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- Click Manage Manage resource features.
- Click Add Feature.
- Enter the feature name and choose the type:
- Other: Not videoconferencing or telephony (for example, Whiteboard, Wheelchair accessible, or External guests)
- Videoconferencing: Video communication equipment (for example, VC or Cisco conferencing unit)
- Telephony: Audio communication equipment (for example, phone)
- Click Save.
After you add a feature, you can add it to a resource by clicking on the resourceFeatures. Users can search for and add features to the selected resource.
API bulk updates for Calendar features
You can create up to 100 features for your company or in each domain.
For details, go to resources.features and Format for bulk updates.
Step 3: Add resources
Next, add anything people can reserve: conference rooms, company cars, mother's rooms, or whatever your company provides for workers. If you created features in step 2, you can associate them with the resources as you add them.
Note: Resources are typically available within a few minutes of being added. In some cases, however, it might take up to 24 hours for them to become available in everyone's calendar.
Add resources one by one in the Admin console
You can add up to 10,000 resources for your company or in each domain.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- Point to and click Add .
- Enter the resource information. Select one of these types:
- Conference room: Resources used for meetings or conferences that can be as small as a phone room.
- Other: Resources that aren’t used for meetings. For example, a bicycle or company car.
- Click Add Resources.
For details on the fields, go to Format for bulk updates on this page.
Upload resources via CSV in bulk
- Download to a CSV from the admin console.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- Click Download .
- Save the CSV file.
-
- Import CSV information into a spreadsheet.
- Open a blank Google Sheet and go to FileImport.
- Navigate to the downloaded CSV fileclick Select.
- In the Import window, make your selectionsclick Import data.
- Edit resources in a spreadsheet.
- Use the spreadsheet you create in the previous steps above.
- Edit the fields as needed.
Update the fields according to the tables in Format for bulk updates. Don’t modify the resource ID. If you do, a brand new resource will be created instead of updating the existing one.
- When editing is complete, save the spreadsheet as a CSV file.
- Upload a CSV after editing.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- Point to Add and click Upload Bulk upload resources.
- Click Attach CSV and follow the prompts to attach the CSV file.
- Click Upload.
-
API bulk updates for Calendar resources
You can add up to 10,000 resources for your company or in each domain.
For details, see resources.calendars and Format for bulk updates.
Step 4: Configure organizational units
This feature is only available to Google Workspace Enterprise Plus and Assured Controls editions.
You can assign resources to a specific organizational unit so that the event data in the resource calendar inherits the data policies of that organizational unit, including its data regions policy. The resource metadata, such as its name, description, or building continue to follow the root organization data policies. Learn more about organizational units.
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
- In the Resource management section, click Open.
- Select the resources that you want to edit.
- In the top right corner, click Edit and select Edit organizational unit.
- Select the organizational unit that you want to assign to these resources and click Continue.
- In the confirmation dialog, click Change.
Note: This feature requires the Admin privilegeto read organizational units.
Format for bulk updates
These tables help you update Calendar resources using an API or CSV spreadsheet.
Format for buildingsUse this format for buildings you create in Calendar.
Property name | Description | Example |
---|---|---|
Building Id* | This Building ID must match exactly the Building ID defined for the building. | SF-MAIN |
Building Name | Display name for the building | San Francisco HQ |
Address* | Address information for buildings. For details, go to Format for building addresses on this page. | 678 Lafayette Ave Suite 2B Graha Bumi Surabaya Lt. V Jl. Basuki Rahmat no.106 - 128 雨竜郡秩父別町秩父別4105 |
Floors* | Should be separated by commas and list in ascending order from lower to upper. | Lobby, M, 2, 3, 4, 5, 5A, 6 |
Description | Optional description of your building that is visible on the Admin console for your reference. | East side building |
Coordinates |
Latitude and longitude of a building |
40.730610, -73.935242 |
* Required
Use this format for the building address information. Enter the address information for each location using the official postal address format for its region. Depending on the region, address formats can vary widely.
The fields in the Admin console and other applications used for entering address data are error-resistant. You can include things like switched fields, omit a field, or even add an extra field, and the process will not fail. Calendar will notify you about any problems and tell you how to correct the issue.
Property name | Description | Example |
---|---|---|
Address lines 1-5* |
The street name and number or the description of the location.
|
200 Second St. |
Sub-locality |
The neighborhood, district, townland, village, and so on. Smaller than city or locality. (not required, only helpful in some countries) |
SOMA (South of Market) |
Locality | The city, can be referred to as district and suburb depending on country. | San Francisco |
Administrative Area | The state, province, island, county, depending on country. | California |
Postal code |
Sometimes called ZIP code, Pincode, or Eircode. |
94105 |
Country or region* |
The full name or 2-letter code for the country or region
|
US |
* Required
Use this format for resource and feature information.
Property name | Description | Example |
---|---|---|
Resource Id* |
The unique room identifier Google generates for you when you create a resource. Resource ID is only required when updating resources. When creating new resources, you can leave this field empty to generate the ID automatically. (don't edit or remove for existing resources) |
28AF38E |
Resource Name* |
Short room name. (suggested maximum character limit 45) |
Beehive room |
Building Id* | This Building ID must match exactly the Building ID defined for the building where the resource is located. | SF-MAIN |
Resource Category* |
Conference room: Resources that are used for meetings or conferences that can be as small as a phone room. Other: Resources that aren’t used for meetings. For example, a Jamboard, bicycle, or company car. Category unknown: Resources that don’t conform to the structure format (for new resources, use Conference room and Other) |
CONFERENCE_ROOM |
Resource Type | Existing field. When the Resource category is set to Other, this field is added as a prefix to the autogenerated name and helps distinguish non-rooms from rooms. It also helps categorize the resource type. For example: Bike, Vehicle, Mother’s room, or Microscope. | Bike |
Floor Name* |
The floor name must match one of the floors defined in the building. (suggested maximum character limit 15) |
10 |
Capacity* | Recommended number of people for the room. Must be a positive integer. | 4 |
Floor Section |
Indicates where on the floor a room is located. (suggested maximum character limit 15) |
A |
User Visible Description | Free-form description of the room that is visible to users in the room details. Note: This description is only displayed while booking the resource. After selecting the resource or saving an event, this description is no longer displayed. | Phone extension #4119 |
Description | Optional description of your room or resource that is visible on the Admin console for your reference. |
Every member of room-admins@example.com has booking rights to the room East side building |
#Feature |
Features are attributes or equipment of a room or resource, such as:
|
TRUE |
Autogenerated name |
Read-only. This is generated when the resource category is set either to Conference_room or Other. The autogenerated name is in this format: Building Name-Floor Name-Floor Section-Resource Name (capacity) [Features] |
San Francisco HQ-10-A-Beehive Room (4) [VC] |
* Required for structured resources and features