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. Wyświetlanie udostępnionych kontaktów w autouzupełnianiu adresów e-mail i w menedżerze kontaktów może potrwać do 24 godzin.

  1. Utwórz reprezentację XML udostępnionego kontaktu, który chcesz opublikować, w postaci elementu Atom <entry> rodzaju kontaktu. Może on wyglądać 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, np. Alex.
    • LAST_NAME: nazwisko udostępnionego kontaktu, np. Kim.
    • PRIMARY_EMAIL_ADDRESS: preferowany adres e-mail udostępnionego kontaktu, np. alk@gmail.com.
    • PREFERRED_NAME: wyświetlana nazwa użytkownika (np. Alex Kim).
    • SECONDARY_EMAIL_ADDRESS: inny adres e-mail udostępnionego kontaktu, np. alk@example.org.
    • PRIMARY_PHONE_NUMBER: preferowany numer telefonu do udostępnionego kontaktu, np. (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: inny numer telefonu do udostępnionego kontaktu, np. (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: adres e-mail powiązany z informacjami o udostępnionym kontakcie dotyczącymi czatów, np. alk@gmail.com.
    • CITY_NAME: nazwa miasta, w którym znajduje się udostępniony kontakt, np. Mountain View.
    • ADDRESS: adres ulicy współdzielonego kontaktu, np. 1600 Amphibious Blvd.
    • REGION_NAME: stan lub prowincja udostępnionego kontaktu, na przykład CA.
    • POST_CODE: kod pocztowy udostępnionego kontaktu, np. 94045.
    • COUNTRY_NAME: kraj, w którym znajduje się udostępniony kontakt, np. Stany Zjednoczone.
    • FORMATTED_ADDRESS: adres udostępnionego kontaktu sformatowany zgodnie z konwencją obowiązującą w danym kraju lub regionie,np. 1800 Amphibious Blvd Mountain View.

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

    1. Umieść element Atom <entry> w treści nowej prośby POST, używając typu treści application/atom+xml.
    2. Wyślij żądanie POST do adresu URL kanału.

    Aby na przykład dodać do listy należącej do domeny example.com kontakt z dostępem współdzielonym, wyślij POST z nowym wpisem pod tym adresem URL:

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

    Serwer Google tworzy kontakt na podstawie przesłanego przez Ciebie wpisu, a potem zwraca kod stanu HTTP 201 CREATED oraz kopię nowego kontaktu w postaci elementu <entry>. Zwrócony wpis jest taki sam jak wysłany, ale zawiera też różne elementy dodane przez serwer, takie jak element <id>.

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

Dalsze kroki