Method: contactGroups.list

Kimliği doğrulanmış kullanıcının sahip olduğu tüm kişi gruplarını listeler. 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. Sonraki kaynak sayfasını ister.
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum kaynak sayısı. Geçerli değerler 1 ile 1.000 arasında (1.000 de dahil) olmalıdır. Ayarlanmazsa varsayılan olarak 30 değerine ayarlanır veya 0 değerine ayarlanırsa varsayılan değer 30'dur.
syncToken

string

İsteğe bağlı. Daha önce contactgroups.list çağrısı tarafından döndürülen bir senkronizasyon jetonu. Yalnızca senkronizasyon jetonu oluşturulduktan sonra değiştirilen kaynaklar döndürülür.
groupFields

string (FieldMask format)

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

  • clientData
  • groupType
  • memberCount
  • meta veri
  • ad

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kişi gruplarını listeleme isteğinin 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

Sayfalara ayırmadan listedeki toplam öğe sayısı.
nextPageToken

string

Sonuçların sonraki 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ılavuzunu inceleyin.