Interfejs Groups Settings API aktualizuje i pobiera ustawienia istniejącej grupy Google. Za pomocą interfejsu API możesz:
- Modyfikować ustawienia grupy dotyczące dostępu wewnętrznego i zewnętrznego.
- Edytuj powiadomienia grupy.
- Skonfiguruj archiwizację dyskusji i moderowanie wiadomości.
- Dostosowywanie grup użytkowników na koncie.
Więcej sposobów na korzystanie z Google Groups lub zarządzanie innymi typami grup znajdziesz w dokumentacji Cloud Identity.
Model danych interfejsu Groups Settings API
Interfejs Groups Settings API działa na 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 grupy.
Model danych interfejsu API jest oparty na kolekcji Groups grup na koncie. Każda grupa ma unikalny zestaw ustawień konfiguracji.
Operacje w interfejsie Groups Settings API
W interfejsie Groups Settings API możesz wywoływać metody ustawień grup, jak opisano w tabeli poniżej:
| Operacja | Opis | Mapowania HTTP REST |
|---|---|---|
get |
Pobiera ustawienia grupy na koncie klienta. Wszystkie operacje „get” muszą być autoryzowane przez użytkownika, który jest uwierzytelniony. | GET w identyfikatorze URI grupy. |
update |
Zmienia ustawienia grupy na koncie klienta. Wszystkie operacje aktualizacji muszą być autoryzowane przez uwierzytelnionego użytkownika. | PUT na identyfikatorze 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 formaty danych JSON, jak i Atom obsługują pełne funkcje odczytu i zapisu.
JSON to popularny format internetowy, który umożliwia przedstawianie dowolnych struktur danych. Według strony json.org format JSON jest formatem tekstowym, który jest całkowicie niezależny od języka, ale używa konwencji znanych programistom znającym języki z rodziny C, w tym C, C++, C#, Java, JavaScript, Perl i Python.
Aby zmienić format danych interfejsu API, uwzględnij 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