공유 연락처 만들기

인증을 설정한 후 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: 공유된 연락처의 이름입니다(예: Alex).
   • LAST_NAME: 공유된 연락처의 성입니다(예: 김).
   • PRIMARY_EMAIL_ADDRESS: 공유된 연락처의 기본 이메일 주소입니다(예: [e-mail]).
   • PREFERRED_NAME: 사용자에게 표시되는 이름입니다(예: 앨릭스 킴).
   • SECONDARY_EMAIL_ADDRESS: 공유 연락처의 다른 이메일 주소입니다(예: [e-mail]).
   • PRIMARY_PHONE_NUMBER: 공유 연락처의 기본 전화번호입니다(예: [phone]).
   • SECONDARY_PHONE_NUMBER: 공유 연락처의 다른 전화번호입니다(예: [phone]).
   • INSTANT_MESSAGING_ADDRESS: 공유된 연락처의 인스턴트 메시지 정보와 연결된 이메일 주소입니다(예: [e-mail]).
   • CITY_NAME: 공유 연락처의 도시 이름입니다(예: 마운틴뷰).
   • ADDRESS: 공유 연락처의 상세 주소입니다(예: 1600 Amphibious Blvd).
   • REGION_NAME: 공유 연락처의 주 또는 도입니다(예: CA).
   • POST_CODE: 공유 연락처의 우편번호입니다(예: 94045).
   • COUNTRY_NAME: 공유 연락처의 국가입니다(예: 미국).
   • FORMATTED_ADDRESS: 국가 또는 지역의 관례에 따라 형식이 지정된 공유 연락처의 주소입니다(예: 1800 Amphibious Blvd Mountain View).

2. 이 항목을 게시하려면 contact-list 피드 URL로 전송합니다.

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

   예를 들어 example.com에 속한 목록에 도메인 공유 연락처를 추가하려면 새 항목이 포함된 POST 요청을 다음 URL로 전송합니다.

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

   Google 서버는 전송된 항목을 사용하여 연락처를 만든 다음 HTTP 201 CREATED 상태 코드와 함께 새 연락처 사본(<entry> 요소 형식)을 반환합니다. 반환된 항목은 전송한 항목과 동일하지만 <id> 요소와 같이 서버에서 추가한 다양한 요소도 포함되어 있습니다.

   요청이 실패하면 Google에서 다른 상태 코드를 반환할 수 있습니다. 상태 코드에 관한 자세한 내용은 Google Data API 프로토콜 참조 문서를 참고하세요.

다음 단계

• 공유 연락처의 사진을 업데이트하거나 삭제하기