REST Resource: spaces.members

Zasób: Membership

Reprezentuje relację członkostwa w Google Chat, np. czy użytkownik lub aplikacja Google Chat jest zaproszony do pokoju, należy do niego czy nie.

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 uczestnictwa przypisana przez serwer.

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

enum (MembershipState)

Tylko dane wyjściowe. Stan subskrypcji.
role

enum (MembershipRole)

Opcjonalnie: Rola użytkownika w pokoju czatu, która określa, jakie działania może on wykonywać w tym pokoju.

To pole może być używane jako dane wejściowe tylko w members.patch.
createTime

string (Timestamp format)

Opcjonalnie: Niezmienne. Czas utworzenia członkostwa, np. gdy użytkownik dołączył do pokoju lub otrzymał zaproszenie do dołączenia do niego. To pole jest tylko danymi wyjściowymi, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.
deleteTime

string (Timestamp format)

Opcjonalnie: Niezmienne. Czas usunięcia członkostwa, np. gdy użytkownik opuścił pokój lub został z niego usunięty. To pole jest tylko danymi wyjściowymi, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.
Pole zbiorcze memberType. Uczestnik powiązany z tym członkostwem. W przyszłości możemy dodać obsługę innych typów użytkowników. memberType może mieć tylko jedną z tych wartości:
member

object (User)

Opcjonalnie: Użytkownik lub aplikacja Google Chat, do której należy członkostwo. Jeśli aplikacja do czatu 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 członkostwo.

Odczytywanie lub zmienianie członkostwa w grupach dyskusyjnych Google wymaga uwierzytelnienia użytkownika.

MembershipState

Określa relację użytkownika z pokojem. W przyszłości możemy dodać obsługę innych stanów członkowskich.

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 niego.

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 ta rola (w przyszłości mogą być używane inne wartości wyliczeniowe).
ROLE_MEMBER

Osoba w pokoju. W interfejsie czatu ta rola jest nazywana Użytkownik.

Użytkownik ma podstawowe uprawnienia, takie jak wysyłanie wiadomości na czacie. Menedżerowie i właściciele mogą przyznawać użytkownikom dodatkowe uprawnienia w pokoju, w tym:

  • Dodaj lub usuń członków.
  • modyfikować szczegóły pokoju,
  • włączanie i wyłączanie historii,
  • Wzmianka o wszystkich osobach w pokoju za pomocą @all.
  • zarządzać aplikacjami i webhookami Google Chat zainstalowanymi w pokoju.

Na czatach i czatach grupowych bez nazwy każda osoba ma tę rolę.
ROLE_MANAGER

właściciel pokoju, W interfejsie czatu ta rola jest nazywana właścicielem.

Użytkownik ma pełny zestaw uprawnień do zarządzania pokojem, w tym:

  • zmieniać rolę innych członków pokoju na członka, menedżera lub właściciela;
  • usunąć pokój.

Obsługiwane tylko w SpaceType.SPACE (nazwane pokoje).

Więcej informacji znajdziesz w artykule Więcej informacji o roli właściciela lub menedżera pokoju.
ROLE_ASSISTANT_MANAGER

menedżerem pokoju, W interfejsie czatu ta rola nosi nazwę Menedżer.

Użytkownik ma wszystkie podstawowe uprawnienia ROLE_MEMBER, a właściciel może mu przyznać podzbiór uprawnień administracyjnych. Domyślnie menedżerowie mają wszystkie uprawnienia właściciela, ale nie mogą:

  • usunąć pokój.
  • nadawania innej osobie z pokoju roli właściciela,
  • zmieniać rolę właściciela,

Uprawnienia menedżerów obejmują domyślnie m.in.:

  • nadawania innym członkom roli menedżera,
  • usuwać wiadomości w pokoju;
  • zarządzać uprawnieniami pokoju;
  • otrzymywać powiadomienia o prośbach o dołączenie do pokoju, jeśli menedżer ma uprawnienia do zarządzania użytkownikami w ustawieniach pokoju;
  • Udostępnij pokój.

Obsługiwane tylko w SpaceType.SPACE (nazwane pokoje).

Więcej informacji znajdziesz w artykule Zarządzanie ustawieniami pokoju.

Grupa

Grupy 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 w aplikacji do połączeń 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ę.