Zarządzaj grupami

Ta strona zawiera informacje o tym, jak zarządzać grupami Google za pomocą interfejsu Directory API:

  • Tworzenie grupy
  • Aktualizowanie grupy
  • Dodawanie aliasu grupy
  • Pobieranie grupy
  • Pobieranie wszystkich grup w domenie lub na koncie
  • Pobieranie wszystkich grup, do których należy użytkownik
  • Pobieranie wszystkich aliasów grup
  • Usuwanie aliasu grupy
  • Usuwanie grupy

Tworzenie grupy

Aby utworzyć grupę, użyj tego żądania POST i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. Możesz utworzyć grupę dla dowolnej domeny powiązanej z kontem. Informacje o ciągu zapytania oraz właściwościach żądań i odpowiedzi znajdziesz w metodzie groups.insert. 

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

Poniższe żądanie w formacie JSON zawiera przykładowy tekst żądania, które tworzy grupę. Adres e-mail grupy to sales_group@example.com: 

{
   "email": "sales_group@example.com",
   "name": "Sales Group",
   "description": "This is the Sales group."
}

Pomyślna odpowiedź zwraca kod stanu HTTP 201 oraz właściwości nowej grupy.

Aktualizowanie grupy

Aby zaktualizować ustawienia grupy, użyj poniższego żądania PUT i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. groupKey to adres e-mail grupy, dowolny adres e-mail aliasu grupy lub unikalny id grupy. Informacje o ciągu zapytania oraz właściwościach żądań i odpowiedzi znajdziesz w metodzie groups.update. 

PUT https://admin.googleapis.com/admin/directory/v1/groups/groupKey

Ogólnie zalecamy, aby nie używać adresu e-mail grupy jako klucza do trwałych danych, ponieważ adres e-mail może ulec zmianie.

W tym przykładzie unikalny identyfikator groupKey to nnn, a nazwa grupy to Grupa sprzedaży w Azji i Pacyfiku: 

PUT https://admin.googleapis.com/admin/directory/v1/groups/nnn

{
    "email": "sales_group@example.com",
    "name": "APAC Sales Group"
}

W prośbie o zaktualizowanie informacji wystarczy przesłać zaktualizowane informacje. Nie musisz podawać w prośbie wszystkich właściwości grupy.

Pomyślna odpowiedź zwraca kod stanu HTTP 201 oraz właściwości nowej grupy: 

{
    "kind": "directory#groups",
    "id": "group's unique ID",
    "etag": "group's unique ETag",
    "email": "sales_group@example.com",
    "name": "APAC Sales Group",
    "directMembersCount": "5",
    "description": "This is the APAC sales group.",
    "adminCreated": true,
    "aliases": [
     {
        "alias": "best_sales_group@example.com"
     }
    ],
    "nonEditableAliases: [
     {
        "alias": "liz@test.com"
     }
    ]
}

Dodawanie aliasu grupy

Aby dodać alias grupy, użyj tego żądania POST i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. groupKey to adres e-mail grupy, dowolny alias adresu e-mail grupy lub unikalny groupKey grupy.id Informacje o ciągu zapytania oraz właściwościach żądań i odpowiedzi znajdziesz w zasobie groups. 

POST https://admin.googleapis.com/admin/directory/v1/groups/groupKey/aliases

Ogólnie zalecamy, aby nie używać adresu e-mail grupy jako klucza do trwałych danych, ponieważ adres e-mail może ulec zmianie.

Poniższe żądanie JSON zawiera przykładowe żądanie utworzenia aliasu grupy. groupKey to unikalny identyfikator id grupy o postaci NNNN

POST https://admin.googleapis.com/admin/directory/v1/groups/NNNN/aliases

{
    "alias": "best_sales_group@example.com"
}

W odpowiedzi na pomyślne działanie zostanie zwrócony kod stanu HTTP 201 oraz właściwości nowego aliasu grupy.

Pobieranie grupy

Aby pobrać grupę, użyj tego żądania GET i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. groupKey to adres e-mail grupy, dowolny alias adresu e-mail grupy lub unikalny groupKey grupy.id Informacje o ciągu zapytania oraz właściwościach żądań i odpowiedzi znajdziesz w metodie groups.get. 
GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey

Ogólnie zalecamy, aby nie używać adresu e-mail grupy jako klucza do trwałych danych, ponieważ adres e-mail może ulec zmianie.

W tym przykładzie unikalny identyfikator groupKey to nnnn: 

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

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz ustawienia grupy: 

{
    "kind": "directory#groups",
    "id": "group's unique ID",
    "etag": "group's unique ETag",
    "email": "sales_group@example.com",
    "name": "APAC Sales Group",
    "directMembersCount": "5",
    "description": "This is the APAC sales group.",
    "adminCreated": true,
    "aliases": [
     {
        "alias": "best_sales_group@example.com"
     }
    ],
    "nonEditableAliases: [
     {
        "alias": "liz@test.com"
     }
    ]
}

Pobieranie wszystkich grup w domenie lub na koncie

Aby pobrać wszystkie grupy w konkretnej domenie lub na koncie, użyj tego żądania GET i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. Informacje o ciągu zapytania, właściwościach żądań i odpowiedzi znajdziesz w metodzie groups.list. Aby ułatwić czytanie, przykład zawiera łamania wierszy: 

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=domain name
&customer=my_customer or customerId&pageToken=pagination token
&maxResults=max results

Podczas pobierania wszystkich grup w domenie lub na koncie należy wziąć pod uwagę te kwestie:

  • Wszystkie grupy w subdomenie: użyj argumentu domain z nazwą domeny.
  • Wszystkie grupy na koncie: użyj argumentu customer z wartością my_customer lub customerId konta. Jako administrator konta używaj ciągu znaków my_customer, aby reprezentować customerId na Twoim koncie. Jeśli jesteś sprzedawcą i próbujesz uzyskać dostęp do konta sprzedanego klienta, użyj customerId konta sprzedanego. W przypadku wartości customerId użyj nazwy domeny podstawowej konta w prośbie operacji Pobieranie wszystkich użytkowników w domenie. Odpowiedź zawiera wartość customerId.
  • Użycie argumentów domain i customer: interfejs Directory API zwraca wszystkie grupy dla domain.
  • Nie używasz argumentów domain ani customer: interfejs Directory API zwraca wszystkie grupy powiązane z kontem my_customer. To konto customerId administratora, który wysłał prośbę.
  • Użycie argumentów customer i userKey: interfejs Directory API zwraca błąd. Musisz wysłać 2 osobne żądania z tymi argumentami.

W tym przykładzie administrator konta używa my_customer, aby poprosić o listę wszystkich grup na koncie:

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=sales.com&customer=my_customer&maxResults=2

W tym przykładzie żądanie administratora sprzedawcy zwraca wszystkie grupy na koncie sprzedawcy z uprawnieniami customerId C03az79cb. Maksymalna liczba wyników zwracanych na stronę odpowiedzi to 2. W tej odpowiedzi znajduje się nextPageToken z listą użytkowników, których dotyczy ta sprawa: 

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=sales.com&customer=C03az79cb&maxResults=2

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz grupy w porządku alfabetycznym według adresu e-mail grupy: 

{
"kind": "directory#groups",
    "groups": [
     {
      "kind": "directory#groups",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "support@sales.com",
      "name": "Sales support",
      "directMembersCount": "6",
      "description": "The sales support group",
      "adminCreated": true
     },
     {
      "kind": "directory#groups",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "travel@sales.com",
      "name": "Sales travel",
      "directMembersCount": "2",
      "description": "The travel group supporting sales",
      "adminCreated": false,
      "aliases": [
       {
         "alias": "best_sales_group@example.com"
       }
      ],
      "nonEditableAliases: [
       {
         "alias": "liz@test.com"
       }
      ]
     },
  "nextPageToken": "NNNN"
  }

Pobieranie wszystkich grup, do których należy użytkownik

Aby pobrać wszystkie grupy, w których użytkownik ma subskrypcję, użyj tego GETżądania i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. Aby ułatwić czytanie, w tym przykładzie użyto znaków łamania wiersza: 

GET https://admin.googleapis.com/admin/directory/v1/groups?userKey=user key
?pageToken=pagination token
&maxResults=maximum results per response page
  • Członkiem może być użytkownik lub grupa.
  • Wartość userKey może być podstawowym adresem e-mail użytkownika, aliasem adresu e-mail użytkownika, podstawowym adresem e-mail grupy, aliasem adresu e-mail grupy lub unikalnym id użytkownika, który można znaleźć za pomocą operacji pobierania.
  • Użytkownik lub grupa wskazana w userKey musi należeć do Twojej domeny.
  • W przypadku odpowiedzi z dużą liczbą grup użyj ciągu zapytania pageToken. W przypadku podziału na strony odpowiedź zwraca właściwość nextPageToken, która zawiera token do następnej strony wyników odpowiedzi. Kolejne żądanie używa tego tokenu jako wartości ciągu znaków zapytania pageToken.
  • Użycie argumentów customer i userKey: interfejs Directory API zwraca błąd. Musisz wysłać 2 osobne żądania z tymi argumentami.

Właściwości żądania i odpowiedzi znajdziesz w metodie groups.list.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz listę informacji o członkach:

  • Zwracane są wszystkie grupy, do których użytkownik ma subskrypcję, w tym grupy spoza jego domeny.
  • Grupy są zwracane w kolejności alfabetycznej według adresu e-mail każdej grupy.
  • W treści odpowiedzi id to unikalny identyfikator grupy.
  • W odpowiedzi lista grup spoza domeny użytkownika nie zawiera aliasów grup zewnętrznych. 
{
    "kind": "directory#groups",
    "groups": [
     {
      "kind": "directory#group",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "sales_group@example.com",
      "name": "sale group",
      "directMembersCount": "5",
      "description": "Sales group"
     },
     {
      "kind": "directory#group",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "support_group.com",
      "name": "support group",
      "directMembersCount": "5",
      "description": "Support group"
     }
  ],
   "nextPakeToken": "NNNNN"
}

Pobieranie wszystkich aliasów grup

Aby pobrać wszystkie aliasy grupy, użyj tego żądania GET i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. groupKey może być głównym adresem e-mail grupy, unikalnym adresem id grupy lub dowolnym z adresów e-mail aliasów grupy. Właściwości żądania i odpowiedzi znajdziesz w zasobie groups. 

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

Pomyślna odpowiedź zwraca kod stanu HTTP 201 oraz listę aliasów grupy.

Usuwanie aliasu grupy

Aby usunąć alias grupy, użyj tego żądania DELETE i dodaj autoryzację opisaną w artykule Autoryzowanie żądań. groupKey może być głównym adresem e-mail grupy, unikalnym adresem id lub dowolnym z aliasów adresów e-mail grupy. aliasId to alias, który jest usuwany. Właściwości żądania i odpowiedzi znajdziesz w zasobie groups: 

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey/aliases/aliasId

Pomyślna odpowiedź zwraca kod stanu HTTP 201.

Usuwanie grupy

Aby usunąć grupę, użyj podanego poniżej żądania DELETE i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. groupKey to unikalny id grupy: 

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey
Na przykład to żądanie DELETE usuwa grupę, która zawiera grupę nnnn id: 
DELETE https://admin.googleapis.com/admin/directory/v1/group/nnnn

Pomyślna odpowiedź zwraca kod stanu HTTP 200.

Gdy usuniesz grupę:

  • Wszyscy członkowie grupy zostaną usunięci. Konta użytkowników należących do członków tej grupy nie zostaną usunięte.
  • Archiwum grupy zostanie usunięte.
  • Wiadomości wysłane na adres usuniętej grupy nie są dostarczane. Zamiast tego nadawca otrzyma wiadomość o problemie z dostarczeniem.