REST Resource: groups

Kaynak: Grup

Google Gruplar, kullanıcılarınıza grubun e-posta adresini kullanarak kullanıcı gruplarına ileti gönderme olanağı sunar. Sık yapılan işlemler hakkında daha fazla bilgi için Geliştirici Kılavuzu'na bakın.

Diğer grup türleri hakkında bilgi edinmek için Cloud Identity Groups API belgelerine bakın.

Not: API'yi çağıran (veya bir hizmet hesabı tarafından kimliğine bürünen) kullanıcının, Admin API Grup izinlerini içeren bir rolüne (ör. Süper Yönetici veya Grup Yöneticisi) sahip olması gerekir.

JSON gösterimi 
{
  "id": string,
  "email": string,
  "name": string,
  "description": string,
  "adminCreated": boolean,
  "directMembersCount": string,
  "kind": string,
  "etag": string,
  "aliases": [
    string
  ],
  "nonEditableAliases": [
    string
  ]
}
Alanlar
id

string

Salt okunur. Bir grubun benzersiz kimliği. Bir grup id, grup istek URI'sinin groupKey olarak kullanılabilir.
email

string

Grubun e-posta adresi. Hesabınızda birden fazla alan varsa e-posta adresi için uygun alanı seçin. email benzersiz olmalıdır. Grup oluştururken bu özellik gereklidir. Grup e-posta adresleri, kullanıcı adlarıyla aynı karakter kullanımı kurallarına tabidir. Ayrıntılar için Yardım Merkezi'ne bakın.
name

string

Grubun görünen adı.
description

string

Kullanıcıların grubun amacını belirlemesine yardımcı olacak ayrıntılı bir açıklama. Örneğin, gruba kimlerin katılması gerektiğine ilişkin bilgileri, gruba gönderilecek ileti türlerini, grupla ilgili SSS bağlantılarını veya ilgili grupları ekleyebilirsiniz. Maksimum uzunluk 4,096 karakterdir.
adminCreated

boolean

Salt okunur. Bu grup bir kullanıcı yerine yönetici tarafından oluşturulduysa değer true olur.
directMembersCount

string (int64 format)

Grubun doğrudan üyesi olan kullanıcıların sayısı. Bir grup, bu grubun (üst grubun) üyesiyse (alt grup), alt grubun üyeleri üst grubun directMembersCount mülkünde sayılmaz.
kind

string

API kaynağının türü. Gruplar kaynakları için değer admin#directory#group'tür.
etag

string

Kaynağın ETag'i.
aliases[]

string

Salt okunur. Bir grubun takma ad e-posta adreslerinin listesi. Bir grubun takma adlarını eklemek, güncellemek veya kaldırmak için groups.aliases yöntemlerini kullanın. Bir grubun POST veya PUT isteğinde düzenlenirse düzenleme yoksayılır.
nonEditableAliases[]

string

Salt okunur. Grubun, hesabın birincil alanının veya alt alanlarının dışındaki, düzenlenemeyen takma ad e-posta adreslerinin listesi. Bunlar, grup tarafından kullanılan ve etkin e-posta adresleridir. Bu, API'nin bir grupla ilgili yanıtında döndürülen salt okunur bir özelliktir. Bir grubun POST veya PUT isteğinde düzenlenirse düzenleme yoksayılır.

Yöntemler

delete

 Grubu siler.

get

 Bir grubun özelliklerini alır.

insert

 Grup oluşturur.

list

 Bir alan adının veya kullanıcı anahtarı verilen bir kullanıcının tüm gruplarını getirir (sayfalandırılmış).

patch

 Bir grubun özelliklerini günceller.

update

 Bir grubun özelliklerini günceller.