REST Resource: members

Zasób: Member

Członkiem Grup dyskusyjnych Google może być użytkownik lub inna grupa. Ten użytkownik może należeć do domen Twojego konta lub domen spoza niego. Więcej informacji o częstych zadaniach członków grupy znajdziesz w przewodniku dla programistów.

Zapis JSON
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
Pola
kind

string

Typ zasobu interfejsu API. W przypadku zasobów dotyczących członków wartość to admin#directory#member.

email

string

Adres e-mail członka grupy. Członkiem może być użytkownik lub inna grupa. Ta właściwość jest wymagana podczas dodawania użytkownika do grupy. Wartość email musi być niepowtarzalna i nie może być aliasem innej grupy. Jeśli zmienisz adres e-mail, interfejs API automatycznie odzwierciedli tę zmianę.

role

string

Rola członka w grupie. Interfejs API zwraca błąd w przypadku cykli w członkostwie grup. Jeśli np. group1 jest elementem group2, group2 nie może być elementem group1. Więcej informacji o roli członka grupy znajdziesz w artykule Przypisywanie użytkownikom ról w grupie.

Akceptowane wartości:

  • MANAGER: ta rola jest dostępna tylko wtedy, gdy Grupy dyskusyjne Google dla Firm są włączone w konsoli administracyjnej. Zobacz Włączanie i wyłączanie Grup dyskusyjnych Google dla Firm. Użytkownik z rolą MANAGER może wykonywać te same czynności co użytkownik z rolą OWNER, z wyjątkiem nadawania uprawnień OWNER innemu członkowi i usuwania grupy. Grupa może mieć wielu MANAGER członków.
  • MEMBER: ta rola pozwala subskrybować grupę, wyświetlać archiwa dyskusji i listę członków grupy. Więcej informacji o rolach członków znajdziesz w artykule Przypisywanie użytkownikom ról w grupie.
  • OWNER: ta rola pozwala wysyłać wiadomości do grupy, dodawać i usuwać członków, zmieniać ich role, zmieniać ustawienia grupy i ją usuwać. OWNER musi być członkiem grupy. Grupa może mieć więcej niż 1 OWNER.
etag

string

ETag zasobu.

type

string

Typ członka grupy.

Akceptowane wartości:

  • CUSTOMER: członek reprezentuje wszystkich użytkowników w domenie. Adres e-mail nie jest zwracany, a zwracanym identyfikatorem jest identyfikator klienta.
  • EXTERNAL: członek jest użytkownikiem lub grupą spoza domeny. (nieużywane obecnie)
  • GROUP: członek jest inną grupą.
  • USER: członek jest użytkownikiem.
status

string

Stan wspierającego (niezmienny)

delivery_settings

string

Określa ustawienia dostarczania poczty przez członka. To pole jest obsługiwane tylko przez metody insert, update i get.

Akceptowane wartości:

  • ALL_MAIL: wszystkie wiadomości, dostarczane od razu po otrzymaniu.
  • DAILY: nie więcej niż 1 wiadomość dziennie.
  • DIGEST: do 25 wiadomości połączonych w jedną wiadomość.
  • DISABLED: usuwanie subskrypcji.
  • NONE: brak wiadomości.
id

string

Unikalny identyfikator członka grupy. Użytkownik id może być używany jako identyfikator URI żądania użytkownika memberKey.

Metody

delete

Usuwanie użytkownika z grupy.

get

Pobiera właściwości członka grupy.

hasMember

Sprawdza, czy dany użytkownik należy do grupy.

insert

Dodaje użytkownika do określonej grupy.

list

Pobiera pogrupowaną listę wszystkich członków grupy.

patch

Aktualizuje właściwości członkostwa użytkownika w określonej grupie.

update

Aktualizuje członkostwo użytkownika w określonej grupie.