REST Resource: spaces.members

Zasób: Membership

Reprezentuje relację członkostwa w Google Chat, na przykład to, czy użytkownik lub aplikacja do obsługi czatu został zaproszony do pokoju, jego część lub osoba w nim nie ma.

Zapis JSON
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
Pola
name

string

Identyfikator. Nazwa zasobu członkostwa przypisana przez serwer.

Format: spaces/{space}/members/{member}

state

enum (MembershipState)

Tylko dane wyjściowe. Stan członkostwa.

role

enum (MembershipRole)

Opcjonalnie: Rola użytkownika w pokoju czatu, która określa dozwolone działania w pokoju.

To pole może być używane tylko w przypadku members.patch.

createTime

string (Timestamp format)

Opcjonalnie: Niezmienna. Czas utworzenia członkostwa, np. kiedy użytkownik dołączył do pokoju lub został do niego zaproszony. To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.

deleteTime

string (Timestamp format)

Opcjonalnie: Niezmienna. Czas usunięcia członkostwa, np. gdy użytkownik opuścił pokój lub został z niego usunięty. To pole jest używane tylko do wprowadzania danych wyjściowych, chyba że jest używane do importowania wcześniejszych danych o członkostwie w pokojach w trybie importowania.

Pole unii memberType. Członek powiązany z tą subskrypcją. W przyszłości mogą być obsługiwane inne typy członków. memberType może być tylko jednym z tych elementów:
member

object (User)

Opcjonalnie: Użytkownik lub aplikacja Google Chat, do których należy członkostwo. Jeśli aplikacja Google Chat uwierzytelnia się jako użytkownik, dane wyjściowe wypełniają pola user name i type.

groupMember

object (Group)

Opcjonalnie: Grupa dyskusyjna Google, do której należy członkostwo.

Odczytywanie lub zmienianie członkostwa w Grupach dyskusyjnych Google wymaga uwierzytelniania użytkownika.

MembershipState

Określa relację użytkownika z pokojem. W przyszłości możemy obsługiwać inne stany członkostwa.

Wartości w polu enum
MEMBERSHIP_STATE_UNSPECIFIED Wartość domyślna. Nie używaj.
JOINED Użytkownik zostanie dodany do pokoju i będzie mógł w nim uczestniczyć.
INVITED Użytkownik został zaproszony do pokoju, ale nie dołączył do niego.
NOT_A_MEMBER Użytkownik nie należy do pokoju i nie ma oczekującego zaproszenia do dołączenia do pokoju.

MembershipRole

Reprezentuje dozwolone działania użytkownika w pokoju czatu. W przyszłości możemy dodać więcej wartości typu wyliczeniowego.

Wartości w polu enum
MEMBERSHIP_ROLE_UNSPECIFIED Wartość domyślna. W przypadku users: ta osoba nie jest członkiem pokoju, ale można ją zaprosić. W przypadku użytkowników Google Groups zawsze mają przypisaną tę rolę (w przyszłości mogą zostać użyte inne wartości wyliczeniowe).
ROLE_MEMBER Użytkownik jest członkiem pokoju. Użytkownik ma podstawowe uprawnienia, takie jak wysyłanie wiadomości do pokoju. W rozmowach 1:1 i rozmowach grupowych bez nazwy wszyscy mają tę rolę.
ROLE_MANAGER menedżer pokoju. Użytkownik ma wszystkie podstawowe uprawnienia oraz uprawnienia administracyjne, które umożliwiają mu zarządzanie pokojem, w tym dodawanie i usuwanie użytkowników. Funkcja obsługiwana tylko w tym kraju: SpaceType.SPACE.

Grupa

Grupa dyskusyjna Google w Google Chat.

Zapis JSON
{
  "name": string
}
Pola
name

string

Nazwa zasobu Grupy dyskusyjnej Google.

Reprezentuje grupę w Cloud Identity Groups API.

Format: groups/{group}

Metody

create

Tworzy członkostwo dla aplikacji do połączeń w Google Chat, użytkownika lub grupy Google.

delete

Usuwa subskrypcję.

get

Zwraca szczegóły dotyczące subskrypcji.

list

Wyświetla listę użytkowników w pokoju.

patch

Aktualizuje subskrypcję.