Method: resources.calendars.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アカウントのカレンダー リソースのリストを取得します。
HTTP リクエスト
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
customer |
string
お客様の Google Workspace アカウントの一意の ID。アカウント管理者は、アカウントのお客様 ID を表す my_customer エイリアスを使用することもできます。
|
クエリ パラメータ
パラメータ |
maxResults |
integer
返される結果の最大数。
|
orderBy |
string
結果の並べ替え基準として使用するフィールド(昇順または降順)。サポートされているフィールドには、resourceId 、resourceName 、capacity 、buildingId 、floorName があります。順序が指定されていない場合、デフォルトは昇順です。「フィールド [昇順|降順]、フィールド [昇順|降順]、...」の形式にする必要があります。たとえば、buildingId,
capacity desc は、まず buildingId で昇順に、次に capacity で降順に並べ替えられた結果を返します。
|
pageToken |
string
リストの次のページを指定するトークン。
|
query |
string
結果のフィルタリングに使用される文字列クエリ。「フィールド演算子値」の形式にする必要があります。フィールドはサポートされているフィールドのいずれか、演算子はサポートされているオペレーションのいずれかです。演算子には、完全一致の場合は「=」、不一致の場合は「!=」、接頭辞一致または HAS 一致の場合は「:」が含まれます。接頭辞一致の場合、値の末尾には常に * を付ける必要があります。論理演算子 NOT と AND がサポートされています(優先順位は上記の順序です)。サポートされているフィールドは、generatedResourceName 、name 、buildingId 、floorName 、capacity 、featureInstances.feature.name 、resourceEmail 、resourceCategory です。例: buildingId=US-NYC-9TH AND
featureInstances.feature.name:Phone 。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
公開 API: Resources.calendars
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource )
}
],
"nextPageToken": string
} |
フィールド |
kind |
string
CalendarResources のコレクションであることを示します。これは常に admin#directory#resources#calendars#calendarResourcesList です。
|
etag |
string
リソースの ETag。
|
items[] |
object (CalendarResource )
この結果ページの CalendarResources。
|
nextPageToken |
string
大量の結果セットのページ割り付けに使用する、継続トークンです。次の結果ページを返すには、この値を次のリクエストに設定します。
|
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://apps-apis.google.com/a/feeds/calendar/resource/
https://www.googleapis.com/auth/admin.directory.resource.calendar
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: resources.calendars.list\n\nRetrieves a list of calendar resources for an account.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's customer ID. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of results to return. |\n| `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. |\n| `pageToken` | `string` Token to specify the next page in the list. |\n| `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, '!=' for mismatch and ':' for prefix match or HAS match where applicable. For prefix match, the value should always be followed by a \\*. Logical operators NOT and AND are supported (in this order of precedence). Supported fields include `generatedResourceName`, `name`, `buildingId`, `floorName`, `capacity`, `featureInstances.feature.name`, `resourceEmail`, `resourceCategory`. For example `buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nPublic API: Resources.calendars\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"items\": [ { object (/workspace/admin/directory/reference/rest/v1/resources.calendars#CalendarResource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies this as a collection of CalendarResources. This is always `admin#directory#resources#calendars#calendarResourcesList`. |\n| `etag` | `string` ETag of the resource. |\n| `items[]` | `object (`[CalendarResource](/workspace/admin/directory/reference/rest/v1/resources.calendars#CalendarResource)`)` The CalendarResources in this page of results. |\n| `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. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://apps-apis.google.com/a/feeds/calendar/resource/`\n- `\n https://www.googleapis.com/auth/admin.directory.resource.calendar`\n- `\n https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]