Method: spaces.create

Tworzy pokój. Może służyć 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 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 importu)

Gdy uwierzytelniasz się jako aplikacja, w żądaniu musisz ustawić pole space.customer.

Gdy uwierzytelniasz się jako aplikacja, aplikacja do czatu jest dodawana jako użytkownik pokoju. Jednak w przeciwieństwie do uwierzytelniania użytkownika aplikacja do czatu nie jest dodawana jako menedżer pokoju. Domyślnie aplikację do czatu mogą usunąć z pokoju wszyscy jego użytkownicy. Aby zezwolić na usuwanie aplikacji z pokoju tylko menedżerom pokoju, ustaw wartość 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 inne tryby: użytkownik wywołujący jest dodawany jako użytkownik. Jest to:
    • sama aplikacja, gdy używasz uwierzytelniania aplikacji;
    • użytkownik, gdy używasz uwierzytelniania użytkownika.

Jeśli podczas tworzenia pokoju otrzymasz komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej wartości displayName. Ta wyświetlana nazwa może być już używana w istniejącym 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
requestId

string

Opcjonalnie. Unikalny identyfikator tego żądania. Zalecany jest losowy identyfikator UUID. Określenie identyfikatora żądania sprawia, że żądanie jest idempotentne, co oznacza, że wiele identycznych żądań z tym samym identyfikatorem żądania spowoduje utworzenie tylko jednego pokoju. Kolejne żądania z tym samym identyfikatorem żądania zwracają istniejący pokój i nie aktualizują go, nawet jeśli żądane szczegóły różnią się od bieżącego stanu.

Aby skutecznie korzystać z tego pola:

  • Upewnij się, że kolejne żądania są identyczne i używają tych samych danych uwierzytelniających co pierwotne żądanie.
  • Jeśli pokój został już utworzony z podanym identyfikatorem żądania, żądanie zwróci ten pokój. Pamiętaj, że zwrócony pokój może nie być w pełni wypełniony. Interfejs API odzwierciedla pokój w żądaniu z wypełnioną nazwą zasobu przypisaną przez system. Aby pobrać najnowsze metadane pokoju, wywołaj spaces.get.
  • Ponowne użycie istniejącego identyfikatora żądania z innym uwierzytelnionym użytkownikiem spowoduje błąd.

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ę elementu 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.