Reference documentation and code samples for the Google Chat V1 API class Google::Apps::Chat::V1::Space.
A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.
Inherits
- Object
Extended By
- Google::Protobuf::MessageExts::ClassMethods
Includes
- Google::Protobuf::MessageExts
Methods
#admin_installed
def
admin_installed
()
-
>
::
Boolean
- (::Boolean) — Output only. For direct message (DM) spaces with a Chat app, whether the
space was created by a Google Workspace administrator. Administrators can
install and set up a direct message with a Chat app on behalf of users in
their organization.
To support admin install, your Chat app must feature direct messaging.
#create_time
def
create_time
()
-
>
::
Google
::
Protobuf
::
Timestamp
- ( ::Google::Protobuf::Timestamp
) — Optional. Immutable. For spaces created in Chat, the time the space was
created. This field is output only, except when used in import mode spaces.
For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time.
Only populated in the output when
spaceType
isGROUP_CHAT
orSPACE
.
#create_time=
def
create_time=
(
value
)
-
>
::
Google
::
Protobuf
::
Timestamp
- value( ::Google::Protobuf::Timestamp
) — Optional. Immutable. For spaces created in Chat, the time the space was
created. This field is output only, except when used in import mode spaces.
For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time.
Only populated in the output when
spaceType
isGROUP_CHAT
orSPACE
.
- ( ::Google::Protobuf::Timestamp
) — Optional. Immutable. For spaces created in Chat, the time the space was
created. This field is output only, except when used in import mode spaces.
For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time.
Only populated in the output when
spaceType
isGROUP_CHAT
orSPACE
.
#display_name
def
display_name
()
-
>
::
String
- (::String) — The space's display name. Required when creating a
space
.
If you receive the error message
ALREADY_EXISTS
when creating a space or updating thedisplayName
, try a differentdisplayName
. An existing space within the Google Workspace organization might already use this display name.For direct messages, this field might be empty.
Supports up to 128 characters.
#display_name=
def
display_name=
(
value
)
-
>
::
String
- value(::String) — The space's display name. Required when creating a
space
.
If you receive the error message
ALREADY_EXISTS
when creating a space or updating thedisplayName
, try a differentdisplayName
. An existing space within the Google Workspace organization might already use this display name.For direct messages, this field might be empty.
Supports up to 128 characters.
- (::String) — The space's display name. Required when creating a
space
.
If you receive the error message
ALREADY_EXISTS
when creating a space or updating thedisplayName
, try a differentdisplayName
. An existing space within the Google Workspace organization might already use this display name.For direct messages, this field might be empty.
Supports up to 128 characters.
#external_user_allowed
def
external_user_allowed
()
-
>
::
Boolean
- (::Boolean) — Immutable. Whether this space permits any Google Chat user as a member.
Input when creating a space in a Google Workspace organization. Omit this
field when creating spaces in the following conditions:
-
The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user.
-
The space is used to import data to Google Chat because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the Google Workspace Developer Preview Program , import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces.
For existing spaces, this field is output only.
-
#external_user_allowed=
def
external_user_allowed=
(
value
)
-
>
::
Boolean
- value(::Boolean) — Immutable. Whether this space permits any Google Chat user as a member.
Input when creating a space in a Google Workspace organization. Omit this
field when creating spaces in the following conditions:
-
The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user.
-
The space is used to import data to Google Chat because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the Google Workspace Developer Preview Program , import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces.
For existing spaces, this field is output only.
-
- (::Boolean) — Immutable. Whether this space permits any Google Chat user as a member.
Input when creating a space in a Google Workspace organization. Omit this
field when creating spaces in the following conditions:
-
The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user.
-
The space is used to import data to Google Chat because import mode spaces must only permit members from the same Google Workspace organization. However, as part of the Google Workspace Developer Preview Program , import mode spaces can permit any Google Chat user so this field can then be set for import mode spaces.
For existing spaces, this field is output only.
-
#import_mode
def
import_mode
()
-
>
::
Boolean
- (::Boolean) — Optional. Whether this space is created in
Import Mode
as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete.
#import_mode=
def
import_mode=
(
value
)
-
>
::
Boolean
- value(::Boolean) — Optional. Whether this space is created in
Import Mode
as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete.
- (::Boolean) — Optional. Whether this space is created in
Import Mode
as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete.
#name
def
name
()
-
>
::
String
- (::String) — Resource name of the space.
Format:
spaces/{space}
#name=
def
name=
(
value
)
-
>
::
String
- value(::String) — Resource name of the space.
Format:
spaces/{space}
- (::String) — Resource name of the space.
Format:
spaces/{space}
#single_user_bot_dm
def
single_user_bot_dm
()
-
>
::
Boolean
- (::Boolean) — Optional. Whether the space is a DM between a Chat app and a single human.
#single_user_bot_dm=
def
single_user_bot_dm=
(
value
)
-
>
::
Boolean
- value(::Boolean) — Optional. Whether the space is a DM between a Chat app and a single human.
- (::Boolean) — Optional. Whether the space is a DM between a Chat app and a single human.
#space_details
def
space_details
()
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
SpaceDetails
- ( ::Google::Apps::Chat::V1::Space::SpaceDetails ) — Details about the space including description and rules.
#space_details=
def
space_details=
(
value
)
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
SpaceDetails
- value( ::Google::Apps::Chat::V1::Space::SpaceDetails ) — Details about the space including description and rules.
- ( ::Google::Apps::Chat::V1::Space::SpaceDetails ) — Details about the space including description and rules.
#space_history_state
def
space_history_state
()
-
>
::
Google
::
Apps
::
Chat
::
V1
::
HistoryState
- ( ::Google::Apps::Chat::V1::HistoryState ) — The message history state for messages and threads in this space.
#space_history_state=
def
space_history_state=
(
value
)
-
>
::
Google
::
Apps
::
Chat
::
V1
::
HistoryState
- value( ::Google::Apps::Chat::V1::HistoryState ) — The message history state for messages and threads in this space.
- ( ::Google::Apps::Chat::V1::HistoryState ) — The message history state for messages and threads in this space.
#space_threading_state
def
space_threading_state
()
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
SpaceThreadingState
- ( ::Google::Apps::Chat::V1::Space::SpaceThreadingState ) — Output only. The threading state in the Chat space.
#space_type
def
space_type
()
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
SpaceType
- ( ::Google::Apps::Chat::V1::Space::SpaceType ) — The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.
#space_type=
def
space_type=
(
value
)
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
SpaceType
- value( ::Google::Apps::Chat::V1::Space::SpaceType ) — The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.
- ( ::Google::Apps::Chat::V1::Space::SpaceType ) — The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.
#threaded
def
threaded
()
-
>
::
Boolean
- (::Boolean) — Output only. Deprecated: Use
spaceThreadingState
instead. Whether messages are threaded in this space.
#type
def
type
()
-
>
::
Google
::
Apps
::
Chat
::
V1
::
Space
::
Type
- ( ::Google::Apps::Chat::V1::Space::Type
) — Output only. Deprecated: Use
space_type
instead. The type of a space.