HangoutsChat.Spaces (Google Chat API v1-rev20260405-2.0.0)

java.lang.Object
- com.google.api.services.chat.v1.HangoutsChat.Spaces

Enclosing class:

HangoutsChat
```
public class HangoutsChat.Spaces
extends Object
```
The "spaces" collection of methods.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`HangoutsChat.Spaces.CompleteImport`
`class`	`HangoutsChat.Spaces.Create`
`class`	`HangoutsChat.Spaces.Delete`
`class`	`HangoutsChat.Spaces.FindDirectMessage`
`class`	`HangoutsChat.Spaces.FindGroupChats`
`class`	`HangoutsChat.Spaces.Get`
`class`	`HangoutsChat.Spaces.List`
`class`	`HangoutsChat.Spaces.Members` The "members" collection of methods.
`class`	`HangoutsChat.Spaces.Messages` The "messages" collection of methods.
`class`	`HangoutsChat.Spaces.Patch`
`class`	`HangoutsChat.Spaces.Search`
`class`	`HangoutsChat.Spaces.Setup`
`class`	`HangoutsChat.Spaces.SpaceEvents` The "spaceEvents" collection of methods.

Constructor Summary

Constructors
Constructor and Description

Spaces()

Constructors
Constructor and Description
`Spaces()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`HangoutsChat.Spaces.CompleteImport`	`completeImport(String name, CompleteImportSpaceRequest content)` Completes the [import process](https://developers.google.com/workspace/chat/import-data) for the specified space and makes it visible to users.
`HangoutsChat.Spaces.Create`	`create(Space content)` Creates a space.
`HangoutsChat.Spaces.Delete`	`delete(String name)` Deletes a named space.
`HangoutsChat.Spaces.FindDirectMessage`	`findDirectMessage()` Returns the existing direct message with the specified user.
`HangoutsChat.Spaces.FindGroupChats`	`findGroupChats()` [Developer Preview](https://developers.google.com/workspace/preview): Returns all spaces with `spaceType == GROUP_CHAT`, whose human memberships contain exactly the calling user, and the users specified in `FindGroupChatsRequest.users`.
`HangoutsChat.Spaces.Get`	`get(String name)` Returns details about a space.
`HangoutsChat.Spaces.List`	`list()` Lists spaces the caller is a member of.
`HangoutsChat.Spaces.Members`	`members()` An accessor for creating requests from the Members collection.
`HangoutsChat.Spaces.Messages`	`messages()` An accessor for creating requests from the Messages collection.
`HangoutsChat.Spaces.Patch`	`patch(String name, Space content)` Updates a space.
`HangoutsChat.Spaces.Search`	`search()` Returns a list of spaces in a Google Workspace organization based on an administrator's search.
`HangoutsChat.Spaces.Setup`	`setup(SetUpSpaceRequest content)` Creates a space and adds specified users to it.
`HangoutsChat.Spaces.SpaceEvents`	`spaceEvents()` An accessor for creating requests from the SpaceEvents collection.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Spaces
```
public Spaces()
```
- Method Detail
  - completeImport
```
public HangoutsChat.Spaces.CompleteImport completeImport(String name,
                                                         CompleteImportSpaceRequest content)
                                                  throws IOException
```
    Completes the [import process](https://developers.google.com/workspace/chat/import-data) for the specified space and makes it visible to users. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) and domain-wide delegation with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.import` For more information, see [Authorize Google Chat apps to import data](https://developers.google.com/workspace/chat/authorize-import). Create a request for the method "spaces.completeImport". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    name - Required. Resource name of the import mode space. Format: `spaces/{space}`
    
    content - the CompleteImportSpaceRequest
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - create
```
public HangoutsChat.Spaces.Create create(Space content)
                                  throws IOException
```
    Creates a space. Can be used to create a named space, or a group chat in `Import mode`. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.app.spaces.create` - `https://www.googleapis.com/auth/chat.app.spaces` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.create` - `https://www.googleapis.com/auth/chat.spaces` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) When authenticating as an app, the `space.customer` field must be set in the request. When authenticating as an app, the Chat app is added as a member of the space. However, unlike human authentication, the Chat app is not added as a space manager. By default, the Chat app can be removed from the space by all space members. To allow only space managers to remove the app from a space, set `space.permission_settings.manage_apps` to `managers_allowed`. Space membership upon creation depends on whether the space is created in `Import mode`: * **Import mode:** No members are created. * **All other modes:** The calling user is added as a member. This is: * The app itself when using app authentication. * The human user when using user authentication. If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Create a request for the method "spaces.create". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    content - the Space
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - delete
```
public HangoutsChat.Spaces.Delete delete(String name)
                                  throws IOException
```
    Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and the authorization scope: - `https://www.googleapis.com/auth/chat.app.delete` (only in spaces the app created) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat- user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.delete` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and the following authorization scope is used: - `https://www.googleapis.com/auth/chat.admin.delete` Create a request for the method "spaces.delete". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    name - Required. Resource name of the space to delete. Format: `spaces/{space}`
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - findDirectMessage
```
public HangoutsChat.Spaces.FindDirectMessage findDirectMessage()
                                                        throws IOException
```
    Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app. With [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` Create a request for the method "spaces.findDirectMessage". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - findGroupChats
```
public HangoutsChat.Spaces.FindGroupChats findGroupChats()
                                                  throws IOException
```
    [Developer Preview](https://developers.google.com/workspace/preview): Returns all spaces with `spaceType == GROUP_CHAT`, whose human memberships contain exactly the calling user, and the users specified in `FindGroupChatsRequest.users`. Only members that have joined the conversation are supported. For an example, see [Find group chats](https://developers.google.com/workspace/chat/find-group-chats). If the calling user blocks, or is blocked by, some users, and no spaces with the entire specified set of users are found, this method returns spaces that don't include the blocked or blocking users. The specified set of users must contain only human (non-app) memberships. A request that contains non-human users doesn't return any spaces. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` Create a request for the method "spaces.findGroupChats". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - get
```
public HangoutsChat.Spaces.Get get(String name)
                            throws IOException
```
    Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.spaces` with [administrator approval](https://support.google.com/a?p=chat-app-auth) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.spaces.readonly` - `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has the following limitations: - `space.access_settings` is only populated when using the `chat.app.spaces` scope. - `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. Create a request for the method "spaces.get". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    name - Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}`
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - list
```
public HangoutsChat.Spaces.List list()
                              throws IOException
```
    Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list- spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces.readonly` - `https://www.googleapis.com/auth/chat.spaces` To list all named spaces by Google Workspace organization, use the [`spaces.search()`](https://developers.google.com/workspace/chat/api/refere nce/rest/v1/spaces/search) method using Workspace administrator privileges instead. Create a request for the method "spaces.list". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - patch
```
public HangoutsChat.Spaces.Patch patch(String name,
                                       Space content)
                                throws IOException
```
    Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.app.spaces` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.spaces` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.spaces` App authentication has the following limitations: - To update either `space.predefined_permission_settings` or `space.permission_settings`, the app must be the space creator. - Updating the `space.access_settings.audience` is not supported for app authentication. Create a request for the method "spaces.patch". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    name - Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list ()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.
    
    content - the Space
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - search
```
public HangoutsChat.Spaces.Search search()
                                  throws IOException
```
    Returns a list of spaces in a Google Workspace organization based on an administrator's search. In the request, set `use_admin_access` to `true`. For an example, see [Search for and manage spaces](https://developers.google.com/workspace/chat/search-manage-admin). Requires [user authentication with administrator privileges](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user#admin- privileges) and one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.admin.spaces.readonly` - `https://www.googleapis.com/auth/chat.admin.spaces` Create a request for the method "spaces.search". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - setup
```
public HangoutsChat.Spaces.Setup setup(SetUpSpaceRequest content)
                                throws IOException
```
    Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. To specify the Google groups to add, add memberships with the appropriate `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add the group to the space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.spaces.create` - `https://www.googleapis.com/auth/chat.spaces` Create a request for the method "spaces.setup". This request holds the parameters needed by the chat server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    
    Parameters:
    
    content - the SetUpSpaceRequest
    
    Returns:
    
    the request
    
    Throws:
    
    IOException
  - members
```
public HangoutsChat.Spaces.Members members()
```
    An accessor for creating requests from the Members collection.
    The typical use is:
```
    HangoutsChat chat = new HangoutsChat(...);
    HangoutsChat.Members.List request = chat.members().list(parameters ...)
 
```
    Returns:
    
    the resource collection
  - messages
```
public HangoutsChat.Spaces.Messages messages()
```
    An accessor for creating requests from the Messages collection.
    The typical use is:
```
    HangoutsChat chat = new HangoutsChat(...);
    HangoutsChat.Messages.List request = chat.messages().list(parameters ...)
 
```
    Returns:
    
    the resource collection
  - spaceEvents
```
public HangoutsChat.Spaces.SpaceEvents spaceEvents()
```
    An accessor for creating requests from the SpaceEvents collection.
    The typical use is:
```
    HangoutsChat chat = new HangoutsChat(...);
    HangoutsChat.SpaceEvents.List request = chat.spaceEvents().list(parameters ...)
 
```
    Returns:
    
    the resource collection

Class HangoutsChat.Spaces

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Spaces

Method Detail

completeImport

create

delete

findDirectMessage

findGroupChats

get

list

patch

search

setup

members

messages

spaceEvents