REST Resource: spaces.members

Ресурс: Членство

Представляет отношение членства в Google Chat, например, приглашен ли пользователь или приложение чата в пространство, является его частью или отсутствует в нем.

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.
}
Поля
name

string

Идентификатор. Имя ресурса членства, назначенное сервером.

Формат: spaces/{space}/members/{member}

state

enum ( MembershipState )

Только вывод. Состояние членства.

role

enum ( MembershipRole )

Необязательно. Роль пользователя в чат-пространстве, которая определяет его разрешённые действия в этом пространстве.

Это поле можно использовать только как входные данные в members.patch .

createTime

string ( Timestamp format)

Необязательное. Неизменяемое. Время создания членства, например, когда участник присоединился или был приглашен в пространство. Это поле предназначено только для вывода, за исключением случаев, когда оно используется для импорта истории членства в пространствах с режимом импорта.

deleteTime

string ( Timestamp format)

Необязательное. Неизменяемое. Время удаления членства, например, когда участник покинул пространство или был удалён из него. Это поле предназначено только для вывода, за исключением случаев, когда оно используется для импорта истории членства в пространствах с режимом импорта.

Поле объединения memberType . Член, связанный с этим членством. Другие типы членов могут быть поддержаны в будущем. memberType может быть только одним из следующих:
member

object ( User )

Необязательно. Пользователь или приложение Google Chat, которому соответствует членство. Если ваше приложение Chat аутентифицируется как пользователь , в выходных данных отображаются name и type пользователя .

groupMember

object ( Group )

Необязательно. Группа Google, к которой относится членство.

Для чтения или изменения членства в группах Google требуется аутентификация пользователя .

Членство

Определяет связь участника с пространством. Другие состояния членства могут быть поддержаны в будущем.

Перечисления
MEMBERSHIP_STATE_UNSPECIFIED Значение по умолчанию. Не использовать.
JOINED Пользователь добавлен в пространство и может принимать в нем участие.
INVITED Пользователю предложено присоединиться к пространству, но он еще не присоединился к нему.
NOT_A_MEMBER Пользователь не принадлежит к пространству и не имеет ожидающих приглашений присоединиться к нему.

ЧленствоРоль

Представляет разрешённые действия пользователя в чате. В будущем могут быть добавлены дополнительные значения перечисления.

Перечисления
MEMBERSHIP_ROLE_UNSPECIFIED Значение по умолчанию. Для users : они не являются участниками пространства, но могут быть приглашены. Для Google Groups : им всегда назначается эта роль (в будущем могут быть использованы другие значения перечисления).
ROLE_MEMBER

Участник чата. В интерфейсе чата эта роль называется «Участник».

У пользователя есть базовые разрешения, такие как отправка сообщений в чат-группе. Менеджеры и владельцы могут предоставлять участникам дополнительные разрешения в чат-группе, включая:

  • Добавляйте или удаляйте участников.
  • Измените данные о пространстве.
  • Включите или выключите историю.
  • Упомяните всех, кто находится в этом пространстве, с помощью @all .
  • Управление чат-приложениями и веб-перехватчиками, установленными в пространстве.

В личных сообщениях и анонимных групповых беседах эта роль принадлежит каждому.

ROLE_MANAGER

Владелец пространства. В интерфейсе чата эта роль называется «Владелец».

Пользователь имеет полный набор разрешений для управления пространством, включая:

  • Измените роль других участников пространства на участника, менеджера или владельца.
  • Удалить пробел.

Поддерживается только в SpaceType.SPACE (именованные пространства).

Чтобы узнать больше, ознакомьтесь со статьей «Подробнее о вашей роли владельца или менеджера пространства» .

ROLE_ASSISTANT_MANAGER

Менеджер пространства. В интерфейсе чата эта роль называется «Менеджер».

Пользователь имеет все базовые разрешения ROLE_MEMBER и может получить подмножество административных разрешений от владельца. По умолчанию менеджеры имеют все разрешения владельца, за исключением возможности:

  • Удалить пробел.
  • Сделайте другого участника пространства владельцем.
  • Изменить роль владельца.

По умолчанию разрешения менеджеров включают, но не ограничиваются:

  • Назначьте другого участника менеджером.
  • Удалить сообщения в чате.
  • Управление правами доступа к пространству.
  • Получайте уведомления о запросах на присоединение к пространству, если у менеджера есть разрешение «управлять участниками» в настройках пространства.
  • Сделайте пространство доступным для исследования.

Поддерживается только в SpaceType.SPACE (именованные пространства).

Более подробную информацию см. в разделе Управление настройками пространства .

Группа

Группа Google в Google Chat.

JSON-представление 
{
  "name": string
}
Поля
name

string

Имя ресурса для группы Google.

Представляет группу в API Cloud Identity Groups.

Формат: группы/{группа}

Методы

create

 Создает членство для вызывающего приложения чата, пользователя или группы Google.

delete

 Удаляет членство.

get

 Возвращает сведения о членстве.

list

 Список членств в пространстве.

patch

 Обновляет членство.