REST Resource: spaces.members

Zasób: Membership

Reprezentuje relację członkostwa w Google Chat, np. czy użytkownik lub aplikacja Google Chat są zaproszeni do pokoju lub są w nim obecni albo go 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 jego uprawnienia 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ł zaproszony do niego. 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 tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.

Pole unii memberType. Użytkownik powiązany z tym członkostwem. W przyszłości możemy obsługiwać inne typy użytkownikó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 Google, do której należy użytkownik.

Odczytywanie lub modyfikowanie 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 zostaje dodany do pokoju i może 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. users: nie jest użytkownikiem pokoju, ale można go zaprosić. W przypadku Google Groups: zawsze przypisana jest im ta rola (w przyszłości mogą być używane inne wartości).
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ą zarządzanie pokojem, np. dodawanie i usuwanie użytkowników. Obsługiwane tylko w SpaceType.SPACE.

Grupa

Grupa dyskusyjna Google w Google Chat.

Zapis JSON
{
  "name": string
}
Pola
name

string

Nazwa zasobu grupy 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 subskrypcji.

list

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

patch

Aktualizuje subskrypcję.