Groups Settings API – aktualizuje i pobiera ustawienia istniejących Grup dyskusyjnych Google. Za pomocą interfejsu API możesz:
- zmieniać ustawienia grupy dotyczące dostępu do grup wewnętrznych i zewnętrznych;
- edytować powiadomienia grupy;
- konfigurować archiwizowanie dyskusji i moderowanie wiadomości;
- dostosowywać grupy użytkowników na koncie.
Więcej informacji o sposobach pracy z Grupami dyskusyjnymi Google i zarządzaniu innymi typami grup znajdziesz w dokumentacji Cloud Identity.
Model danych Groups Settings API
Groups Settings API działa na zasobie Groups, który określa, jak użytkownicy na koncie komunikują się i współpracują z grupami innych osób.
Każda grupa jest identyfikowana przez adres e-mail.
Model danych interfejsu API jest oparty na kolekcji Groups grup na koncie.
Każda grupa ma unikalny zestaw ustawień konfiguracji.
Operacje Groups Settings API
Możesz wywoływać metody ustawień grupy w Groups Settings API, jak opisano w tej tabeli:
| Operacja | Opis | Mapowania REST HTTP |
|---|---|---|
get |
Pobiera ustawienia grupy na koncie klienta. Wszystkie operacje pobierania muszą być autoryzowane przez uwierzytelnionego użytkownika. | GET w identyfikatorze URI grupy. |
update |
Aktualizuje ustawienia grupy na koncie klienta. Wszystkie operacje aktualizacji muszą być autoryzowane przez uwierzytelnionego użytkownika. | PUT w identyfikatorze URI grupy. |
Formaty danych JSON i Atom
Domyślnie Groups Settings API zwraca dane w formacie JSON. Notacja Atom to alternatywny format danych. Formaty danych JSON i Atom obsługują pełne możliwości odczytu i zapisu.
JSON to popularny format internetowy, który umożliwia reprezentowanie dowolnych struktur danych. Zgodnie z json.org JSON to format tekstowy, który jest całkowicie niezależny od języka, ale używa konwencji znanych programistom języków z rodziny C, w tym C, C++, C#, Java, JavaScript, Perl i Python.
Format danych interfejsu API możesz zmienić, dodając ciąg zapytania alt do identyfikatora URI żądania. Na przykład:
JSON
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json
Atom
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom