Create buildings, features & Calendar resources

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:
1. Click Edit Edit address.
2. 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.
3. 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.
4. 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, see below: Format for bulk updates.

Use the API for bulk building updates

For details, see resources.buildings and Formats for bulk 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, see 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, see below: Format for bulk updates.

Upload resources via CSV in bulk

Download to a CSV from the admin console.
1. Sign in to your Google Admin console.
  Sign in using your administrator account (does not end in @gmail.com).
2. In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
3. In the Resource management section, click Open.
4. Click Download .
5. Save the CSV file.
Import CSV information into a spreadsheet.
1. Open a blank Google Sheet and go to File > Import.
2. Navigate to the downloaded CSV file, and click Select.
3. In the Import window, make your selections and click Import data.
Edit resources in a spreadsheet.
1. Use the spreadsheet you create in the previous steps above.
2. 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.
3. When editing is complete, save the spreadsheet as a CSV file.
Upload a CSV after editing.
1. Sign in to your Google Admin console.
  Sign in using your administrator account (does not end in @gmail.com).
2. In the Admin console, go to Menu DirectoryBuildings and resourcesOverview.
3. In the Resource management section, click Open.
4. Point to Add and click Upload Bulk upload resources.
5. Click Attach CSV and follow the prompts to attach the CSV file.
6. 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

Format for bulk updates

These tables help you update Calendar resources using an API or CSV spreadsheet.

Format for buildings

Use 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. See Format for building addresses.	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

Format for building addresses

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

Format for resources and features

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 [email protected] has booking rights to the room East side building
#Feature	Features are attributes or equipment of a room or resource, such as: Audio features: #Phone Video features: #VC, #Cisco conferencing unit. Other features: #Whiteboard, #Wheelchair accessible, #External guests.	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

Was this helpful?

How can we improve it?