Paylaşılan kişiler oluşturma

Kimlik doğrulamayı ayarladıktan sonra, bir Google Workspace alanında yeni paylaşılan kişi girişleri yayınlamak için Domain Shared Contacts API'yi kullanabilirsiniz. Paylaşılan kişilerin e-posta adresinin otomatik tamamlama bölümünde 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 öğe aşağıdaki gibi 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ı; örneğin, Alex.
    • LAST_NAME: Paylaşılan kişinin soyadı. Örneğin, 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. Örneğin, Alex Kim,
    • SECONDARY_EMAIL_ADDRESS: Paylaşılan kişinin başka bir e-posta adresi (örneğin, alk@example.org).
    • PRIMARY_PHONE_NUMBER: Paylaşılan kişi için tercih edilen telefon numarası. Örneğin, (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: Paylaşılan kişinin başka bir telefon numarası. Örneğin, (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ı, örneğin, İstanbul.
    • ADDRESS: Paylaşılan kişinin açık adresi. Örneğin, 1600 Amfibi Bulvarı.
    • REGION_NAME: Paylaşılan kişinin bulunduğu eyalet veya il; örneğin, CA.
    • POST_CODE: Paylaşılan kişinin posta kodu (ör. 94045).
    • COUNTRY_NAME: Paylaşılan kişinin ülkesi, örneğin ABD.
    • FORMATTED_ADDRESS: Paylaşılan kişinin,bulunduğu ülke veya bölgenin kurallarına göre biçimlendirilmiş adresi (ör. 1800 Amphibious Bulvarı Mountain View).
  2. Bu girişi yayınlamak için kişi listesi içerik takibi 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'a ait listeye alan içinde paylaşılan bir kişi eklemek için POST isteğini yeni girişle birlikte 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, ardından yeni kişinin bir kopyasıyla birlikte <entry> öğesi biçiminde bir HTTP 201 CREATED durum kodu döndürür. Döndürülen giriş, sizin gönderdiğiniz girişle aynıdır ancak aynı zamanda <id> öğesi gibi sunucu tarafından eklenen çeşitli öğeleri de içerir.

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

Sonraki adımlar