공유 연락처 만들기

인증을 설정한 후 Domain Shared Contacts API를 사용하여 새 공유 연락처 항목을 Google Workspace 도메인에 게시합니다. 공유 연락처가 자동 완성 및 연락처 관리자에 표시되는 데 최대 24시간이 걸릴 수 있습니다.

  1. 연락처 종류의 Atom <entry> 요소로 게시할 공유 연락처의 XML 표현을 만듭니다:

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

    다음을 바꿉니다.

    • FIRST_NAME: 연락처의 이름(예: Dana)
    • LAST_NAME: 연락처의 성(예: A)
    • PRIMARY_EMAIL_ADDRESS: 기본 이메일 주소(예: dana@example.com)
    • PREFERRED_NAME: 사용자 표시 이름(예: Dana A)
    • SECONDARY_EMAIL_ADDRESS: 보조 이메일(예: da@example.com)
    • PRIMARY_PHONE_NUMBER: 기본 전화번호(예: 800-555-0100)
    • SECONDARY_PHONE_NUMBER: 보조 전화번호(예: 800-555-0101)
    • INSTANT_MESSAGING_ADDRESS: 인스턴트 메시지 이메일 주소(예: dana@example.com)
    • CITY_NAME: 도시 이름(예: Mountain View)
    • ADDRESS: 상세 주소(예: 1800 Amphibious Blvd.)
    • REGION_NAME: 주 또는 도(예: CA)
    • POST_CODE: 우편번호(예: 94045)
    • COUNTRY_NAME: 국가(예: 미국)
    • FORMATTED_ADDRESS: 현지 규칙을 사용하여 형식이 지정된 주소(예: 1800 Amphibious Blvd.,) Mountain View, CA 94045, USA)

  2. 이 항목을 게시하려면 연락처 목록 피드 URL로 전송합니다.

    1. application/atom+xml 콘텐츠 유형을 사용하여 새 POST 요청의 본문에 Atom <entry> 요소를 배치합니다.
    2. 피드 URL로 POST 요청을 전송합니다.

    예를 들어 example.com 목록에 연락처를 추가하려면 다음 URL로 POST 요청을 전송합니다.

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

    서버에서 연락처를 만들고 새 연락처 항목과 함께 HTTP 201 CREATED 상태 코드를 반환합니다. 반환된 항목에는 서버에서 생성된 요소가 포함됩니다<id>.

    요청이 실패하면 서버에서 다른 상태 코드를 반환합니다. Google Data API 프로토콜 참조를 확인하세요. .

다음 단계