Resources.calendars: list

Requires authorization

Retrieves a list of calendar resources for an account. Try it now.


HTTP request



Parameter name Value Description
Path parameters
customer string The unique ID for the customer's G Suite account. As an account administrator, you can also use the my_customer alias to represent your account's customer ID.
Optional query parameters
maxResults integer Maximum number of results to return. Acceptable values are 1 to 500, inclusive.
orderBy string Field(s) to sort results by in either ascending or descending order. Supported fields include resourceId, resourceName, capacity, buildingId, and floorName. If no order is specified, defaults to ascending. Should be of the form "field [asc|desc], field [asc|desc], ...". For example buildingId, capacity desc would return results sorted first by buildingId in ascending order then by capacity in descending order.
pageToken string Token to specify the next page in the list.
query string String query used to filter results. Should be of the form "field operator value" where field can be any of supported fields and operators can be any of supported operations. Operators include '=' for exact match and ':' for prefix match or HAS match where applicable. For prefix match, the value should always be followed by a *. Supported fields include generatedResourceName, name, buildingId, For example buildingId=US-NYC-9TH AND


This request requires authorization with at least one of the following scopes (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "admin#directory#resources#calendars#calendarResourcesList",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    resources.calendars Resource
Property name Value Description Notes
kind string Identifies this as a collection of CalendarResources. This is always admin#directory#resources#calendars#calendarResourcesList.
etag etag ETag of the resource.
nextPageToken string The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
items[] list The CalendarResources in this page of results.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.