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:

  • 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