Bu sayfa, Cloud Translation API ile çevrilmiştir.

Paylaşılan kişileri al

Paylaşılan kullanıcı kişilerini çeşitli şekillerde isteyebilirsiniz:

Paylaşılan tüm kişiler
Belirtilen ölçütlerle eşleşen bir kişi grubu
Tek bir paylaşılan kişi
Bir kişinin fotoğrafı

Varsayılan olarak, feed'deki girişler sıralı değildir.

Paylaşılan tüm kişileri alma

Paylaşılan tüm kişileri almak için kişiler feed'i URL'sine bir HTTP GET isteği gönderin:

GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

Aşağıdakini değiştirin:

DOMAIN: Alanınızın URL'si (ör. example.com).
PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeri. Desteklenen değerlerin listesi için Projeksiyon değerleri başlıklı makaleyi inceleyin.

Feed, HTTP 200 OK durum kodu ve kişileri içeren standart bir Atom 1.0 feed'i döndürür. Aşağıda, yalnızca bir giriş içeren bir kişi feed'i örneği verilmiştir:

<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

Feed, tek bir yanıtta 10 MB'tan fazla veri döndürmez. Kişi listesinin tamamını almak için, döndürülen feed'de bu bağlantıyı görmediğinize kadar döndürülen feed'in Sonraki bağlantısını tekrar tekrar takip edin.

Sorgu parametrelerini kullanarak paylaşılan kişileri alma

Belirli bir ölçütle eşleşen bir kişi grubu isteyebilirsiniz (ör. belirli bir tarihten sonra güncellenen kişileri isteme). Tam metin sorguları veya e-posta adresine göre kişi bulma desteklenmez. Desteklenen sorgu parametrelerinin tam listesi için Domain Shared Contacts API referans kılavuzuna bakın.

Kişiler feed'i URL'sine tanımlanmış bir parametreyle HTTP GET isteği gönderin:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Aşağıdakini değiştirin:
- DOMAIN: Alanınızın URL'si (ör. example.com).
- PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeri. Desteklenen değerlerin listesi için Projeksiyon değerleri başlıklı makaleyi inceleyin.
- PARAMETER: Desteklenen sorgu parametrelerinden biri. Daha fazla bilgi için Domain Shared Contacts API referans kılavuzuna bakın.
Örneğin, example.com için 16 Mart 2022'den sonra güncellenen tüm alan adı ortak kişi girişlerini almak üzere alan adı ortak kişi feed'i URL'sine bir HTTP isteği gönderin ve istek URL'sine updated-min parametresini ekleyin:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Bu GET isteği gönderdiğinizde sunucu, bir HTTP 200 OK durum kodu ve belirtilen tarihten sonra oluşturulan veya güncellenen tüm alan paylaşılan kişilerin bulunduğu bir feed döndürür.
Feed, tek bir yanıtta 10 MB'tan fazla veri döndürmez. Belirtilen ölçütlere sahip kişi listesinin tamamını almak için, döndürülen feed'de bu bağlantıyı görmediğinize kadar döndürülen feed'in Sonraki bağlantısını tekrar tekrar takip edin.

Artımlı değişiklikleri izleme

Alan adı paylaşılan kişi listesindeki artımlı değişiklikleri izlemek için aşağıdakileri yapın: 1. Feed isteği gönderirken feed'in <updated> öğesinin değerini takip edin. 1. Sorgu parametresi updated-min'ü <updated> değerine, showdeleted parametresini ise true değerine ayarlayarak yalnızca önceki istekten bu yana değişen alan paylaşılan kişileri alabilirsiniz.

Tek bir paylaşılan kişi alma

Tek bir paylaşılan kişiyi almak için kişinin kendi bağlantısını kullanmanız gerekir. Paylaşılan kişinin kendi bağlantısını yalnızca paylaşılan kişiler feed'inde kişinin girişini bularak alabilirsiniz. Kendi kendine bağlantı için hangi değeri kullanacağınızdan emin değilseniz Tüm kişileri alma ve Sorgu parametrelerini kullanarak kişileri alma başlıklı makalelere bakın.

Belirli bir alan adı paylaşılan kişiyi almak için bir kişinin kendi bağlantısına HTTP GETisteği gönderin:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
```
Aşağıdakileri değiştirin:

DOMAIN: Alanınızın URL'si (ör. example.com).
PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeri. Desteklenen değerlerin listesi için Projeksiyon değerleri başlıklı makaleyi inceleyin.
SELF_LINK: Tek bir paylaşılan kişiyi temsil eden benzersiz bir sayısal değerdir (ör. 12345).

Ardından sunucu, bir HTTP 200 OK durum kodu ve kişiyi içeren bir giriş döndürür.

Örneğin, kendi bağlantısı https://www.google.com/m8/feeds/contacts/example.com/full/12345 olarak ayarlanmış bir alan adı içinde paylaşılan kişiyi almak için aşağıdaki HTTP isteğini gönderin:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

Sonraki adımlar

Paylaşılan bir kişinin fotoğrafını alma