Tworzenie kontaktów udostępnionych

Po skonfigurowaniu uwierzytelniania użyj interfejsu Domain Shared Contacts API, aby opublikować nowe wpisy udostępnionych kontaktów w domenie Google Workspace. Wyświetlenie kontaktów udostępnionych w autouzupełnianiu i menedżerze kontaktów może potrwać do 24 godzin.

  1. Utwórz reprezentację XML kontaktu udostępnionego, aby opublikować ją jako element Atom <entry>rodzaju kontaktu:

    <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ę osoby kontaktowej, np. Dana.
    • LAST_NAME: nazwisko osoby kontaktowej, np. A.
    • PRIMARY_EMAIL_ADDRESS: preferowany adres e-mail, np. dana@example.com.
    • PREFERRED_NAME: nazwa wyświetlana użytkownika, np. Dana A.
    • SECONDARY_EMAIL_ADDRESS: dodatkowy adres e-mail, np. da@example.com.
    • PRIMARY_PHONE_NUMBER: preferowany numer telefonu, np. 800-555-0100.
    • SECONDARY_PHONE_NUMBER: dodatkowy numer telefonu, np. 800-555-0101.
    • INSTANT_MESSAGING_ADDRESS: czat, np. dana@example.com.
    • CITY_NAME: nazwa miasta, np. Mountain View.
    • ADDRESS: adres ulicy, np. 1800 Amphibious Blvd.
    • REGION_NAME: stan lub prowincja, np. CA.
    • POST_CODE: kod pocztowy, np. 94045.
    • COUNTRY_NAME: kraj, np. USA.
    • FORMATTED_ADDRESS: adres sformatowany zgodnie z lokalnymi konwencjami, np. 1800 Amphibious Blvd., Mountain View, CA 94045, USA.
  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, używając typu treści application/atom+xml.
    2. Wyślij żądanie POST na adres URL kanału.

    Aby na przykład dodać kontakt do listy example.com, wyślij żądanie POST na ten adres URL:

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

    Serwer tworzy kontakt i zwraca kod stanu HTTP 201 CREATED wraz z nowym wpisem kontaktu. Zwrócony wpis zawiera elementy wygenerowane przez serwer, takie jak <id>.

    Jeśli żądanie nie powiedzie się, serwer zwraca inny kod stanu. Zapoznaj się z dokumentacją protokołu Google Data API.

Dalsze kroki