Omówienie interfejsu Groups Settings API

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