Method: users.spaces.spaceNotificationSetting.get
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/spaceNotificationSetting}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. Format: users/{user}/spaces/{space}/spaceNotificationSetting
users/me/spaces/{space}/spaceNotificationSetting, ORusers/user@example.com/spaces/{space}/spaceNotificationSetting, ORusers/123456789/spaces/{space}/spaceNotificationSetting. Note: Only the caller's user id or email is allowed in the path.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of SpaceNotificationSetting.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chat.users.spacesettings
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.
[null,null,["Last updated 2025-05-07 UTC."],[[["\u003cp\u003eRetrieves the notification settings for a specific Google Chat space for the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the user and space identifiers in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003eSpaceNotificationSetting\u003c/code\u003e object containing the space's notification configuration details upon successful execution.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chat.users.spacesettings\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eAvailable as part of the Google Workspace Developer Preview Program.\u003c/p\u003e\n"]]],["This document details how to retrieve space notification settings via an HTTP GET request. The request URL, `https://chat.googleapis.com/v1/{name=users/*/spaces/*/spaceNotificationSetting}`, uses gRPC Transcoding, requiring a `name` path parameter specifying the user and space. The request body must be empty. A successful request returns a `SpaceNotificationSetting` instance, and requires user authentication and the `https://www.googleapis.com/auth/chat.users.spacesettings` OAuth scope. This feature is part of the Google Workspace Developer Preview Program.\n"],null,["# Method: users.spaces.spaceNotificationSetting.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\nGets the space notification setting. For an example, see [Get the caller's space notification setting](https://developers.google.com/workspace/chat/get-space-notification-setting).\n\nRequires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):\n\n- `https://www.googleapis.com/auth/chat.users.spacesettings`\n\n### HTTP request\n\n`GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/spaceNotificationSetting}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Format: users/{user}/spaces/{space}/spaceNotificationSetting - `users/me/spaces/{space}/spaceNotificationSetting`, OR - `users/user@example.com/spaces/{space}/spaceNotificationSetting`, OR - `users/123456789/spaces/{space}/spaceNotificationSetting`. Note: Only the caller's user id or email is allowed in the path. |\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 [SpaceNotificationSetting](/workspace/chat/api/reference/rest/v1/users.spaces.spaceNotificationSetting#SpaceNotificationSetting).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chat.users.spacesettings`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
