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
olmadan tam senkronizasyon isteğinde bulunması gerekir.syncToken
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.
belirtildiğinde, son senkronizasyondan sonra silinen kaynaklar, syncToken
doğru değerine ayarlanmış bir kişi olarak döndürülür.PersonMetadata.deleted
veya pageToken
belirtildiğinde diğer tüm istek parametreleri ilk çağrıyla eşleşmelidir.syncToken
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 |
İsteğe bağlı. Önceki bir yanıttan ( Sayfalara ayırma işlemi sırasında, |
pageSize |
İ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 |
İsteğe bağlı. Yanıtın, sonuçların son sayfasında Senkronizasyon davranışı hakkında daha fazla bilgiyi |
syncToken |
İsteğe bağlı. Önceki bir yanıttan alınan senkronizasyon jetonu Senkronizasyon sırasında Senkronizasyon davranışı hakkında daha fazla bilgiyi |
readMask |
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:
READ_SOURCE_TYPE_PROFILE kullanılıyorsa geçerli değerler şunlardır:
|
sources[] |
İsteğe bağlı. Döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan değeri Bu alan için olası değerler şunlardır:
|
İ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 ( |
Alanlar | |
---|---|
otherContacts[] |
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 |
Sonraki sayfayı almak için |
nextSyncToken |
Son istekten sonraki değişiklikleri almak için |
totalSize |
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.