Tworzenie kontaktów udostępnionych

Po skonfigurowaniu uwierzytelniania możesz publikować nowe wpisy kontaktów udostępnionych w domenie Google Workspace za pomocą interfejsu Domain Shared Contacts API. Kontakty udostępnione pojawią się w autouzupełnianiu adresu e-mail i w menedżerze kontaktów w ciągu 24 godzin.

1. Utwórz reprezentację XML udostępnionego kontaktu, który chcesz opublikować, w postaci elementu Atom <entry> typu Contact rodzaj, który może wyglądać podobnie do tego:

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

   Zastąp następujące elementy:

   • FIRST_NAME: imię udostępnionego kontaktu, na przykład Alex.
   • LAST_NAME: nazwisko udostępnionego kontaktu, np. [Imię].
   • PRIMARY_EMAIL_ADDRESS: preferowany adres e-mail kontaktu udostępnionego – na przykład [e-mail].
   • PREFERRED_NAME: nazwa wyświetlana użytkownikowi, np. Jan Kowalski
   • SECONDARY_EMAIL_ADDRESS: inny adres e-mail kontaktu, np. [e-mail].
   • PRIMARY_PHONE_NUMBER: preferowany numer telefonu kontaktu udostępnionego, na przykład [phone].
   • SECONDARY_PHONE_NUMBER: inny numer telefonu udostępnionego kontaktu, na przykład [phone].
   • INSTANT_MESSAGING_ADDRESS: adres e-mail powiązany z informacjami o czacie udostępnionym kontaktu, na przykład [e-mail].
   • CITY_NAME: nazwa miasta udostępnionego kontaktu, np. Mountain View.
   • ADDRESS: adres udostępnianego kontaktu, np. 1600 Amphibious Blvd.
   • REGION_NAME: stan lub prowincja kontaktu udostępnionego, na przykład CA.
   • POST_CODE: kod pocztowy udostępnionego kontaktu, na przykład 94045.
   • COUNTRY_NAME: kraj kontaktu udostępnionego, np. Stany Zjednoczone.
   • FORMATTED_ADDRESS: adres udostępnionego kontaktu sformatowany zgodnie z konwencją obowiązującą w danym kraju lub regionie,na przykład 1800 Amphibious Blvd Mountain View.

2. Aby opublikować ten wpis, wyślij go na adres URL kanału listy kontaktów:

   1. Umieść element Atom <entry> w treści nowego żądania POST, korzystając z typu treści application/atom+xml.
   2. Wyślij żądanie POST na adres URL kanału.

   Aby na przykład dodać kontakt udostępniony w domenie do listy należącej do domeny example.com, wyślij żądanie POST z nowym wpisem na ten adres URL:

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

   Serwer Google tworzy kontakt, używając wysłanego wpisu, a potem zwraca kod stanu HTTP 201 CREATED i kopię nowego kontaktu w postaci elementu <entry>. Zwrócony wpis jest taki sam jak ten, który został przez Ciebie wysłany, ale zawiera też różne elementy dodane przez serwer, np. element <id>.

   Jeśli żądanie się nie powiedzie, Google może zwrócić inny kod stanu. Informacje o kodach stanu znajdziesz w dokumentacji protokołu interfejsu Google Data API.

Dalsze kroki

• Aktualizowanie i usuwanie zdjęcia udostępnionego kontaktu