Interfejs Groups Settings API aktualizuje i pobiera ustawienia istniejącej grupy dyskusyjnej Google. Za pomocą interfejsu API możesz wykonać te czynności:
- Zmodyfikuj ustawienia grupy dla dostępu wewnętrznego i zewnętrznego.
- Edytuj powiadomienia grupy.
- Skonfiguruj archiwizowanie dyskusji i moderowanie wiadomości.
- Dostosuj grupy użytkowników na koncie.
Więcej sposobów korzystania z grup dyskusyjnych Google i zarządzania innymi typami grup znajdziesz w dokumentacji Cloud Identity.
Model danych interfejsu Groups Settings API
Interfejs Groups Settings API działa w zasobie Groups
, który reprezentuje sposób, w jaki użytkownicy konta 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 zbiorze danych Groups
z konta na koncie. Każda grupa ma unikalny zestaw ustawień konfiguracji.
Operacje na interfejsie Groups Settings API
Metody ustawień grup możesz wywoływać w interfejsie Groups Settings API, tak jak opisano w tej tabeli:
Operacja | Opis | Mapowanie HTTP REST |
---|---|---|
get |
Pobiera ustawienia grupy dla konta 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 interfejs Groups Settings API zwraca dane w formacie JSON. Atom Notation to alternatywny format danych. Zarówno formaty danych JSON, jak i Atom obsługują pełne możliwości odczytu i zapisu.
JSON to popularny format internetu, który pozwala reprezentować dowolne struktury danych. Według danych json.org format JSON jest całkowicie niezależny od języka, ale używane są konwencje znane programistom z rodziny języków C, takich jak C, C++, C#, Java, JavaScript, Perl i Python.
Aby zmienić format danych interfejsu API, umieść w żądaniu identyfikator ciągu zapytania alt
, 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