인증을 설정한 후 Domain Shared Contacts API를 사용하여 새 공유 연락처 항목을 Google Workspace 도메인에 게시할 수 있습니다. 공유 연락처가 이메일 주소 자동 완성 및 연락처 관리자에 표시되는 데 최대 24시간이 걸릴 수 있습니다.
연락처 종류의 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
: 공유 연락처의 성입니다(예: Kim).PRIMARY_EMAIL_ADDRESS
: 공유 연락처의 기본 이메일 주소(예: alk@gmail.com)입니다.PREFERRED_NAME
: 사용자에게 표시되는 이름(예: Alex Kim)SECONDARY_EMAIL_ADDRESS
: 공유 연락처의 다른 이메일 주소(예: alk@example.org)입니다.PRIMARY_PHONE_NUMBER
: 공유 연락처의 기본 전화번호(예: (800) 555-0100)SECONDARY_PHONE_NUMBER
: 공유 연락처의 다른 전화번호(예: (800) 555-0101)INSTANT_MESSAGING_ADDRESS
: 공유 연락처의 채팅 정보에 연결된 이메일 주소(예: alk@gmail.com)입니다.CITY_NAME
: 공유 연락처의 도시 이름입니다(예: Mountain View).ADDRESS
: 공유 연락처의 상세 주소입니다(예: 1600 Amphibious Blvd).REGION_NAME
: 공유 연락처의 주/도(예: CA)입니다.POST_CODE
: 공유 연락처의 우편번호입니다(예: 94045).COUNTRY_NAME
: 공유 연락처의 국가(예: 미국)입니다.FORMATTED_ADDRESS
: 해당 국가 또는 지역의 규칙을 사용하여 형식이 지정된 공유 연락처의 주소입니다(예: 1800 Amphibious Blvd Mountain View).
이 항목을 게시하려면 연락처 목록 피드 URL로 전송하세요.
application/atom+xml
콘텐츠 유형을 사용하여 새POST
요청의 본문에 Atom<entry>
요소를 배치합니다.POST
요청을 피드 URL로 보냅니다.
예를 들어 도메인 공유 연락처를 example.com에 속한 목록에 추가하려면 새 항목과 함께
POST
요청을 다음 URL에 전송합니다.https://www.google.com/m8/feeds/contacts/example.com/full
Google 서버는 개발자가 전송한 항목을 사용하여 연락처를 만든 다음
HTTP 201 CREATED
상태 코드와 함께 새 연락처 사본을<entry>
요소 형태로 반환합니다. 반환된 항목은 전송한 항목과 동일하지만<id>
요소와 같이 서버에서 추가한 다양한 요소도 포함되어 있습니다.요청이 실패하면 Google이 다른 상태 코드를 반환할 수 있습니다. 상태 코드에 대한 자세한 내용은 Google Data API 프로토콜 참조 문서를 확인하세요.