Interfejs Groups Settings API aktualizuje i pobiera ustawienia istniejącej grupy dyskusyjnej Google. Za pomocą interfejsu API możesz:
- zmienić 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 dyskusyjnymi 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 zasobie Groups, który reprezentuje sposób komunikacji i współpracy między użytkownikami na koncie. Każda grupa jest identyfikowana na podstawie jej adresu e-mail.
Model danych interfejsu API wykorzystuje zbiór Groups grup na koncie. Każda grupa ma unikalny zestaw ustawień konfiguracji.
Operacje interfejsu Groups Settings API
Metody ustawień grup możesz wywoływać w interfejsie Groups Settings API w sposób opisany w tej tabeli:
| Operacja | Opis | Mapowania HTTP REST |
|---|---|---|
get |
Pobiera ustawienia grupy na koncie klienta. Wszystkie operacje get muszą być autoryzowane przez uwierzytelnione użytkownika. | GET w identyfikatorze URI grupy. |
update |
Umożliwia zaktualizowanie ustawień grupy na koncie klienta. Wszystkie operacje aktualizacji muszą być autoryzowane przez uwierzytelnione użytkownika. | PUT w 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 możliwości odczytu i zapisu.
JSON to popularny format internetowy, który umożliwia reprezentowanie dowolnych struktur danych. Według json.org format JSON jest całkowicie niezależny od języka, ale korzysta z konwencji znanych programistów z języków z rodziny C, takich jak C, C++, C#, Java, JavaScript, Perl i Python.
Aby zmienić format danych interfejsu API, umieść 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