Tworzenie kontaktów udostępnionych

Po konfigurowanie uwierzytelniania, interfejsu API kontaktów udostępnionych w domenie umożliwia publikowanie nowych wpisów kontaktów udostępnionych w domenę Google Workspace. Do udostępnienia kontaktów może minąć do 24 godzin pojawiają się w autouzupełnianiu i menedżerze kontaktów.

1. Utwórz reprezentację pliku XML udostępnionego kontaktu, który chcesz utworzyć opublikuj w postaci elementu Atom <entry> funkcji Rodzaj kontaktu, Może to wyglądać mniej więcej tak:

   <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 – dla na przykład Alex.
   • LAST_NAME: nazwisko udostępnionego kontakt – na przykład Kim.
   • PRIMARY_EMAIL_ADDRESS: preferowany adres e-mail adresu udostępnionego kontaktu, na przykład [e-mail].
   • PREFERRED_NAME: nazwa wyświetlana dla: użytkownika – na przykład Anna Kowalska.
   • SECONDARY_EMAIL_ADDRESS: inny adres e-mail dla kontaktu udostępnionego – na przykład [e-mail].
   • PRIMARY_PHONE_NUMBER: preferowany numer telefonu dla kontaktu udostępnionego, na przykład [phone].
   • SECONDARY_PHONE_NUMBER: inny numer telefonu do kontakt udostępniony – na przykład [phone].
   • INSTANT_MESSAGING_ADDRESS: adres e-mail z informacjami z czatu udostępnionego kontaktu – dla na przykład [e-mail].
   • CITY_NAME: nazwa miasta udostępnionego kontakt, na przykład Mountain View.
   • ADDRESS: adres miejsca contact, na przykład 1600 Amphibious Blvd.
   • REGION_NAME: stan lub województwo kontakt udostępniony – np. urząd certyfikacji.
   • POST_CODE: kod pocztowy miejsca współdzielonego kontakt – na przykład 94045.
   • COUNTRY_NAME: kraj dla udostępnionych kontakt – na przykład Polska.
   • FORMATTED_ADDRESS: adres zasobu danych kontaktowych sformatowanych zgodnie z konwencją obowiązującą w danym kraju lub region,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 elementu (POST) żądania za pomocą 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 example.com, wyślij żądanie POST z nowym wpisem na adres: Adres URL:

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

   Serwer Google tworzy kontakt przy użyciu wysłanego wpisu, a następnie zwraca kod stanu HTTP 201 CREATED wraz z kopią nowego kodu kontakt w postaci elementu <entry>. Zwrócony wpis jest taki sam który został wysłany przez Ciebie, ale zawiera też różne elementy dodane przez serwera, np. elementu <id>.

   Jeśli żądanie nie powiedzie się, Google może zwrócić inny kodu stanu. Informacje o kodach stanu można znaleźć w Dokument referencyjny protokołu Google Data API.

Dalsze kroki

• Aktualizowanie i usuwanie zdjęcia udostępnionego kontaktu