Method: contactGroups.list

Kimliği doğrulanmış kullanıcının sahip olduğu tüm kişi gruplarını listeleyin. Kişi gruplarının üyeleri doldurulmaz.

HTTP isteği

GET https://people.googleapis.com/v1/contactGroups

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
pageToken

string

İsteğe bağlı. Önceki bir contactGroups.list çağrısından döndürülen nextPageToken değeri. Kaynakların sonraki sayfasını ister.

pageSize

integer

İsteğe bağlı. Döndürülecek maksimum kaynak sayısı. Geçerli değerler 1 ile 1000 arasındaki değerlerdir (1 ve 1000 dahil). Ayarlanmazsa veya 0'a ayarlanırsa varsayılan olarak 30'dur.

syncToken

string

İsteğe bağlı. contactgroups.list için yapılan önceki bir çağrı tarafından döndürülen bir senkronizasyon jetonu. Yalnızca senkronizasyon jetonunun oluşturulmasından bu yana değiştirilen kaynaklar döndürülür.

groupFields

string (FieldMask format)

İsteğe bağlı. Grupta döndürülecek alanları kısıtlamak için kullanılan bir alan maskesi. Ayarlanmazsa veya boş olarak ayarlanırsa varsayılan olarak metadata, groupType, memberCount ve name olur. Geçerli alanlar şunlardır:

  • clientData
  • groupType
  • memberCount
  • metadata
  • ad

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kişi gruplarını listeleme isteğine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "contactGroups": [
    {
      object (ContactGroup)
    }
  ],
  "totalItems": integer,
  "nextPageToken": string,
  "nextSyncToken": string
}
Alanlar
contactGroups[]

object (ContactGroup)

Kişi gruplarının listesi. Kişi gruplarının üyeleri doldurulmaz.

totalItems

integer

Listedeki, sayfalara ayırmadan elde edilen toplam öğe sayısı.

nextPageToken

string

Bir sonraki sonuç sayfasını almak için kullanılabilecek jeton.

nextSyncToken

string

Son istekten sonraki değişiklikleri almak için kullanılabilecek jeton.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.