Tworzy pokój. Można go użyć do utworzenia pokoju o nazwie lub czatu grupowego w Import mode. Przykład znajdziesz w artykule Tworzenie pokoju.
Obsługuje te typy uwierzytelniania:
Uwierzytelnianie aplikacji z zatwierdzaniem przez administratora w wersji przedpremierowej dla programistów
Podczas uwierzytelniania jako aplikacja musisz ustawić w żądaniu pole space.customer.
Uprawnienia do pokoju po utworzeniu zależą od tego, czy pokój został utworzony w Import mode:
- Tryb importowania: nie są tworzeni nowi członkowie.
- Wszystkie inne tryby: użytkownik dzwoniący jest dodawany jako członek. Oto one:
- sama aplikacja, jeśli używasz uwierzytelniania aplikacji;
- Użytkownik (człowiek) podczas uwierzytelniania użytkownika.
Jeśli podczas tworzenia pokoju pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innego displayName. Ta wyświetlana nazwa może być już używana w przypadku istniejącego pokoju w organizacji Google Workspace.
Żądanie HTTP
POST https://chat.googleapis.com/v1/spaces
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry | |
|---|---|
request |
Opcjonalnie: Unikalny identyfikator tego żądania. Zalecamy losowy identyfikator UUID. Podanie identyfikatora istniejącej prośby spowoduje zwrócenie pokoju utworzonego z tym identyfikatorem, a nie utworzenie nowego pokoju. Podanie istniejącego identyfikatora prośby z tej samej aplikacji Google Chat, ale z innym uwierzytelnionym użytkownikiem spowoduje błąd. |
Treść żądania
Treść żądania zawiera wystąpienie elementu Space.
Treść odpowiedzi
Jeśli operacja się powiedzie, 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.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.