Tworzy pokój. Można go używać do tworzenia nazwanego pokoju lub czatu grupowego w Import mode
. Przykład znajdziesz w artykule Tworzenie pokoju.
Obsługuje te typy uwierzytelniania:
Uwierzytelnianie aplikacji z zatwierdzeniem przez administratora i jednym z tych zakresów autoryzacji:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
Uwierzytelnianie użytkownika z jednym z tych zakresów autoryzacji:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.import
(tylko pokoje w trybie importowania)
Podczas uwierzytelniania jako aplikacja w żądaniu musi być ustawione pole space.customer
.
Podczas uwierzytelniania jako aplikacja aplikacja Google Chat jest dodawana jako członek pokoju. W przeciwieństwie do uwierzytelniania przez człowieka aplikacja Google Chat nie jest dodawana jako menedżer pokoju. Domyślnie aplikację Chat mogą usunąć z pokoju wszyscy jego użytkownicy. Aby zezwolić na usuwanie aplikacji z pokoju tylko menedżerom pokoju, ustaw space.permission_settings.manage_apps
na managersAllowed
.
Członkostwo w pokoju po jego utworzeniu zależy od tego, czy pokój został utworzony w Import mode
:
- Tryb importu: nie są tworzeni żadni użytkownicy.
- Wszystkie pozostałe tryby: użytkownik dzwoniący jest dodawany jako członek. Jest to:
- sama aplikacja, gdy używasz uwierzytelniania aplikacji;
- użytkownik, gdy korzysta z uwierzytelniania użytkownika;
Jeśli podczas tworzenia pokoju pojawi się komunikat o błędzie ALREADY_EXISTS
, spróbuj użyć innego displayName
. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.
Żądanie HTTP
POST https://chat.googleapis.com/v1/spaces
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
requestId |
Opcjonalnie. Unikalny identyfikator tego żądania. Zalecany jest losowy identyfikator UUID. Określenie identyfikatora istniejącej prośby spowoduje zwrócenie pokoju utworzonego za pomocą tego identyfikatora zamiast utworzenia nowego pokoju. Określenie identyfikatora istniejącej prośby z tej samej aplikacji do obsługi czatu z innym uwierzytelnionym użytkownikiem spowoduje zwrócenie błędu. |
Treść żądania
Treść żądania zawiera wystąpienie elementu Space
.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Space
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
Więcej informacji znajdziesz w przewodniku po autoryzacji.