Method: people.connections.list

Kimliği doğrulanmış kullanıcının kişilerinin listesini sağlar.

Senkronizasyon jetonlarının süresi, tam senkronizasyondan 7 gün sonra sona erer. Süresi dolmuş bir senkronizasyon jetonu olan bir istek, "EXPIRED_SYNC_TOKEN" nedeniyle google.rpc.ErrorInfo hatası alır. Böyle bir hata söz konusu olduğunda, istemciler syncToken olmadan tam senkronizasyon isteğinde bulunmalıdır.

Tam senkronizasyon isteğinin ilk sayfasında ek bir kota vardır. Kota aşılırsa 429 hatası döndürülür. Bu kota sabittir ve artırılamaz.

syncToken belirtildiğinde, son senkronizasyondan beri silinen kaynaklar, PersonMetadata.deleted değeri "true" olarak ayarlanmış bir kişi olarak döndürülür.

pageToken veya syncToken belirtildiğinde diğer tüm istek parametreleri ilk çağrıyla eşleşmelidir.

Senkronizasyon istekleri için yazma işlemlerinde yayılma gecikmesi birkaç dakika olabilir. Ek senkronizasyonlar, yazma sonrası kullanım alanlarına yönelik değildir.

Kullanıcının değişen kişilerini listeleme başlıklı makalede örnek kullanımlara bakabilirsiniz.

HTTP isteği

GET https://people.googleapis.com/v1/{resourceName=people/*}/connections

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

Yol parametreleri

Parametreler
resourceName
(deprecated)

string

Zorunlu. Bağlantılarının döndürüleceği kaynak adı. Yalnızca people/me geçerlidir.

Sorgu parametreleri

Parametreler
pageToken

string

İsteğe bağlı. Önceki bir yanıttan (nextPageToken) alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri sağlayın.

Sayfalara ayırma işleminde, people.connections.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan ilk çağrıyla eşleşmelidir.
pageSize

integer

İsteğe bağlı. Yanıta dahil edilecek bağlantı sayısı. Geçerli değerler, 1-1000 arasındadır (bu değerler dahil). Ayarlanmazsa veya 0 olarak ayarlanırsa varsayılan olarak 100 olur.
sortOrder

enum (SortOrder)

İsteğe bağlı. Bağlantıların sıralanması gereken sıralama. Varsayılan olarak LAST_MODIFIED_ASCENDING değerine ayarlanır.
requestSyncToken

boolean

İsteğe bağlı. Yanıtın sonuçların son sayfasında nextSyncToken döndürülüp döndürülmeyeceğini belirler. Bu değer, son istekten itibaren syncToken isteğinde ayarlayarak artımlı değişiklikler almak için kullanılabilir.

Senkronizasyon davranışı hakkında daha fazla bilgiyi people.connections.list adresinde bulabilirsiniz.
syncToken

string

İsteğe bağlı. Önceki bir yanıttan alınan senkronizasyon jetonu (nextSyncToken) yalnızca son istekten sonra değiştirilen kaynakları almak için bunu sağlayın.

Senkronizasyon sırasında, people.connections.list hesabına sağlanan diğer tüm parametreler, senkronizasyon jetonunu sağlayan ilk çağrıyla eşleşmelidir.

Senkronizasyon davranışı hakkında daha fazla bilgiyi people.connections.list adresinde bulabilirsiniz.
requestMask
(deprecated)

object (RequestMask)

İsteğe bağlı. KULLANIMDAN KALDIRILDI (Lütfen bunun yerine personFields kullanın)

Sonuçları kullanıcı alanlarının bir alt kümesiyle kısıtlamak için kullanılan maske.
personFields

string (FieldMask format)

Zorunlu. Her kişideki hangi alanların döndürüleceğini kısıtlayan bir alan maskesi. Alanları virgülle ayırarak birden fazla alanı belirtebilirsiniz. Valid values are:

  • addresses
  • yaş grupları
  • biyografiler
  • doğum günleri
  • calendarUrls
  • istemciverileri
  • kapakFotoğraflar
  • e-postaAdresleri
  • etkinlikler
  • harici kimlikler
  • cinsiyetler
  • imİstemcileri
  • ilgi alanları
  • locales
  • yerler
  • memberships
  • metadata
  • ÇeşitliAnahtar Kelimeler
  • adlar
  • takma adlar
  • meslekler
  • organizations
  • telefonNumaraları
  • fotoğraflar
  • ilişkiler
  • sipAdresleri
  • beceriler
  • urller
  • kullanıcı tanımlı
sources[]

enum (ReadSourceType)

İsteğe bağlı. Döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan olarak READ_SOURCE_TYPE_CONTACT ve READ_SOURCE_TYPE_PROFILE kullanılır.

İstek metni

İstek metni boş olmalıdır.

Yanıt gövdesi

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

Kimliği doğrulanmış kullanıcının bağlantılarıyla ilgili bir isteğe verilen yanıt.

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

object (Person)

Talep edenin bağlı olduğu kullanıcıların listesi.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen jeton. Bu alan çıkarılırsa sonraki sayfalar gösterilmez.
nextSyncToken

string

Son istekten bu yana yapılan değişiklikleri almak için syncToken olarak gönderilebilen jeton. İstek, senkronizasyon jetonunu döndürecek şekilde requestSyncToken içermelidir. Yanıt sayfalara ayrıldığında yalnızca son sayfa nextSyncToken değerini içerir.
totalPeople
(deprecated)

integer

KULLANIMDAN KALDIRILDI (Lütfen totalItems'yi kullanın) Listedeki, sayfalara ayırma yapılmayan toplam kişi sayısı.
totalItems

integer

Sayfalara ayırma yapılmadan listedeki toplam öğe sayısı.

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.

SortOrder

Bir bağlantı listesinin sıralanması gerekir. Bu ad yalnızca senkronizasyon istenmediğinde kullanılır.

Sıralamalar
LAST_MODIFIED_ASCENDING Kullanıcıları değiştirildikleri zamana göre sıralayın; önce eski girişler.
LAST_MODIFIED_DESCENDING Kullanıcıları değiştirildikleri zamana göre sıralayın; önce yeni girişler.
FIRST_NAME_ASCENDING Kişileri ada göre sıralayın.
LAST_NAME_ASCENDING Kişileri soyadlarına göre sıralayın.