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. 

  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 and then Directoryand thenBuildings and resourcesand thenOverview.
  3. In the Resource management section, click Open.
  4. At the bottom of the page, click Manage Buildings.  
  5. Point to and click Add  Add new building.
  6. 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
  7. 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

  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 and then Directoryand thenBuildings and resourcesand thenOverview.
  3. In the Resource management section, click Open.
  4. At the bottom of the page, click Manage buildings.
  5. Point to Add   and click Upload  Bulk upload buildings.
  6. Click Attach CSV and follow the steps to attach the CSV file.
  7. 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 

For details, go to resources.buildings and Format 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. 

  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 and then Directoryand thenBuildings and resourcesand thenOverview.
  3. In the Resource management section, click Open.
  4. Click Manage  Manage resource features
  5. Click Add Feature.
  6. 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)
  7. Click Save.

After you add a feature, you can add it to a resource by clicking on the resourceand thenFeatures. 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. 

  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 and then Directoryand thenBuildings and resourcesand thenOverview.
  3. In the Resource management section, click Open.
  4. Point to and click Add   .
  5. 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. 
  6. Click Add Resources.

 For details on the fields, go to Format for bulk updates on this page.

Upload resources via CSV in bulk

  1. 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 and then Directoryand thenBuildings and resourcesand thenOverview.
    3. In the Resource management section, click Open.
    4. Click Download   .
    5. Save the CSV file.
  2. Import CSV information into a spreadsheet.
    1. Open a blank Google Sheet and go to Fileand thenImport
    2. Navigate to the downloaded CSV fileand thenclick Select
    3. In the Import window, make your selectionsand thenclick Import data.
  3. 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.
  4. 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 and then Directoryand thenBuildings and resourcesand thenOverview.
    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.

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

  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 and then Directoryand thenBuildings and resourcesand thenOverview.
  3. In the Resource management section, click Open.
  4. Select the resources that you want to edit.
  5. In the top right corner, click Edit and select Edit organizational unit.
  6. Select the organizational unit that you want to assign to these resources and click Continue.
  7. 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 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. 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

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?
Search
Clear search
Close search
Google apps
Main menu
330191026145589143
true
Search Help Center
true
true
true
true
true
73010
false
false