Paylaşılan kişiler oluşturma

Kimlik doğrulamayı ayarladıktan sonra, yeni paylaşılan kişi girişlerini bir Google Workspace alanında yayınlamak için Domain Shared Contacts API'yi kullanabilirsiniz. Paylaşılan kişilerin e-posta adresi otomatik tamamlama özelliğinde ve kişi yöneticisinde görünmesi 24 saati bulabilir.

  1. Yayınlamak istediğiniz paylaşılan kişinin XML temsilini, Kişi türü'nün Atom <entry> öğesi biçiminde oluşturun. Bu temsil aşağıdakine benzer şekilde görünebilir:

    <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'>
  <atom:category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <gd:name>
     <gd:givenName>FIRST_NAME</gd:givenName>
     <gd:familyName>LAST_NAME</gd:familyName>
     <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <atom:content type='text'>NOTES</atom:content>
  <gd:email rel='http://schemas.google.com/g/2005#work'
    primary='true'
    address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
  <gd:email rel='http://schemas.google.com/g/2005#home'
    address='SECONDARY_EMAIL_ADDRESS' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
    primary='true'>
    PRIMARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    SECONDARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:im address='INSTANT_MESSAGING_ADDRESS'
    protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
    primary='true'
    rel='http://schemas.google.com/g/2005#home' />
  <gd:structuredPostalAddress
      rel='http://schemas.google.com/g/2005#work'
      primary='true'>
    <gd:city>CITY_NAME</gd:city>
    <gd:street>ADDRESS</gd:street>
    <gd:region>REGION_NAME</gd:region>
    <gd:postcode>POST_CODE</gd:postcode>
    <gd:country>COUNTRY_NAME</gd:country>
    <gd:formattedAddress>
      FORMATTED_ADDRESS
    </gd:formattedAddress>
  </gd:structuredPostalAddress>
</atom:entry>

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

    • FIRST_NAME: Paylaşılan kişinin adı (ör. Ali).
    • LAST_NAME: Paylaşılan kişinin soyadı (ör. Kim).
    • PRIMARY_EMAIL_ADDRESS: Paylaşılan kişinin tercih edilen e-posta adresi (ör. alk@gmail.com).
    • PREFERRED_NAME: Kullanıcı için gösterilen ad (ör. Ali Karaman)
    • SECONDARY_EMAIL_ADDRESS: Paylaşılan kişi için başka bir e-posta adresi (ör. alk@example.org).
    • PRIMARY_PHONE_NUMBER: Paylaşılan kişi için tercih edilen telefon numarası (ör. (800) 555-0100).
    • SECONDARY_PHONE_NUMBER: Paylaşılan kişi için başka bir telefon numarası (ör. (800) 555-0101).
    • INSTANT_MESSAGING_ADDRESS: Paylaşılan kişinin anlık mesajlaşma bilgileriyle ilişkili e-posta adresi (ör. alk@gmail.com).
    • CITY_NAME: Paylaşılan kişinin şehir adı (ör. Mountain View).
    • ADDRESS: Paylaşılan kişinin açık adresi (ör. 1600 Amphibious Blvd.)
    • REGION_NAME: Paylaşılan kişinin eyaleti veya ili (ör. CA).
    • POST_CODE: Paylaşılan kişinin posta kodu (ör. 94045).
    • COUNTRY_NAME: Paylaşılan kişinin ülkesi (ör. Amerika Birleşik Devletleri).
    • FORMATTED_ADDRESS: Paylaşılan kişinin,ülkesinin veya bölgesinin kurallarına göre biçimlendirilmiş adresi (ör. 1800 Amphibious Blvd Mountain View).

  2. Bu girişi yayınlamak için kişi listesi feed'i URL'sine gönderin:

    1. application/atom+xml içerik türünü kullanarak Atom <entry> öğenizi yeni bir POST isteğinin gövdesine yerleştirin.
    2. POST isteğini feed URL'sine gönderin.

    Örneğin, example.com alanına ait listeye alan adı paylaşılan bir kişi eklemek için yeni girişi içeren POST isteğini aşağıdaki URL'ye gönderin:

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

    Google sunucusu, gönderdiğiniz girişi kullanarak bir kişi oluşturur ve ardından yeni kişinin kopyasını <entry> öğesi biçiminde HTTP 201 CREATED durum koduyla birlikte döndürür. Döndürülen giriş, gönderdiğiniz girişle aynıdır ancak sunucu tarafından eklenen çeşitli öğeleri (ör. <id> öğesi) de içerir.

    İsteğiniz başarısız olursa Google farklı bir durum kodu döndürebilir. Durum kodları hakkında bilgi edinmek için Google Data API protokolü referans belgesine bakın.

Sonraki adımlar