Method: otherContacts.list

Bir kişi grubunda olmayan tüm "Diğer kişiler"i listeleyin. "Diğer kişiler" genellikle etkileşimlerden otomatik olarak oluşturulan kişilerdir.

Senkronizasyon jetonlarının süresi, tam senkronizasyondan 7 gün sonra dolar. Senkronizasyon jetonu süresi dolmuş bir istek, "EXPIRED_SYNC_TOKEN" nedeniyle google.rpc.ErrorInfo hatasını alır. Böyle bir hata olması durumunda, istemciler syncToken olmadan tam senkronizasyon isteğinde bulunmalıdır.

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

syncToken belirtildiğinde, son senkronizasyondan sonra silinen kaynaklar, PersonMetadata.deleted özelliği doğru değerine 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.

Yazma işlemlerinde, senkronizasyon istekleri için birkaç dakikalık bir yayılma gecikmesi olabilir. Artımlı senkronizasyonlar, yazmadan sonra okuma özellikli kullanım alanları için tasarlanmamıştır.

Örnek kullanıma göz atmak için Kullanıcının değişen diğer kişilerini listeleme başlıklı makaleye göz atın.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
pageToken

string

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

Sayfalara ayırma işlemi sırasında otherContacts.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ı. "Diğer kişiler" sayısı yanıta dahil etmelisiniz. Geçerli değerler 1 ile 1.000 arasında (1.000 de dahil) olmalıdır. Ayarlanmazsa veya 0 değerine ayarlanırsa varsayılan olarak 100 değerine ayarlanır.
requestSyncToken

boolean

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

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

string

İsteğe bağlı. Önceki bir yanıttan alınan senkronizasyon jetonu nextSyncToken Yalnızca son istekten bu yana değiştirilen kaynakları almak için bu seçeneği sağlayın.

Senkronizasyon sırasında otherContacts.list öğesine 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 otherContacts.list adresinde bulabilirsiniz.
readMask

string (FieldMask format)

Zorunlu. Her bir kişide döndürülecek alanları kısıtlayan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Hangi değerlerin geçerli olduğu, hangi ReadSourceType'ın kullanıldığına bağlıdır.

READ_SOURCE_TYPE_CONTACT kullanılırsa geçerli değerler şunlardır:

  • emailAddresses
  • meta veri
  • isimler
  • phoneNumbers
  • fotoğraflar

READ_SOURCE_TYPE_PROFILE kullanılırsa geçerli değerler şunlardır:

  • adresler
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • meta veri
  • miscKeywords
  • isimler
  • takma adlar
  • meslekler
  • kuruluşlar
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urller
  • userDefined
sources[]

enum (ReadSourceType)

İsteğe bağlı. Döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan değeri READ_SOURCE_TYPE_CONTACT olur.

Bu alan için olası değerler şunlardır:

READ_SOURCE_TYPE_CONTACT belirtilmeden READ_SOURCE_TYPE_PROFILE değerinin belirtilmesine izin verilmez.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kimliği doğrulanmış kullanıcının "Diğer kişileri" için yapılan isteğe verilen yanıt.

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

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

object (Person)

"Diğer kişiler" listesi Personel kaynakları olarak döndürülür. "Diğer kişiler" alanların sınırlı bir alt kümesini destekler. Daha ayrıntılı bilgi için ListOtherContactsRequest.request_mask sayfasına bakın.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.
nextSyncToken

string

Son istekten sonraki değişiklikleri almak için syncToken olarak gönderilebilecek bir jeton. İsteğin, senkronizasyon jetonunu döndürmesi için requestSyncToken ayarını yapması gerekir.
totalSize

integer

Sayfalara ayırmadan listedeki diğer kişilerin toplam sayısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.