Paylaşılan kişileri al

Paylaşılan kullanıcı kişilerini aşağıdaki şekillerde isteyin:

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

Varsayılan olarak, feed'deki girişler sırasızdır.

Paylaşılan tüm kişileri alma

  1. Tüm paylaşılan kişileri almak için kişilerin feed 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. Örneğin, example.com.
    • PROJECTION: Projeksiyon değeri. Desteklenen değerler için Projeksiyon değerleri başlıklı makaleyi inceleyin.

    Sunucu, HTTP 200 OK durum kodu ve Atom 1.0 feed'i döndürür. Aşağıdaki örnekte, bir giriş içeren bir kişi feed'i gösterilmektedir:

    <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>

  2. Feed'ler tek bir yanıtta en fazla 10 MB döndürür. Listenin tamamını almak için döndürülen feed'deki Sonraki bağlantısını tekrar tekrar tıklayın.

Sorgu parametrelerini kullanarak paylaşılan kişileri alma

Belirli bir tarihten sonra güncellenenler gibi belirtilen ölçütlere uyan kişileri isteyin. Tam metin sorguları ve e-posta adresi aramaları desteklenmez. Tüm sorgu parametreleri için Domain Shared Contacts API referans kılavuzu'na bakın.

  1. Kişiler feed'i URL'sine parametre içeren bir HTTP GET isteği gönderin:

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

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

    Örneğin, example.com için 16 Mart 2022'den sonra güncellenen girişleri almak istiyorsanız updated-min parametresini ekleyin:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Sunucu, HTTP 200 OK durum kodu ve eşleşme içeren bir feed döndürür.

  2. Feed'ler tek bir yanıtta en fazla 10 MB döndürür. Listenin tamamını almak için döndürülen feed'deki Sonraki bağlantısını tekrar tekrar tıklayın.

Artımlı değişiklikleri izleme

Paylaşılan bir alan adı kişi listesinde yapılan değişiklikleri izlemek için: 1. Feed'in <updated> öğesinin değerini kaydedin. 1. updated-min değerini <updated> olarak, showdeleted değerini ise true olarak ayarlayarak değiştirilen kişileri isteyin.

Tek bir paylaşılan kişiyi alma

Belirli bir kişiyi almak için paylaşılan kişiler feed'inde bulabileceğiniz kişinin kendi bağlantısını kullanın. Daha fazla bilgi için Tüm paylaşılan kişileri alma başlıklı makaleyi inceleyin.

  1. 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 (ör. example.com).
  • PROJECTION: Projeksiyon değeri. Desteklenen değerler için Projeksiyon değerleri başlıklı makaleyi inceleyin.
  • SELF_LINK: Kişinin benzersiz sayısal değeri.

Sunucu, HTTP 200 OK durum kodunu ve kişi girişini döndürür.

Örneğin, kendi bağlantısını içeren bir kişi almak için https://www.google.com/m8/feeds/contacts/example.com/full/12345:

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

Sonraki adımlar