Method: resources.calendars.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir hesaptaki takvim kaynaklarının listesini alır.
HTTP isteği
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
customer |
string
Müşterinin Google Workspace hesabının benzersiz kimliği. Hesap yöneticisi olarak, hesabınızın müşteri kimliğini temsil etmek için my_customer takma adını da kullanabilirsiniz.
|
Sorgu parametreleri
| Parametreler |
maxResults |
integer
Döndürülecek maksimum sonuç sayısı.
|
orderBy |
string
Sonuçları artan veya azalan düzende sıralamak için kullanılacak alanlar. Desteklenen alanlar resourceId, resourceName, capacity, buildingId ve floorName'dir. Sıralama belirtilmezse varsayılan olarak artan değer kullanılır. "alan [artan|azalan], alan [artan|azalan], ..." biçiminde olmalıdır. Örneğin buildingId,
capacity desc, sonuçları önce buildingId'a göre artan düzende, ardından capacity'ye göre azalan düzende sıralayarak döndürür.
|
pageToken |
string
Listede sonraki sayfayı belirtmek için kullanılan jeton.
|
query |
string
Sonuçları filtrelemek için kullanılan dize sorgusu. "alan operatör değer" biçiminde olmalıdır. Alan, desteklenen alanlardan herhangi biri, operatör ise desteklenen işlemlerden herhangi biri olabilir. Operatörler arasında tam eşleşme için "=', eşleşmeme için "!=' ve uygun olduğunda önek eşleşmesi veya HAS eşleşmesi için ":' bulunur. Önek eşleşmesi için değerin her zaman ardından bir * işareti gelmelidir. NOT ve VE mantıksal operatörleri desteklenir (bu öncelik sırasına göre). Desteklenen alanlar: generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail, resourceCategory. Örneğin buildingId=US-NYC-9TH AND
featureInstances.feature.name:Phone.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Herkese açık API: Resources.calendars
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource)
}
],
"nextPageToken": string
} |
| Alanlar |
kind |
string
Bunu bir CalendarResources koleksiyonu olarak tanımlar. Bu değer her zaman admin#directory#resources#calendars#calendarResourcesList olur.
|
etag |
string
Kaynağın ETag'i.
|
items[] |
object (CalendarResource)
Bu sonuç sayfasındaki CalendarResources.
|
nextPageToken |
string
Büyük sonuç kümelerinde sayfalama yapmak için kullanılan devam jetonu. Sonuçların bir sonraki sayfasını döndürmek için sonraki bir isteğinde bu değeri sağlayın.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
