Method: resources.buildings.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
فهرستی از ساختمان ها را برای یک حساب کاربری بازیابی می کند.
درخواست HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/buildings
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
customer | string شناسه منحصر به فرد برای حساب Google Workspace مشتری. به عنوان مدیر حساب، می توانید از نام مستعار my_customer نیز برای نشان دادن شناسه مشتری حساب خود استفاده کنید. |
پارامترهای پرس و جو
پارامترها |
---|
maxResults | integer حداکثر تعداد نتایج برای بازگشت. |
pageToken | string رمزی برای مشخص کردن صفحه بعدی در لیست. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
Public API: Resources.buildings
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"kind": string,
"etag": string,
"buildings": [
{
object (Building )
}
],
"nextPageToken": string
} |
فیلدها |
---|
kind | string نوعی منبع این است. |
etag | string ETag منبع |
buildings[] | object ( Building ) ساختمان ها در این صفحه از نتایج. |
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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: resources.buildings.list\n\nRetrieves a list of buildings for an account.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/buildings`\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| `pageToken` | `string` Token to specify the next page in the list. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nPublic API: Resources.buildings\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"buildings\": [ { object (/workspace/admin/directory/reference/rest/v1/resources.buildings#Building) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Kind of resource this is. |\n| `etag` | `string` ETag of the resource. |\n| `buildings[]` | `object (`[Building](/workspace/admin/directory/reference/rest/v1/resources.buildings#Building)`)` The Buildings 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)."]]