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.
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).
Bu girişi yayınlamak için kişi listesi içerik takibi URL'sine gönderin:
application/atom+xml
içerik türünü kullanarak Atom<entry>
öğenizi yeni birPOST
isteğinin gövdesine yerleştirin.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 birHTTP 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.