Method: otherContacts.list

Tüm "Diğer kişiler"i, yani bir kişi grubunda yer almayan kişileri 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 bir google.rpc.ErrorInfo hatası alacak. Bu tür bir hata söz konusu olduğunda, istemcilerin syncToken olmadan tam senkronizasyon isteğinde bulunması gerekir.

Tam senkronizasyon isteğinin ilk sayfası için ek 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 sonra silinen kaynaklar, PersonMetadata.deleted 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, yazma sonrası okuma kullanım alanlarında kullanılamaz.

Örnek kullanımı Kullanıcının değişen diğer kişilerini listeleme bölümünde görebilirsiniz.

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 bu kodu sağlayın.

Sayfalara ayırma işlemi sırasında, otherContacts.list için 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 "Diğer kişiler" 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 100'dür.
requestSyncToken

boolean

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

Senkronizasyon davranışı hakkında daha fazla bilgiyi otherContacts.list sayfasında 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 bunu sağlayın.

Senkronizasyon sırasında otherContacts.list için 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 sayfasında bulabilirsiniz.
readMask

string (FieldMask format)

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

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

  • emailAddresses
  • metadata
  • names
  • phoneNumbers
  • fotoğraflar

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

  • addresses
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • metadata
  • miscKeywords
  • names
  • takma adlar
  • meslekler
  • organizations
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urls
  • 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şiler" 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)

Kişi kaynakları olarak döndürülen "Diğer kişiler" listesi. "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 yoktur.
nextSyncToken

string

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

integer

Listedeki, sayfalara ayırmadan 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ılavuzu'na bakın.