Method: spaces.spaceEvents.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض حدث من مساحة Google Chat تحتوي حمولة الحدث على أحدث إصدار من المورد الذي تغيّر. على سبيل المثال، إذا طلبت حدثًا بشأن رسالة جديدة ولكن تم تعديل الرسالة لاحقًا، يعرض الخادم مورد Message المعدَّل في حمولة الحدث.
ملاحظة: لا يتم عرض الحقل permissionSettings في عنصر Space ضمن بيانات حدث Space لهذا الطلب.
تتطلّب مصادقة المستخدم باستخدام نطاق تفويض مناسب لقراءة البيانات المطلوبة:
https://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.messageshttps://www.googleapis.com/auth/chat.messages.reactions.readonlyhttps://www.googleapis.com/auth/chat.messages.reactionshttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.memberships
للحصول على حدث، يجب أن يكون المستخدم الذي تمّت مصادقة هويته عضوًا في المساحة.
على سبيل المثال، راجِع مقالة الحصول على تفاصيل عن حدث من مساحة في Google Chat.
طلب HTTP
GET https://chat.googleapis.com/v1/{name=spaces/*/spaceEvents/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم المورد لحدث المساحة التنسيق: spaces/{space}/spaceEvents/{spaceEvent}
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SpaceEvent.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.messageshttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.messages.reactionshttps://www.googleapis.com/auth/chat.messages.reactions.readonly
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis request returns an event from a Google Chat space, providing the most recent version of the changed resource in the payload.\u003c/p\u003e\n"],["\u003cp\u003eTo get an event, the authenticated user must be a member of the space and use the \u003ccode\u003eGET\u003c/code\u003e method with the specified URL structure.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response returns a \u003ccode\u003eSpaceEvent\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eThis action requires specific OAuth scopes related to Google Chat spaces, messages, memberships, and reactions for authorization.\u003c/p\u003e\n"]]],["This describes retrieving a Google Chat space event using a `GET` request to `https://chat.googleapis.com/v1/{name=spaces/*/spaceEvents/*}`. The `name` path parameter, in the format `spaces/{space}/spaceEvents/{spaceEvent}`, is required. The request body must be empty. Successful requests return a `SpaceEvent` instance, containing the resource's latest version. Authentication requires specific OAuth scopes, and the user must be a space member. The event payload details any resource changes within the space.\n"],null,["# Method: spaces.spaceEvents.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_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 an event from a Google Chat space. The [event payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the resource that changed. For example, if you request an event about a new message but the message was later updated, the server returns the updated `Message` resource in the event payload.\n\nNote: The `permissionSettings` field is not returned in the Space object of the Space event data for this request.\n\nRequires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with an [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes) appropriate for reading the requested data:\n\n- `https://www.googleapis.com/auth/chat.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.spaces`\n- `https://www.googleapis.com/auth/chat.messages.readonly`\n- `https://www.googleapis.com/auth/chat.messages`\n- `https://www.googleapis.com/auth/chat.messages.reactions.readonly`\n- `https://www.googleapis.com/auth/chat.messages.reactions`\n- `https://www.googleapis.com/auth/chat.memberships.readonly`\n- `https://www.googleapis.com/auth/chat.memberships`\n\nTo get an event, the authenticated user must be a member of the space.\n\nFor an example, see [Get details about an event from a Google Chat space](https://developers.google.com/workspace/chat/get-space-event).\n\n### HTTP request\n\n`GET https://chat.googleapis.com/v1/{name=spaces/*/spaceEvents/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name of the space event. Format: `spaces/{space}/spaceEvents/{spaceEvent}` |\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 [SpaceEvent](/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.spaces`\n- `https://www.googleapis.com/auth/chat.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.messages`\n- `https://www.googleapis.com/auth/chat.messages.readonly`\n- `https://www.googleapis.com/auth/chat.memberships`\n- `https://www.googleapis.com/auth/chat.memberships.readonly`\n- `https://www.googleapis.com/auth/chat.messages.reactions`\n- `https://www.googleapis.com/auth/chat.messages.reactions.readonly`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
