Method: groups.list

Pobiera wszystkie grupy domeny lub użytkownika z danym userKey (z podziałem na strony).

Żądanie HTTP

GET https://admin.googleapis.com/admin/directory/v1/groups

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
customer

string

Unikalny identyfikator konta Google Workspace klienta. W przypadku konta z wieloma domenami, aby pobrać wszystkie grupy klienta, użyj tego pola zamiast domain. Możesz też używać aliasu my_customer do reprezentowania domeny customerId Twojego konta. Element customerId jest też zwracany jako część zasobu Users. Musisz podać parametr customer lub domain.
domain

string

Nazwa domeny. Użyj tego pola, aby pobrać grupy tylko z jednej domeny. Aby zwracać wszystkie domeny z konta klienta, użyj parametru zapytania customer.
maxResults

integer

Maksymalna liczba wyników do zwrócenia. Maksymalna dozwolona wartość to 200.
orderBy

enum (OrderBy)

Kolumna używana do sortowania wyników
pageToken

string

Token do określenia następnej strony na liście
query

string

Wyszukiwanie ciągu zapytania. Powinien mieć postać „”. Pełna dokumentacja jest dostępna na stronie https: //developers.google.com/admin-sdk/directory/v1/guides/search-groups
sortOrder

enum (SortOrder)

Określa, czy wyniki mają być zwracane w kolejności rosnącej czy malejącej. Stosowany tylko wtedy, gdy jest używana również wartość orderBy.
userKey

string

Adres e-mail lub stały identyfikator użytkownika, jeśli znajduje się na liście tylko te grupy, do których należy dany użytkownik. Jeśli jest to identyfikator, powinien odpowiadać identyfikatorowi obiektu użytkownika.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "etag": string,
  "groups": [
    {
      object (Group)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

To jest rodzaj tego zasobu.
etag

string

Tag ETag zasobu.
groups[]

object (Group)

Lista obiektów grupowych.
nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony tego wyniku.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://apps-apis.google.com/a/feeds/groups/
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.group.readonly

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

PorządekDo

Wartości w polu enum
EMAIL Adres e-mail grupy.

SortOrder

Wartości w polu enum
ASCENDING Porządek rosnący.
DESCENDING Porządek malejący.