Interfejs Groups Settings API aktualizuje i pobiera ustawienia istniejących grup Google. Za pomocą interfejsu API możesz:
- zmieniać ustawienia grupy dotyczące dostępu do grup wewnętrznych i zewnętrznych;
- Edytować powiadomienia grupy.
- Skonfiguruj archiwizowanie dyskusji i moderowanie wiadomości.
- Dostosuj grupy użytkowników na koncie.
Więcej sposobów pracy z grupami Google i zarządzania innymi typami grup znajdziesz w dokumentacji Cloud Identity.
Model danych interfejsu Groups Settings API
Interfejs Groups Settings API działa na Groups, który określa, w jaki sposób użytkownicy konta komunikują się i współpracują z grupami innych osób.
Każda grupa jest identyfikowana przez adres e-mail grupy.
Model danych interfejsu API opiera się na Groups kolekcji grup konta.
Każda grupa ma unikalny zestaw ustawień konfiguracji.
Operacje interfejsu Groups Settings API
Możesz wywoływać metody ustawień grupy w interfejsie Groups Settings API zgodnie z opisem 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 przypadku identyfikatora URI grupy. |
update |
Aktualizuje ustawienia grupy na koncie klienta. Wszystkie operacje update muszą być autoryzowane przez uwierzytelnionego użytkownika. | PUT w przypadku identyfikatora URI grupy. |
Formaty danych JSON i Atom
Domyślnie interfejs Groups Settings API zwraca dane w formacie JSON. Notacja Atom to alternatywny format danych. Zarówno format danych JSON, jak i Atom umożliwiają pełny odczyt i zapis.
JSON to popularny format internetowy, który umożliwia reprezentowanie dowolnych struktur danych. Według json.org JSON to format tekstowy, który jest całkowicie niezależny od języka, ale wykorzystuje konwencje znane programistom języków z rodziny C, w tym C, C++, C#, Java, JavaScript, Perl i Python.
Format danych interfejsu API możesz zmienić, uwzględniając ciąg zapytania alt w identyfikatorze 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