Method: spaces.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض تفاصيل عن مساحة على سبيل المثال، يُرجى الاطّلاع على الحصول على تفاصيل عن مساحة.
تتوافق مع أنواع المصادقة التالية:
تفرض مصادقة التطبيقات القيود التالية:
- لا تتم تعبئة
space.access_settings إلا عند استخدام نطاق chat.app.spaces.
- لا تتم تعبئة
space.predefind_permission_settings وspace.permission_settings إلا عند استخدام نطاق chat.app.spaces، ولا تتم تعبئتهما إلا للمساحات التي أنشأها التطبيق.
طلب HTTP
GET https://chat.googleapis.com/v1/{name=spaces/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم مورد المساحة، بالتنسيق spaces/{space} التنسيق: spaces/{space}
|
مَعلمات طلب البحث
| المعلمات |
useAdminAccess |
boolean
اختياريّ. عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاقات OAuth 2.0 chat.admin.spaces أو chat.admin.spaces.readonly.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Space.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.admin.spaceshttps://www.googleapis.com/auth/chat.admin.spaces.readonlyhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.bothttps://www.googleapis.com/auth/chat.app.spaces
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eReturns detailed information about a Google Chat space, including its properties and settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires a specific HTTP request structure using the space's resource name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eOffers optional use of administrator privileges via a query parameter for authorized users.\u003c/p\u003e\n"],["\u003cp\u003eSupports various authentication methods, including app and user authentication with specific OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eProvides a comprehensive response containing details about the space upon successful execution.\u003c/p\u003e\n"]]],["This describes retrieving details about a space using a `GET` request to `https://chat.googleapis.com/v1/{name=spaces/*}`. The space's resource name is a required path parameter. Optional `useAdminAccess` query parameter allows execution with admin privileges. The request body is empty. A successful response returns a Space object. Authentication requires specific OAuth scopes, and it supports both App and User authentication, including admin access. The request also contains an ability to test the request directly.\n"],null,["# Method: spaces.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces).\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.bot`\n - `https://www.googleapis.com/auth/chat.app.spaces` with [administrator approval](https://support.google.com/a?p=chat-app-auth)\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.spaces.readonly`\n - `https://www.googleapis.com/auth/chat.spaces`\n - User authentication grants administrator privileges when an administrator account authenticates, `useAdminAccess` is `true`, and one of the following authorization scopes is used:\n - `https://www.googleapis.com/auth/chat.admin.spaces.readonly`\n - `https://www.googleapis.com/auth/chat.admin.spaces`\n\nApp authentication has the following limitations:\n\n- `space.access_settings` is only populated when using the `chat.app.spaces` scope.\n- `space.predefind_permission_settings` and `space.permission_settings` are only populated when using the `chat.app.spaces` scope, and only for spaces the app created.\n\n### HTTP request\n\n`GET https://chat.googleapis.com/v1/{name=spaces/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}` |\n\n### Query parameters\n\n| Parameters ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `useAdminAccess` | `boolean` Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Space](/workspace/chat/api/reference/rest/v1/spaces#Space).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.admin.spaces`\n- `https://www.googleapis.com/auth/chat.admin.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.spaces`\n- `https://www.googleapis.com/auth/chat.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.bot`\n- `https://www.googleapis.com/auth/chat.app.spaces`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
