Method: spaces.members.create

Zmienia członkostwo w aplikacji do obsługi połączeń przez człowieka. Tworzenie subskrypcji w innych aplikacjach nie jest obsługiwane. Przykład znajdziesz w artykule Zapraszanie i dodawanie użytkownika lub aplikacji Google Chat do pokoju. Jeśli podczas tworzenia członkostwa dany użytkownik ma wyłączoną zasadę automatycznego akceptowania, zostanie zaproszony i będzie musiał zaakceptować zaproszenie do pokoju, zanim dołączy. W przeciwnym razie utworzenie subskrypcji spowoduje dodanie użytkownika bezpośrednio do określonego pokoju. Wymaga uwierzytelniania użytkownika.

Aby wskazać użytkownika do dodania, ustaw membership.member.name dla użytkownika lub użytkownika aplikacji albo ustaw membership.group_member.name dla członka grupy.

  • Aby dodać aplikację do rozmów do pokoju lub czatu między 2 osobami, użyj funkcji users/app. Nie udało się dodać innych aplikacji do pokoju.

  • Aby dodać użytkownika, użyj pola users/{user}, gdzie {user} może być jego adresem e-mail. W przypadku użytkowników w tej samej organizacji Workspace {user} może być też id dla osoby z interfejsu People API lub id dla użytkownika w interfejsie Directory API. Jeśli na przykład identyfikator profilu osoby w interfejsie People API w aplikacji user@example.com to 123456789, możesz dodać użytkownika do pokoju, ustawiając membership.member.name na users/user@example.com lub users/123456789.

  • Aby dodać lub zaprosić grupę dyskusyjną Google do nazwanego pokoju, użyj pola groups/{group}, gdzie {group} to id grupy z interfejsu Cloud Identity Groups API. Możesz na przykład użyć interfejsu Cloud Identity Groups lookup API do pobrania identyfikatora 123456789 adresu e-mail grupy group@example.com, a następnie dodać grupę lub zaprosić ją do nazwanego pokoju, ustawiając membership.group_member.name na groups/123456789. Adres e-mail grupy nie jest obsługiwany. Grupy dyskusyjne Google można dodawać tylko jako członków w pokojach nazwanych.

Żądanie HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Nazwa zasobu pokoju, do którego chcesz dodać członkostwo.

Format: spacje/{spacja}

Parametry zapytania

Parametry
useAdminAccess

boolean

Jeśli zasada jest true, metoda jest uruchamiana z uprawnieniami administratora Google Workspace użytkownika.

Użytkownik dzwoniący musi być administratorem Google Workspace z uprawnieniami do zarządzania czatem i rozmowami w pokoju.

Wymaga chat.admin.memberships zakresu OAuth 2.0.

Przy użyciu dostępu administracyjnego nie można tworzyć subskrypcji w aplikacjach ani tworzyć subskrypcji dla użytkowników spoza organizacji Google Workspace administratora.

Treść żądania

Treść żądania zawiera wystąpienie elementu Membership.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Membership.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.