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

Paylaşılan kişileri al

Paylaşılan kullanıcı kişilerini birkaç şekilde isteyebilirsiniz:

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

Varsayılan olarak, feed'deki girişler sıralanmaz.

Paylaşılan tüm kişileri al

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; örneğin, example.com.
PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeridir. Desteklenen değerlerin listesi için Projeksiyon değerleri bölümüne bakın.

Feed, bir 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 tek girişli bir kişiler özet akışı ö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 büyük bir boyut döndürmez. Kişi listesinin tamamını almak için, döndürülen feed'in Sonraki bağlantısını, dönüş feed'inde bu bağlantıyı görmeyene kadar sürekli olarak izleyin.

Sorgu parametrelerini kullanarak paylaşılan kişileri alma

Belirli bir ölçütle eşleşen bir dizi kişi isteğinde bulunabilirsiniz. Örneğin, belirli bir tarihten sonra kişilerin güncellenmesini isteyebilirsiniz. Tam metin sorguları veya e-posta adresiyle bir kişiyi bulma desteklenmemektedir. Desteklenen sorgu parametrelerinin tam listesi için Domain Shared Contacts API başvuru kılavuzu'na bakın.

Kişiler feed'i URL'sine tanımlanmış bir parametre içeren 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; örneğin, example.com.
- PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeridir. Desteklenen değerlerin listesi için Projeksiyon değerleri bölümüne bakın.
- PARAMETER: Desteklenen sorgu parametrelerinden biridir. Daha fazla bilgi için Domain Shared Contacts API başvuru kılavuzu'na bakın.
Örneğin, alan adı paylaşılan kişi girişlerinin 16 Mart 2022'den sonra güncellenmesini sağlamak için alan adı paylaşılan kişi feed'i URL'sine bir HTTP isteği gönderin ve updated-min parametresini istek URL'sine ekleyin:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
Bu GET isteğini gönderdiğinizde, sunucu bir HTTP 200 OK durum kodu ve belirtilen tarihten sonra oluşturulmuş veya güncellenmiş olan, alanda paylaşılan tüm kişileri içeren bir feed döndürür.
Feed, tek bir yanıtta 10 MB'tan büyük bir boyut döndürmez. Belirtilen ölçütleri içeren kişi listesinin tamamını almak için döndürülen feed'in Sonraki bağlantısını, dönüş feed'inde bu bağlantıyı görmeyene kadar sürekli olarak takip edin.

Artımlı değişiklikleri izleme

Alanda paylaşılan bir kişi listesinde yapılan artımlı değişiklikleri izlemek için aşağıdakileri yapın: 1. Feed isteği gönderdiğinizde, feed'in <updated> öğesinin değerini takip edin. 1. updated-min sorgu parametresini bu <updated> değerine ve showdeleted değerini true değerine ayarlayarak yalnızca önceki istekten sonra değişen, alanda paylaşılan kişileri alabilirsiniz.

Tek bir paylaşılan kişi alın

Tek bir paylaşılan kişi almak için kişinin kendi bağlantısını kullanmanız gerekir. Paylaşılan kişinin öz bağlantısını yalnızca kişinin girişini paylaşılan kişiler özet akışında bularak alabilirsiniz. Öz bağlantı için hangi değeri kullanmanız gerektiğinden emin değilseniz Tüm kişileri alma ve Sorgu parametrelerini kullanarak kişileri alma bölümlerine bakın.

Alanda paylaşılan belirli bir kişiyi almak için kişinin kendi bağlantısına HTTP GET isteğ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; örneğin, example.com.
PROJECTION: gd:extendedProperty öğelerini belirten projeksiyon değeridir. Desteklenen değerlerin listesi için Projeksiyon değerleri bölümüne bakın.
SELF_LINK: Tek bir paylaşılan kişiyi temsil eden benzersiz bir sayısal değer (örneğin, 12345).

Sunucu daha sonra bir HTTP 200 OK durum kodu ve kişiyi içeren bir giriş döndürür.

Örneğin, öz bağlantısı https://www.google.com/m8/feeds/contacts/example.com/full/12345 olarak ayarlanmış, alanda paylaşılan bir kişi 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ı çekme