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

Paylaşılan kişileri al

Paylaşılan kullanıcılarla ilgili kişileri çeşitli yöntemlerle isteyebilirsiniz yöntemler:

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

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

Paylaşılan tüm kişileri al

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

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'a yönlendirilir.
PROJECTION: Projenin, gd:extendedProperty öğeleri. Desteklenen değerlerin listesi için bkz. Projeksiyon değerleri.

Feed, bir HTTP 200 OK durum kodu ve standart bir Atom 1.0 döndürür. kişileri içeren bir feed oluşturur. Aşağıda bir kişi örneği verilmiştir tek bir giriş içeren bir yayın oluşturun:

<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 dosya döndürmez. Alıcı: tüm kişi listesini almak, döndürülen feed'in Sonraki bağlantısını izlemeye devam edin.

Sorgu parametrelerini kullanarak paylaşılan kişileri alma

Belirtilen bir kişiyle eşleşen bir grup kişi için istekte bulunabilirsiniz belirli bir tarihten sonra güncellenen kişileri isteme gibi ölçütlere göre belirlenir. Hayır, tam metin sorguları veya e-posta adresiyle kişi bulma desteği. Örneğin, tam listesini görmek için bkz. Domain Shared Contacts API başvuru kılavuzu.

Tanımlanmış bir kişi feed'i URL'sine bir HTTP GET isteği gönderin parametresi:
```
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'a yönlendirilir.
- PROJECTION: Projenin, gd:extendedProperty öğeleri. Desteklenen değerlerin listesi için bkz. Projeksiyon değerleri.
- PARAMETER: Desteklenen sorgulardan biri parametreleridir. Daha fazla bilgi için bkz. Domain Shared Contacts API başvuru kılavuzu.
Örneğin, example.com için 16 Mart 2022'de, paylaşılan alana HTTP isteği gönderin iletişim feed'i URL'sine ekleyin 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ğini gönderdiğinizde sunucu bir HTTP 200 OK döndürür. ve alan adında paylaşılan ve önceden paylaşılan kişileri içeren bir belirtilen tarihten sonra oluşturulmuş veya güncellenmiş olmalıdır.
Feed, tek bir yanıtta 10 MB'tan fazla dosya döndürmez. Alıcı: belirtilen kriterlere sahip tüm kişi listesini almak, döndürülen özet akışının Sonraki bağlantısını, ilgili bağlantıyı artık görene kadar takip edin eklememiz gerekir.

Artımlı değişiklikleri izleme

Alanda paylaşılan bir kişi listesinde yapılan artımlı değişiklikleri izlemek için takip etmek için: 1. Bir yayın için istek gönderdiğinizde feed'in <updated> öğesine sahip olmayabilir. 1. Yalnızca şu tarihten sonra değişmiş olan, alanda paylaşılan kişileri alabilirsiniz sorgu parametresini ayarlayarak önceki isteği o <updated> değerine updated-min ve showdeleted - true.

Paylaşılan tek bir kişi edinme

Tek bir paylaşılan kişi almak için kişinin öz bağlantısını kullanmanız gerekir. Şunları yapabilirsiniz: paylaşılan kişinin kendi bağlantısını Paylaşılan kişiler özet akışı. Öz bağlantı için hangi değeri kullanacağınızdan emin değilseniz Tüm kişileri alma adlı makaleyi inceleyin ve Sorgu parametrelerini kullanarak kişileri alma.

Alanda paylaşılan belirli bir kişiyi almak için HTTP GET gönderin bir kişinin öz bağlantısına yönelik istek:
```
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'a yönlendirilir.
PROJECTION: gd:extendedProperty öğeleri. Desteklenen değerlerin listesi için bkz. Projeksiyon değerleri.
SELF_LINK: Hedef EBM'yi temsil eden benzersiz bir sayısal değer paylaşılan tek bir kişi (örneğin, 12345).

Sunucu, daha sonra bir HTTP 200 OK durum kodu ve ile iletişime geçin.

Örneğin, alanda paylaşılan, öz bağlantısı şu şekilde ayarlanmış bir kişi için: https://www.google.com/m8/feeds/contacts/example.com/full/12345, aşağıdaki HTTP isteğinde bulunur:

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

Sonraki adımlar

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