소개
Google Data API를 사용하는 서비스가 특정 종류의 항목에 대한 일관된 정보를 제공할 수 있는 경우에 유용합니다.
예를 들어 다양한 Google 데이터 API (또는 'GData') 서비스에서 개인이나 조직의 연락처 정보를 제공할 수 있습니다. 이러한 모든 서비스에서 동일한 연락처 정보 요소를 사용하는 것이 합리적입니다.
연락처를 함께 설명하는 요소의 모음을 연락처 '종류'라고 합니다. 연락처 종류 중 일부 요소는 일반 Atom 또는 RSS 요소이며, 다른 요소는 Google에서 'Google 데이터 네임스페이스'라는 네임스페이스로 정의합니다. 규칙에 따라 Google 데이터 네임스페이스는 일반적으로 XML 코드에서 gd: 별칭을 사용하여 참조됩니다. 예를 들어 전화번호 또는 팩스 번호가 포함된 요소는 <gd:phoneNumber>입니다. Google 데이터 네임스페이스의 스키마 URL은 http://schemas.google.com/g/2005입니다.
Google은 일정 (캘린더 일정을 함께 나타내는 표준화된 요소의 모음)과 메시지 (이메일 메시지, 토론 그룹 게시물 또는 기타 메시지를 나타내는 요소의 모음) 등 다른 종류도 정의합니다.
Google 데이터 네임스페이스의 일부 요소는 여러 종류에서 사용됩니다. 예를 들어 <gd:who> 요소는 사용자 (<gd:who>에서 설명)를 <gd:who> 요소가 포함된 항목과 연결합니다. 이 요소는 이벤트 종류에서 주최자, 참석자 등을 지정하는 데 사용됩니다. 또한 메시지 종류에 발신자와 수신자를 지정하는 데도 사용됩니다.
Google Data API 피드의 항목이 지정된 종류를 사용하면 scheme 속성이 "http://schemas.google.com/g/2005#kind"로 설정되고 term 속성이 스키마 URL 이름 및 종류 이름으로 설정된 <atom:category> 요소가 포함됩니다. 예를 들어 Contact 항목에는 다음과 같은 요소가 포함됩니다.
<atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
이를 통해 클라이언트는 항목에 포함된 데이터의 유형을 빠르고 쉽게 확인할 수 있습니다. 즉, 항목의 시맨틱스를 결정할 수 있습니다. 원하는 경우 Atom 대신 RSS를 사용할 수 있습니다. Atom 요소에 해당하는 RSS 요소는 프로토콜 참조 문서를 참고하세요.
이 문서는 몇 가지 일반적인 종류와 포함된 요소에 대한 참조입니다.
문서화되지 않은 요소
<atom:entry>의 표준 요소에 표준 의미가 있는 종류는 이러한 표준 요소에 관한 정보를 포함하지 않습니다. 예를 들어 <atom:id>, <atom:published>, <atom:updated> 모두 종류에 따라 표준적인 의미를 가집니다.
또한 주어진 컨텍스트에서 의미가 없는 표준 Atom 요소에 관한 정보는 포함하지 않습니다. 예를 들어 <atom:summary>는 연락처 종류에 사용되지 않으며 <atom:author>는 항목에 필수 요소 (상위 피드에 지정되지 않은 경우)이지만 연락처 종류에는 유용한 의미가 없습니다.
종류 만들기
특히 해당 종류의 일부 요소에 다른 종류가 포함되어 있으므로 특정 종류의 항목을 만들 때 포함해야 하는 정보를 정확히 파악하기 어려울 수 있습니다.
한 가지 접근 방식은 직접 종류를 구성하려고 하기보다는 Google이 제공하는 클라이언트 라이브러리를 사용하는 것입니다. 클라이언트 라이브러리는 특정 종류의 항목에 데이터를 추가하고 변경하는 다양한 방법을 제공합니다. 자세한 내용은 클라이언트 라이브러리 문서를 참조하세요.
확장성
이 문서의 정보는 종류에 대해 가능한 모든 속성 및 속성 값을 다루지는 않습니다. 서비스는 종류를 확장할 수 있으므로 특정 서비스는 이 문서에 포함되지 않은 속성과 값을 사용할 수 있습니다.
서체 규칙
이 문서의 표에서는 필수 및 선택적 요소에 다음 규칙을 사용합니다.
| 요소 이름 | 필수 요소 |
| 엘리먼트 이름? | 선택적 요소 |
| 요소 이름* | 선택적 요소, 여러 인스턴스 허용됨 |
요소와 속성은 표준 XPath 표기법으로 표시됩니다.
연락처 종류
연락처, 사람, 클럽이나 레스토랑 같은 장소, 조직 등을 나타냅니다.
카테고리 요소: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>
속성
| 속성 | 설명 |
|---|---|
atom:category* |
카테고리: @label 속성이 있는 인스턴스는 태그로 취급됩니다. @scheme 속성 사용에 관한 자세한 내용은 이 섹션의 시작 부분에 있는 참고를 참고하세요. |
atom:content |
연락처 관련 메모입니다. |
atom:link* |
관련 정보 링크 구체적으로 atom:link[@rel='alternate']는 연락처를 설명하는 HTML 페이지로 연결됩니다. |
atom:title |
연락처 이름입니다. |
gd:email* |
이메일 주소입니다. |
gd:im* |
메신저 주소. |
gd:phoneNumber* |
전화번호 및 팩스 번호입니다. |
gd:postalAddress* |
우편 주소. |
gd:organization* |
정리 |
gd:extendedProperty* |
확장 속성 |
gContact:groupMembershipInfo* |
그룹 멤버십 정보 |
gd:deleted* |
연락처 항목의 상태가 삭제되었습니다. |
예
<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gd='http://schemas.google.com/g/2005'>
<category scheme='http://schemas.google.com/g/2005#kind'
term='http://schemas.google.com/contact/2008#contact'/>
<title>Elizabeth Bennet</title>
<content>My good friend, Liz. A little quick to judge sometimes, but nice girl.</content>
<gd:email rel='http://schemas.google.com/g/2005#work' primary='true' address='liz@gmail.com'/>
<gd:email rel='http://schemas.google.com/g/2005#home' address='liz@example.org'/>
<gd:phoneNumber rel='http://schemas.google.com/g/2005#work' primary='true'>
(206)555-1212
</gd:phoneNumber>
<gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
(206)555-1213
</gd:phoneNumber>
<gd:phoneNumber rel='http://schemas.google.com/g/2005#mobile'>
(206) 555-1212
</gd:phoneNumber>
<gd:im rel='http://schemas.google.com/g/2005#home'
protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
address='liz@gmail.com'/>
<gd:postalAddress rel='http://schemas.google.com/g/2005#work' primary='true'>
1600 Amphitheatre Pkwy
Mountain View, CA 94043
</gd:postalAddress>
<gd:postalAddress rel='http://schemas.google.com/g/2005#home'>
800 Main Street
Mountain View, CA 94041
</gd:postalAddress>
<gd:organization>
<gd:orgName>Google, Inc.</gd:orgName>
<gd:orgTitle>Tech Writer</gd:orgTitle>
</gd:organization>
</entry>
이벤트 종류
캘린더 일정을 나타냅니다. 이벤트 위치는 <gd:where> 요소에 삽입되었거나 이 요소에서 연결된 연락처 종류로 표시됩니다. 이벤트 플래너와 참석자가 <gd:who> 요소에 삽입되었거나 이 요소에서 연결된 연락처 종류로 표시됩니다.
카테고리 요소: <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
속성
| 속성 | 설명 |
|---|---|
atom:author |
이 일정을 만든 사용자입니다. |
atom:category* |
카테고리: @label 속성이 있는 인스턴스는 태그로 취급됩니다. @scheme 속성 사용에 관한 자세한 내용은 이 섹션의 시작 부분에 있는 참고를 참고하세요. |
atom:content |
이벤트에 대한 자세한 설명입니다. |
atom:link* |
링크: 특히 atom:link[@rel='alternate']에서는 이벤트를 설명하는 HTML 페이지 링크를 제공합니다. |
atom:title |
이벤트의 간략한 제목입니다. |
gd:comments 중 어느 것인가요? |
댓글 피드 |
gd:eventStatus 중 어느 것인가요? |
확장 가능한 enum은 아래에 설명되어 있습니다. |
gd:recurrence 중 어느 것인가요? |
반복 규칙 |
gd:transparency 중 어느 것인가요? |
아래에 설명된 확장 가능한 enum으로, RFC 2445에 정의된 TRANSP 속성에 해당합니다. |
gd:visibility 중 어느 것인가요? |
확장 가능한 enum은 아래에 설명되어 있습니다. |
gd:when* |
이벤트 시간 startTime 및 endTime 속성을 모두 설정해야 합니다. 단, 종일 이벤트의 경우 시간 없이 날짜만 사용합니다. |
gd:when/gd:reminder* |
일정 알림 |
gd:where* |
이벤트 장소 또는 주변 명소(예: 주차) <gd:where> 요소가 피드 수준에서 지정되었지만 항목 수준에서 <gd:where> 요소가 없으면 항목은 피드 수준 <gd:where> 값을 상속합니다. |
gd:who* |
이벤트와 관련된 사용자: 주최자, 참석자, 발표자, 공연자 등 |
gd:who/gd:attendeeStatus 중 어느 것인가요? |
수락 상태입니다. |
gd:who/gd:attendeeType 중 어느 것인가요? |
참석자 유형: required 또는 optional. |
gd:where의 rel 값
| rel 값 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event이거나 지정되지 않았습니다. |
이벤트가 열리는 장소입니다. |
http://schemas.google.com/g/2005#event.alternate |
보조 위치. 기본 사이트의 화상 회의 링크가 있는 원격 사이트를 예로 들 수 있습니다. |
http://schemas.google.com/g/2005#event.parking |
근처 주차장 |
gd:eventStatus 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event.canceled |
일정이 취소되었습니다. |
http://schemas.google.com/g/2005#event.confirmed |
이벤트가 계획되어 있습니다. |
http://schemas.google.com/g/2005#event.tentative |
이벤트는 잠정적으로 예약됩니다. |
gd:Visibility 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event.confidential |
일부 독자가 이벤트를 볼 수 있도록 허용합니다. |
http://schemas.google.com/g/2005#event.default |
일정이 표시되는 캘린더 소유자의 환경설정에서 동작을 상속합니다. |
http://schemas.google.com/g/2005#event.private |
가장 적은 수의 독자가 이벤트를 볼 수 있도록 허용합니다. |
http://schemas.google.com/g/2005#event.public |
대부분의 독자가 이벤트를 볼 수 있도록 허용합니다. |
gd:transparency 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event.opaque |
일정이 캘린더에서 시간을 사용함을 나타냅니다. 일정이 한가함/바쁨 검색으로 바쁨으로 표시됩니다. |
http://schemas.google.com/g/2005#event.transparent |
일정이 캘린더에서 아무 시간도 사용되지 않음을 나타냅니다. 한가함/바쁨 검색 시 일정 시간이 바쁨으로 표시되지 않습니다. |
예
회의:
<entry xmlns:gd="http://schemas.google.com/g/2005">
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
<id>http://mycal.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
<published>2005-01-18T21:00:00Z</published>
<updated>2006-01-01T00:00:00Z</updated>
<title>Discuss BazMat API</title>
<content>We will discuss integrating GData with BazMat.</content>
<author>
<name>Jo March</name>
<email>jo@example.com</email>
</author>
<gd:when startTime='2005-01-18T21:00:00Z' endTime='2005-01-18T22:00:00Z'>
<gd:reminder minutes='15'/>
</gd:when>
<gd:where valueString='Building 41, Room X'/>
<gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
<gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
<gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>
온라인 이벤트:
<entry xmlns:gd="http://schemas.google.com/g/2005">
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
<id>http://mycal.example.com/feeds/jo/home/full/982307e797979879a</id>
<published>2005-01-18T21:00:00Z</published>
<updated>2006-01-01T00:00:00Z</updated>
<title>Online Chess Tournament</title>
<content/>
<author>
<name>Jo March</name>
<email>jo@example.com</email>
</author>
<gd:when startTime='2006-01-24T19:00:00-08:00' endTime='2006-01-24T20:00:00-08:00'>
<gd:reminder minutes='15'/>
</gd:when>
<gd:where>
<gd:entryLink>
<entry>
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
<id>http://contacts.example.com/jo/GamePhannz</id>
<published>2005-01-18T21:00:00Z</published>
<updated>2006-01-01T00:00:00Z</updated>
<title>GamePhannz Online Game Server</title>
<link rel="http://schemas.google.com/g/2005#onlineLocation" type="text/html" href="http://gamephannz.example.com/chess/138fd87e"/>
<content/>
</entry>
</gd:entryLink>
</gd:where>
<gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
<gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
<gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>
메시지 종류
이메일, 토론 그룹 게시물, 댓글과 같은 메시지를 나타냅니다.
카테고리 요소: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>
속성
| 속성 | 설명 |
|---|---|
atom:category* |
카테고리: @label 속성이 있는 인스턴스는 태그로 취급됩니다. @scheme 속성 사용에 관한 자세한 내용은 이 섹션의 시작 부분에 있는 참고를 참고하세요. @term 속성 사용에 관한 자세한 내용은 아래 표를 참고하세요. |
atom:content |
메시지 본문. |
atom:link* |
메시지 첨부파일로 이동합니다. 특히 첨부파일을 업로드하려면 <link rel="enclosure">를 사용하여 첨부파일의 콘텐츠를 Atom 미디어 컬렉션에 넣습니다. |
atom:title |
메일 제목입니다. |
gd:geoPt 중 어느 것인가요? |
메시지를 게시한 지리적 위치입니다. |
gd:rating 중 어느 것인가요? |
애플리케이션에서 정의한 품질 등급입니다. |
gd:who* |
이 메시지와 연결된 사용자입니다. 정확한 시맨틱스는 @rel 값에 따라 다릅니다. 아래 표를 참고하세요. |
카테고리 @term 값
아래의 모든 카테고리는 http://schemas.google.com/g/2005 스킴에 해당합니다.
| 용어 | 설명 |
|---|---|
http://schemas.google.com/g/2005#message.chat |
메시지는 채팅 세션의 스크립트입니다. |
http://schemas.google.com/g/2005#message.inbox |
메일이 받은편지함에 속한 것으로 표시됩니다. |
http://schemas.google.com/g/2005#message.sent |
메일이 보낸 것으로 표시됩니다. |
http://schemas.google.com/g/2005#message.spam |
메일이 스팸으로 간주됩니다. |
http://schemas.google.com/g/2005#message.starred |
메일이 별표표시된 것으로 표시됩니다. |
http://schemas.google.com/g/2005#message.unread |
메시지를 읽지 않았습니다. |
gd:who의 rel 값
| 속성 | 설명 |
|---|---|
http://schemas.google.com/g/2005#message.bcc |
메시지 숨은참조 수신자 |
http://schemas.google.com/g/2005#message.cc |
메시지 참조 수신자 |
http://schemas.google.com/g/2005#message.from |
메시지 (이메일 또는 메신저) 발신자입니다. |
http://schemas.google.com/g/2005#message.reply-to |
의도한 메시지 수신자입니다. |
http://schemas.google.com/g/2005#message.to |
기본 수신자에 메일 전송 |
예
이메일 메시지:
<entry xmlns:gd="http://schemas.google.com/g/2005">
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message.sent"/>
<author>
<name>Jo March</name>
<email>jo@example.com</email>
</author>
<id>http://mymail.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
<published>2006-01-18T21:00:00Z</published>
<updated>2006-01-18T21:00:00Z</updated>
<title>Re: Info?</title>
<content>Hi, Fritz -- The information you're looking for is on p. 47.</content>
<gd:who rel="http://schemas.google.com/g/2005#message.from">
<gd:entryLink href="http://contacts.example.com/jo/Jo"/>
</gd:who>
<gd:who rel="http://schemas.google.com/g/2005#message.to">
<gd:entryLink href="http://contacts.example.com/fritzb/FritzB"/>
</gd:who>
</entry>
Google 데이터 네임스페이스 요소 참조
이 문서의 나머지 부분에서는 해당 종류가 사용하는 요소에 관한 참조 자료로 구성됩니다.
- enum
- gdCommonProperties
- gd:댓글
- gd:삭제됨
- gd:이메일
- gd:entryLink
- gd:extendedProperty
- gd:feedLink
- gd:geoPt
- gd:im
- gd:조직
- gd:orgName
- gd:orgTitle
- gd:originalEvent
- gd:전화번호
- gd:postalAddress
- gd:rating
- gd:반복
- gd:recurrenceException
- gd:알림
- gd:when
- gd:위치
- gd:대상
열거형
일부 확장 요소는 값이 열거형 집합에서 비롯된 속성을 지정해야 합니다. 이러한 속성의 일반적인 형태는 다음과 같습니다.
<gd:propertyName value="propertyValue">
속성 값이 Google 데이터 네임스페이스에서 가져온 경우 http://schemas.google.com/g/2005#{kind}.{value} 형식을 취합니다. 예: http://schemas.google.com/g/2005#event.tentative 값 공간이 확장 가능한 경우 값도 URI 형식일 수 있습니다. 확장 값 URI에 권장되는 형식은 {스키마 URI}#{값}입니다. 예를 들면 http://www.example.com/attendeeStatus#AudioConference입니다.
gEnumConstruct =
attribute value { text },
anyAttribute*
GdCommonProperties
모든 Google 유형에 사용되는 공통 속성입니다. 스키마에 anyAttribute 및 anyElement이 있으면 공통 속성을 사용하는 모든 Google 데이터 네임스페이스 요소를 모든 네임스페이스에서 추가로 확장할 수 있습니다. 특히 gd 요소 또는 기타 Atom/RSS 요소를 다른 gd 요소 내에 중첩하는 것은 합법적입니다. 이 작업은 신중하게 수행해야 하며, 대부분의 경우 이러한 사용은 포함하는 gd 요소 유형의 명시적 속성으로 문서화되어야 합니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@xml:base |
uri |
중첩된 상대 URI의 기본을 설명하는 표준 XML 구조입니다. |
@xml:lang |
text |
중첩된 문자열의 언어입니다. |
스키마
namespace gd = "http://schemas.google.com/g/2005"
gdCommonProperties = {
atomCommonAttributes,
anyAttribute*,
(anyElement*)
}
gd:댓글
인클로징 항목에 대한 댓글 피드가 포함됩니다 (예: 캘린더 일정).
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@rel 중 어느 것인가요? |
string |
포함된 댓글의 유형입니다. 현재 일반 댓글과 리뷰 사이에는 차이가 있습니다. |
gd:feedLink 중 어느 것인가요? |
feedLink |
댓글 피드 이 피드는 Message 종류를 구현해야 합니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#regular 또는 지정되지 않음 |
사용자의 일반 댓글 |
http://schemas.google.com/g/2005#reviews |
전문가 리뷰: |
예
댓글 피드:
<gd:comments>
<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
<feed>
<id>http://example.com/Jo/posts/MyFirstPost/comments</id>
<title>My first post: comments</title>
...
<entry>
...
<content>Good post.</content>
</entry>
<entry>
...
</entry>
...
</feed>
</gd:feedLink>
</gd:comments>
리뷰 피드:
<gd:comments rel="http://schemas.google.com/g/2005#reviews">
<gd:feedLink href="http://example.com/restaurants/SanFrancisco/432432/reviews" countHint="25">
<feed>
<id>http://example.com/restaurants/SanFrancisco/432432/reviews</id>
<title>La Folie reviews</title>
...
<entry>
...
<content>Good food.</content>
<gd:rating value="5" min="1" max="5"/>
</entry>
<entry>
...
</entry>
...
</feed>
</gd:feedLink>
</gd:comments>
스키마
start = comments
comments =
element gd:comments {
gdCommonProperties,
attribute rel { xs:string }?,
(feedLink?)
}
gd:삭제됨
포함된 항목이 삭제되었음을 나타내는 마커 요소(있는 경우)
속성
없음.
스키마
start = deleted deleted = element gd:deleted
gd:이메일
포함하는 개체 (일반적으로 사람 또는 위치를 나타내는 개체)와 연결된 이메일 주소입니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@address |
xs:string |
이메일 주소입니다. |
@label 중 어느 것인가요? |
xs:string |
이 이메일 주소의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. UI에 '직장', '개인', '선호' 등의 라벨을 표시할 수 있습니다. |
@rel 중 어느 것인가요? |
xs:string |
이메일 유형을 식별하는 프로그래매틱 값입니다. 자세한 내용은 아래를 참고하세요. |
@primary 중 어느 것인가요? |
xs:boolean |
연락처 종류에 이메일 광고 확장이 여러 개 표시되는 경우 이것이 기본 이메일 확장임을 나타냅니다. 기본 이메일은 최대 1개까지 허용됩니다. 기본값은 "false"입니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#home |
|
http://schemas.google.com/g/2005#other |
집 주소와 직장이 아닌 이메일 주소 label는 실제 유형을 나타내는 데 사용할 수 있습니다. |
http://schemas.google.com/g/2005#work |
예
<gd:email address="foo@bar.example.com"/> <gd:email label="Personal" rel="http://schemas.google.com/g/2005#home" address="fubar@gmail.com" primary="true"/>
스키마
start = email
email =
element gd:email {
attribute address { xs:string },
attribute label { xs:string }?,
attribute rel { xs:string }?,
attribute primary { xs:boolean }?
}
gd:entryLink
논리적으로 중첩된 항목을 나타냅니다. 예를 들어 연락처를 나타내는 <gd:who>에는 연락처 피드의 중첩 항목이 있을 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@href 중 어느 것인가요? |
xs:string |
항목 URI를 지정합니다. 중첩된 항목이 삽입되어 있지만 연결되지 않은 경우에는 이 속성을 생략할 수 있습니다. |
@readOnly 중 어느 것인가요? |
xs:boolean |
포함된 항목이 읽기 전용인지 여부를 지정합니다. 기본값은 "false"입니다. |
@rel 중 어느 것인가요? |
xs:string |
링크 관계를 지정합니다. 서비스가 단일 항목에 대해 여러 유형의 항목 링크를 제공할 수 있습니다. <atom:link> 요소의 rel 속성과 동일한 시맨틱스 및 허용되는 값을 갖습니다. |
atom:entry 중 어느 것인가요? |
atomEntry |
항목의 콘텐츠입니다. |
제한사항
@href또는<atom:entry>중 하나 또는 둘 다가 있어야 합니다.atom:entry가 없으면 클라이언트는@href의 항목 URI에서 콘텐츠를 가져올 수 있습니다.atom:entry가 있으면 콘텐츠는 항목이 생성될 때@href에서 가져온 것과 동일해야 합니다.PUT또는POST에<gd:entryLink>가 포함되어 있고@href속성이 지정된 경우 속성 값은 링크를 만드는 데 사용됩니다.atom:entry요소도 있는 경우 이 요소는 무시됩니다.@href속성이 지정되지 않은 경우atom:entry요소는 삽입된 항목으로 저장되거나 다른 피드에 저장되고 연결됩니다. 일부 서비스는 이러한 옵션을 모두 지원하지 않을 수도 있습니다.
예
<gd:who>의 연락처 정보:
<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
<gd:entryLink href="http://gmail.com/jo/contacts/Jo">
<entry>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/g/2005#contact"/>
<id>http://gmail.com/jo/contacts/Jo</id>
<category term="user-tag" label="Google"/>
<title>Jo March</title>
<gd:email address="jo@example.com"/>
<gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
</entry>
</gd:entryLink>
</gd:who>
외부 참조 전용 (읽기 전용 항목):
<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo"> <gd:entryLink href="http://gmail.com/jo/contacts/Jo" readOnly="true"/> </gd:who>
스키마
start = entryLink
entryLink =
element gd:entryLink {
attribute href { xs:string }?,
attribute readOnly { xs:boolean }?,
(atomEntry?)
}
gd:extendedProperty
제한된 양의 맞춤 데이터를 주변을 둘러싼 항목의 보조 속성으로 저장할 수 있습니다.
anyForeignElement가 있으면 피드가 gd:extendedProperty 요소 내에 유효한 XML을 선택적으로 삽입할 수 있습니다 (value 속성과 함께 사용할 수 없음).
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@name |
xs:string |
URI로 표시되는 속성의 이름을 지정합니다. 확장 속성 URI는 보통 {scheme}#{local-name} 규칙을 따릅니다. |
@value 중 어느 것인가요? |
xs:string |
속성 값입니다. |
예
캘린더 일정의 외부 식별자:
<gd:extendedProperty name="http://www.example.com/schemas/2007#mycal.id" value="1234"></gd:extendedProperty>
연락처 항목의 추가 xml
<gd:extendedProperty name="com.google"> <some_xml>value</some_xml> </gd:extendedProperty>
스키마
start = extendedProperty
extendedProperty =
element gd:extendedProperty {
attribute name { xs:string },
attribute value { xs:string } ?,
(anyForeignElement*)
}
gd:feedLink
논리적으로 중첩된 피드를 나타냅니다. 예를 들어 캘린더 피드에는 항목의 모든 댓글을 나타내는 중첩된 피드가 있을 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@countHint 중 어느 것인가요? |
xs:unsignedInt |
피드의 항목 수 힌트 구현에 따라 정확한 개수가 아닐 수도 있습니다. |
@href 중 어느 것인가요? |
xs:string |
피드 URI를 지정합니다. 중첩된 피드가 삽입되어 있지만 연결되지 않은 경우에는 이 속성을 생략할 수 있습니다. |
@readOnly 중 어느 것인가요? |
xs:boolean |
포함된 피드가 읽기 전용인지 여부를 지정합니다. |
@rel 중 어느 것인가요? |
xs:string |
링크 관계를 지정합니다. 서비스가 단일 항목에 여러 유형의 피드 링크를 제공할 수 있습니다. <atom:link> 요소의 rel 속성과 동일한 시맨틱스 및 허용되는 값을 갖습니다. |
atom:feed 중 어느 것인가요? |
atomFeed |
피드의 내용입니다. |
제한사항
@href또는<atom:feed>중 하나 또는 둘 다가 있어야 합니다.atom:feed가 없으면 클라이언트는@href의 URI에서 콘텐츠를 가져올 수 있습니다. 콘텐츠가 있는 경우 피드가 생성된 시점에@href에서 가져온 것과 동일한 내용이어야 합니다.- PUT 또는 POST에
<gd:feedLink>이 포함되고@href속성이 지정되면 속성 값이 연결을 생성하는 데 사용되고<atom:feed>요소도 있으면 무시됩니다.@href속성을 지정하지 않으면<atom:feed>요소가 삽입된 피드로 저장됩니다. 일부 서비스는 이러한 옵션을 모두 지원하지 않을 수도 있습니다.
예
블로그:
<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
<feed>
<id>http://example.com/Jo/posts/MyFirstPost/comments</id>
<title>My first post: comments</title>
...
<entry>
...
<content>Good post.</content>
</entry>
<entry>
...
</entry>
...
</feed>
</gd:feedLink>
외부 참조 전용:
<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments"
countHint="10"/>
목록을 나타내는 Atom 항목 내에 삽입된 피드:
<gd:feedLink>
<feed>
<id>cid:1</id>
<entry>
<id>cid:1.1</id>
<content>list item 1</content>
</entry>
<entry>
<id>cid:1.2</id>
<content>list item 2</content>
</entry>
</feed>
</gd:feedLink>
스키마
start = feedLink
feedLink =
element gd:feedLink {
attribute href { xs:string }?,
attribute readOnly { xs:boolean }?,
attribute countHint { xs:unsignedInt }?,
(atomFeed?)
}
gd:geoPt
지리적 위치 (위도, 경도, 고도)
지원 중단되었습니다. 이 요소는 지원 중단되었습니다. 위치정보 태그 지정 데이터의 경우 대신 GeoRSS를 사용합니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@elev 중 어느 것인가요? |
xs:float |
고도(미터) 음수 값은 해수면 아래의 수심을 나타냅니다. |
@label 중 어느 것인가요? |
xs:string |
이 위치의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. UI에서 '현재 위치'와 같은 라벨을 표시할 수 있습니다. |
@lat |
xs:float |
위도입니다. 양수 값은 북쪽을 의미하고 음수 값은 남쪽을 의미합니다. 범위는 [-90.0, 90.0]입니다. |
@lon |
xs:float |
경도입니다. 양수 값은 동쪽, 음수 값은 서쪽을 의미합니다. 범위는 [-180.0, 180.0]입니다. |
@time 중 어느 것인가요? |
xs:dateTime |
타임스탬프. |
예
<gd:geoPt lat="40.75" lon="-74.0"/>
<gd:geoPt lat="27.98778" lon="86.94444" elev="8850.0"/>
스키마
start = geoPt
geoPt =
element gd:geoPt {
attribute label { xs:string }?,
attribute lat { xs:float },
attribute lon { xs:float },
attribute elev { xs:float }?,
attribute time { xs:dateTime }?
}
gd:임
포함 항목과 연결된 채팅 메시지 주소입니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@address |
xs:string |
IM 주소 |
@label 중 어느 것인가요? |
xs:string |
이 IM 주소의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. UI에 '직장', '개인', '선호' 등의 라벨을 표시할 수 있습니다. |
@rel 중 어느 것인가요? |
xs:string |
IM의 유형을 식별하는 프로그래매틱 값입니다. 자세한 내용은 아래를 참조하세요. |
@protocol 중 어느 것인가요? |
xs:string |
IM 네트워크를 식별합니다. 값은 표준 값 (아래 참고) 또는 독점 IM 네트워크를 식별하는 URI 중 하나일 수 있습니다. |
@primary 중 어느 것인가요? |
xs:boolean |
연락처 종류에 여러 메신저 확장이 표시되는 경우 기본 메신저 광고 확장이 표시됩니다. 기본 메신저 메시지 개수는 최대 1개입니다. 기본값은 "false"입니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#home |
|
http://schemas.google.com/g/2005#other |
집 주소 또는 직장 주소가 아닌 IM 주소 label는 실제 유형을 나타내는 데 사용할 수 있습니다. |
http://schemas.google.com/g/2005#work |
프로토콜 속성 값
다음 표에서는 @protocol 속성에 가능한 값을 보여줍니다.
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#AIM |
AOL Instant Messenger 프로토콜 |
http://schemas.google.com/g/2005#MSN |
MSN Messenger 프로토콜 |
http://schemas.google.com/g/2005#YAHOO |
Yahoo Messenger 프로토콜 |
http://schemas.google.com/g/2005#SKYPE |
Skype 프로토콜 |
http://schemas.google.com/g/2005#QQ |
QQ 프로토콜 |
http://schemas.google.com/g/2005#GOOGLE_TALK |
Google 토크 프로토콜 |
http://schemas.google.com/g/2005#ICQ |
ICQ 프로토콜 |
http://schemas.google.com/g/2005#JABBER |
Jabber 프로토콜 |
예
MSN Messenger의 메신저 주소:
<gd:im protocol="http://schemas.google.com/g/2005#MSN" address="foo@bar.msn.com" rel="http://schemas.google.com/g/2005#home" primary="true"/>
지정되지 않은 프로토콜의 사용자 제공 IM 주소입니다. 이러한 주소는 표시에는 유용하지만 프로그래매틱 방식으로 처리하기는 어렵습니다.
<gd:im label="Other" address="foo@baz.example.com"/>
스키마
start = im
im =
element gd:im {
attribute address { xs:string },
attribute label { xs:string }?,
attribute rel { xs:string }?,
attribute protocol { xs:string }?,
attribute primary { xs:boolean }?
}
gd:조직
일반적으로 연락처와 연결된 조직입니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@label 중 어느 것인가요? |
xs:string |
이 조직의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. UI를 통해 '직장', '자원봉사자', '전문직 협회' 등의 라벨을 표시할 수 있습니다. |
@rel 중 어느 것인가요? |
xs:string |
조직의 유형을 식별하는 프로그래매틱 값입니다. |
@primary 중 어느 것인가요? |
xs:boolean |
연락처 종류에 여러 조직 확장이 표시되는 경우 기본 조직임을 나타냅니다. 기본 조직은 최대 한 개입니다. 기본값은 "false"입니다. |
gd:orgName 중 어느 것인가요? |
orgName |
조직의 이름입니다. |
gd:orgTitle 중 어느 것인가요? |
orgTitle |
조직 내 직책 |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#other |
작동하지 않는 조직 label는 실제 유형을 나타내는 데 사용할 수 있습니다. |
http://schemas.google.com/g/2005#work |
예
<gd:organization rel="http://schemas.google.com/g/2005#work" label="Work" primary="true"/> <gd:orgName>Google, Inc.</gd:orgName> <gd:orgTitle>Tech Writer</gd:orgTitle> </gd:organization>
스키마
start = organzation
organization =
element gd:organization {
attribute label { xs:string }?,
attribute rel { xs:string }?,
attribute primary { xs:boolean }?
orgName?,
orgTitle?,
}
gd:org 이름
조직의 이름입니다. gd:organization 요소 내에 표시되어야 합니다.
예
<gd:orgName>Google, Inc.</gd:orgName>
스키마
start = orgName
orgName =
element gd:orgName { xs:string }
gd:orgTitle
조직 내 사용자의 직책입니다. gd:organization 요소 내에 표시되어야 합니다.
예
<gd:orgTitle>President and CEO</gd:orgTitle>
스키마
start = orgTitle
orgTitle =
element gd:orgTitle { xs:string }
gd:원본 이벤트
RFC 2445의 섹션 4.8.4.4에 명시된 반복 ID 속성과 동일합니다. 반복 일정의 모든 인스턴스에 표시되어 원본 일정을 식별합니다.
예외가 된 인스턴스의 원래 시작 시간을 지정하는 <gd:when> 요소가 포함되어 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@id |
xs:string |
기존 이벤트의 이벤트 ID |
@href |
xs:string |
기존 이벤트의 이벤트 피드 URL입니다. |
예
기존 이벤트 지정:
<gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg" href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID"> <gd:when startTime="2006-03-17T22:00:00.000Z"/>
</gd:originalEvent>
스키마
start = originalEvent
originalEvent =
element gd:originalEvent {
attribute id { xs:string },
attribute href { xs:string },
when
}
gd:전화번호
포함하는 개체 (일반적으로 사람 또는 위치를 나타내는 개체)와 연결된 전화번호입니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@label 중 어느 것인가요? |
xs:string |
이 전화번호의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. 대부분의 경우 @label는 @rel가 번호를 식별하고 UI에 '모바일', '집', '직장' 등과 같은 적절한 라벨을 표시할 수 있으므로 필요하지 않습니다. 그러나 한 사람이 여러 휴대전화를 사용하는 경우 이 속성을 사용하여 구별할 수 있습니다. |
@rel 중 어느 것인가요? |
xs:string |
전화번호 유형을 식별하는 프로그래매틱 값입니다. 자세한 내용은 아래를 참고하세요. |
@uri 중 어느 것인가요? |
xs:string |
VoIP/PSTN 브리지와 같은 프로그래매틱 액세스에 유용하며 전화번호를 공식적으로 나타내는 데 사용되는 '텔 URI'(선택사항)입니다. 전화번호 URI에 관한 자세한 내용은 RFC 3966을 참고하세요. |
@primary 중 어느 것인가요? |
xs:boolean |
연락처 종류에 전화번호 광고 확장이 여러 개 표시되는 경우 이것이 기본 전화번호 광고 확장임을 나타냅니다. 기본 전화번호는 최대 1개입니다. 기본값은 "false"입니다. |
text() |
xs:string |
사람이 읽을 수 있는 전화번호이며, 어떤 전화번호 형식이든 사용할 수 있습니다. 선행 및 후행 공백은 중요하지 않습니다. 문자열 내의 줄바꿈도 중요하지 않으며, 삭제되거나 단일 스페이스로 병합될 수 있습니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#fax |
|
http://schemas.google.com/g/2005#home |
|
http://schemas.google.com/g/2005#home_fax |
|
http://schemas.google.com/g/2005#mobile |
|
http://schemas.google.com/g/2005#other |
다른 rel 값이 적합하지 않은 특별한 유형의 숫자입니다. TTY 기기를 예로 들 수 있습니다. label는 실제 유형을 나타내는 데 사용할 수 있습니다. |
http://schemas.google.com/g/2005#pager |
|
http://schemas.google.com/g/2005#work |
|
http://schemas.google.com/g/2005#work_fax |
예
사용자가 입력한 간단한 전화번호:
<gd:phoneNumber>(425) 555-8080 ext. 72585</gd:phoneNumber>
디렉터리에서 가져온 동일한 전화번호:
<gd:phoneNumber rel="http://schemas.google.com/g/2005#work" uri="tel:+1-425-555-8080;ext=52585"> (425) 555-8080 ext. 52585 </gd:phoneNumber>
라벨이 있는 숫자:
<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212"> +1 206 555 1212 </gd:phoneNumber>
스키마
start = phoneNumber
phoneNumber =
element gd:phoneNumber {
attribute rel { xs:string }?,
attribute label { xs:string }?,
attribute uri { xs:string }?,
attribute primary { xs:boolean }?,
(xs:string)
}
gd:postalAddress
우편 주소.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@label 중 어느 것인가요? |
xs:string |
이 주소의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. |
@rel 중 어느 것인가요? |
xs:string |
우편 주소의 유형을 식별하는 프로그래매틱 값입니다. 자세한 내용은 아래를 참고하세요. |
@primary 중 어느 것인가요? |
xs:boolean |
연락처 종류에 여러 우편 주소 확장이 표시되는 경우 기본 우편 주소가 표시됩니다. 기본 우편 주소는 1개까지만 허용됩니다. 기본값은 "false"입니다. |
text() |
xs:string |
텍스트 형식의 주소입니다. 선행 및 후행 공백은 중요하지 않습니다. 문자열 내의 줄바꿈이 중요합니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#home |
|
http://schemas.google.com/g/2005#other |
집 주소와 직장이 아닌 주소입니다. label는 실제 유형을 나타내는 데 사용할 수 있습니다. |
http://schemas.google.com/g/2005#work |
예
<gd:postalAddress> 500 West 45th Street New York, NY 10036 </gd:postalAddress>
스키마
start = postalAddress
postalAddress =
element gd:postalAddress {
attribute label { xs:string }?,
attribute rel { xs:string }?,
attribute primary { xs:boolean }?,
(xs:string)
}
gd:평점
주석과 같은 인클로징 항목의 숫자 평점을 나타냅니다. 각 등급은 서비스를 통해 정규화될 수 있지만 자체 척도를 제공합니다. 예를 들어 일부 서비스는 모든 평점을 1에서 5까지의 범위로 변환할 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@average 중 어느 것인가요? |
xs:float |
평균 평점입니다. |
@max |
xs:int |
평가 척도의 최댓값입니다. |
@min |
xs:int |
평가 척도의 최솟값입니다. |
@numRaters 중 어느 것인가요? |
xs:int |
평균값을 계산할 때 고려되는 평가 수입니다. |
@rel 중 어느 것인가요? |
xs:string |
평점을 매기는 요소를 지정합니다. 지정하지 않으면 평점이 전체 평점으로 설정됩니다. |
@value 중 어느 것인가요? |
xs:int |
평점 값입니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#overall 또는 지정되지 않음 |
전체 평점입니다. 값이 클수록 순위가 높습니다. |
http://schemas.google.com/g/2005#price |
가격 평점 값이 클수록 가격이 높습니다. |
http://schemas.google.com/g/2005#quality |
품질 평가 값이 클수록 품질이 우수합니다. |
예
4/5 전체 평점:
<gd:rating value="4" min="1" max="5"/>
가장 비싼 가격대 등급:
<gd:rating rel="http://schemas.google.com/g/2005#price" value="5" min="1" max="5"/>
사용자 200명 평점: 평균 평점 5점 만점에 4.65점
<gd:rating average="4.65" min="1" max="5" numRaters="200"/>
스키마
start = rating
rating =
element gd:rating {
gdCommonProperties,
attribute rel { xs:string }?,
attribute value { xs:int }?,
attribute average { xs:float }?,
attribute min { xs:int },
attribute max { xs:int },
attribute numRaters { xs:int }?
}
gd:반복
반복 일정이 발생하는 날짜와 시간을 나타냅니다.
반복을 정의하는 문자열은 속성 집합으로 구성되며, 각 속성은 iCalendar 표준 (RFC 2445)에 정의됩니다.
특히 이 문자열은 일반적으로 이벤트의 첫 번째 인스턴스의 시작 시간을 나타내는 DTSTART 속성으로 시작하고, 첫 번째 인스턴스가 끝나는 시간을 나타내는 DTEND 속성 또는 DURATION 속성으로 시작하는 경우가 많습니다. 다음으로는 반복 이벤트 및 예외 (모두 아래를 참조)를 정의하는 RRULE, RDATE, EXRULE 또는 EXDATE 속성이 있습니다. 이러한 반복 구성요소 속성에 대한 자세한 내용은 RFC 2445의 섹션 4.8.5를 참조하세요. 마지막에는 VLatLng 구성요소가 제공되며, 이전 속성에서 언급된 모든 시간대 ID에 대해 자세한 시간대 규칙을 제공합니다.
Google Calendar와 같은 Google 서비스는 일반적으로 반복 일정의 예외를 나타내기 위해 EXRULE 및 EXDATE 속성을 생성하지 않습니다. 대신 <gd:recurrenceException> 요소를 생성합니다. 하지만 Google 서비스에는 EXRULE 또는 EXDATE 속성이 포함될 수 있습니다. 예를 들어 사용자는 Calendar로 일정 및 예외를 가져올 수 있으며 가져온 일정에 EXRULE 또는 EXDATE 속성이 포함된 경우 Calendar에서는 <gd:recurrence> 요소를 전송할 때 이러한 속성을 제공합니다.
<gd:recurrenceException>를 사용하면 <gd:recurrence> 요소 검사만으로는 반복 설명에 예외가 있는지 확신할 수 없습니다. 모든 예외를 찾으려면 피드에서 <gd:recurrenceException> 요소를 찾아 <gd:originalEvent> 요소를 사용하여 <gd:recurrence> 요소와 연결하세요.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
text() |
xs:string |
반복 설명 |
예
매일 오전 6시부터 오전 7시까지 반복되는 일정 2006년 3월 14일부터 3월 21일까지의 태평양 표준시:
<gd:recurrence> DTSTART;TZID=America/Los_Angeles:20060314T060000 DURATION:PT3600S RRULE:FREQ=DAILY;UNTIL=20060321T220000Z BEGIN:VTIMEZONE TZID:America/Los_Angeles X-LIC-LOCATION:America/Los_Angeles BEGIN:STANDARD TZOFFSETFROM:-0700 TZOFFSETTO:-0800 TZNAME:PST DTSTART:19671029T020000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU END:STANDARD BEGIN:DAYLIGHT TZOFFSETFROM:-0800 TZOFFSETTO:-0700 TZNAME:PDT DTSTART:19870405T020000 RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU END:DAYLIGHT END:VTIMEZONE </gd:recurrence>
스키마
start = recurrence
recurrence =
element gd:recurrence {
(xs:string)
}
gd:recurrenceException 예외
반복 일정의 예외적인 일정, 즉 반복 일정 중 하나 이상의 측면 (예: 참석 목록, 시간, 위치)이 변경된 반복 일정 인스턴스를 나타냅니다.
이 이벤트가 예외인 원래 반복 이벤트를 지정하는 <gd:originalEvent> 요소를 포함합니다.
반복 일정의 인스턴스를 변경하면 해당 인스턴스는 예외가 됩니다. 예외는 변경한 내용에 따라 원래 반복 일정이 변경될 때 두 가지 방식 중 하나로 작동합니다.
- 댓글, 참석자, 참석자 응답을 추가, 변경 또는 삭제해도 예외가 기존 일정에 연결된 상태로 유지되며 원래 일정을 변경하면 예외가 변경됩니다.
- 예외 (시간 또는 위치 변경 등)를 변경하면 인스턴스가 '특수화'되어 더 이상 원래 이벤트와 긴밀하게 연결되지 않습니다. 기존 이벤트를 변경해도 특수한 예외는 변경되지 않습니다. 하지만 아래를 참고하세요.
예를 들어 매주 화요일과 목요일 오후 2시에 회의가 있다고 가정해 보겠습니다. 하지만 정기적으로 예정된 회의가 아닌 이번 목요일 회의의 참석자 목록을 변경하면 예외가 됩니다. 정기적으로 예정된 회의가 아닌 이번 주 목요일 회의 시간을 변경하면 회의가 전문화됩니다.
예외가 전문화되었는지 여부와 관계없이 예외를 파생한 인스턴스를 삭제하는 경우 예외가 삭제됩니다. 반복 일정의 날짜나 시간을 변경하면 모든 인스턴스가 삭제되고 새 인스턴스가 생성됩니다.
예를 들어 이번 주 목요일 회의를 전문화한 후 반복 회의를 월요일, 수요일, 금요일에 실행되도록 변경한다고 가정해 보겠습니다. 이렇게 변경하면 화요일/목요일 회의의 반복 일정(특수 모임 포함)이 모두 삭제됩니다.
반복 이벤트의 특정 인스턴스가 삭제되면 해당 인스턴스는 <gd:eventStatus>이 "http://schemas.google.com/g/2005#event.canceled"로 설정된 <gd:entryLink>가 포함된 <gd:recurrenceException>로 표시됩니다. 취소된 이벤트에 대한 자세한 내용은 RFC 2445를 참조하세요.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@specialized |
xs:boolean |
예외가 특화되었는지 여부를 나타냅니다. |
gd:entryLink |
entryLink |
예외에 대한 세부정보를 제공하는 이벤트 항목입니다. |
gd:originalEvent |
originalEvent |
예외 대상인 원래 반복 일정입니다. |
예
반복 일정에 대한 예외 (일부 항목은 명확성을 위해 짧은 기울임꼴 식별자로 대체됨):
<gd:recurrenceException specialized="true">
<gd:entryLink>
<entry>
<id>i8fl1nrv2bl57c1qgr3f0onmgg_20060317T220000Z</id>
<published>2006-03-17T23:00:00.000Z</published>
<updated>2006-03-14T21:33:12.000Z</updated>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/g/2005#event"/>
<title type="text">recurrence</title>
<content type="text"/>
<link rel="alternate" type="text/html"
href="http://www.google.com/calendar/event?eid=idString"
title="alternate"/>
<author>
<name>exception</name>
</author>
<gd:eventStatus
value="http://schemas.google.com/g/2005#event.confirmed"/>
<gd:comments>
<gd:feedLink
href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/">
<feed>
<updated>2006-03-14T21:36:23.250Z</updated>
<title type="text">Comments for: recurrence</title>
<link rel="alternate" type="text/html"
href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/"
title="alternate"/>
</feed>
</gd:feedLink>
</gd:comments>
<gd:transparency
value="http://schemas.google.com/g/2005#event.opaque "/>
<gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg"
href="http://www.google.com/calendar/feeds/userID/private-magicCookie/composite/eventID">
<gd:when startTime="2006-03-17T22:00:00.000Z"/>
</gd:originalEvent>
<gd:where valueString="Home"/>
<gd:when startTime="2006-03-17T23:00:00.000Z"
endTime="2006-03-18T00:00:00.000Z"/>
</entry>
</gd:entryLink>
</gd:recurrenceException>
스키마
start = recurrenceException
recurrenceException =
element gd:recurrenceException {
attribute specialized { xs:boolean },
(entryLink
& originalEvent)
}
gd:알림
자주 사용하는 위치: <gd:when>
포함 항목의 @startTime 또는 @dueTime 속성이 되기 전에 알림을 실행해야 하는 시간을 나타내는 시간 간격입니다. 또는 알림을 발행해야 하는 절대 시간을 지정할 수도 있습니다. 또한 시스템에서 사용자에게 알림을 보내기 위해 사용해야 하는 매체를 나타내는 알림 메서드도 지정합니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@absoluteTime 중 어느 것인가요? |
xs:dateTime |
알림을 발행해야 하는 절대 시간입니다. 일반적으로 사용자가 이전 알림을 지연하기 위해 '다시 알림' 기능을 사용할 때 사용됩니다. 시간대를 지정하지 않으면 관찰자의 현지 시간을 가정합니다. |
@method 중 어느 것인가요? |
xs:string |
리마인더에서 사용할 알림 메서드입니다. alert (사용자가 브라우저에서 캘린더를 볼 때 알림이 표시되도록 함), email (사용자에게 이메일 메시지 전송) 또는 sms (사용자에게 SMS 문자 메시지를 전송) 값을 가질 수 있습니다. |
@days 중 어느 것인가요? |
xs:unsignedInt |
gd:when/@startTime 전에 알림을 실행해야 하는 기간입니다. 상위 항목의 대상 시간이 특정 시간이 아닌 날짜라면 이러한 속성은 해당 날짜의 자정 (00:00)을 기준으로 합니다. |
@hours 중 어느 것인가요? |
xs:unsignedInt |
|
@minutes 중 어느 것인가요? |
xs:unsignedInt |
<gd:when> 항목을 만들거나 수정할 때 다음 규칙을 사용하여 특정 결과를 달성합니다.
- 사용자의 기본 알림을 사용하도록 서비스에 알리려면 속성이 없는
<gd:reminder>요소를 포함합니다. 기간을 지정하지만method속성은 지정하지 않으면 서비스에서 사용자가 지정한 기간과 함께 기본 알림 메서드를 사용합니다. - 서비스에 이벤트 알림을 보내지 않거나 이벤트를 업데이트할 때 기존 알림을 삭제하려면 서비스에
<gd:reminder>요소를 포함하지 마세요.
제한사항
@days,@hours,@minutes,@absoluteTime중 하나만 지정할 수 있습니다. 혼합 기간을 지정하려면 가장 정확한 단위로 변환합니다. 예를 들어 1시간 30분을 지정하려면@minutes="90"을 사용합니다.- 속성에 음수 값을 사용할 수 없으므로 시작 시간 이후에 알림을 받으려면
@absoluteTime를 사용해야 합니다. - 하나의 일정과 연결된 알림은 5개를 초과할 수 없습니다.
- 일정에 알림을 추가할 때
alert,email또는sms메서드를 지정하는 경우 기간도 지정해야 합니다.
예
15분 회의 리마인더:
<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"> <gd:reminder minutes="15"/> </gd:when>
위와 동일하지만 회의가 끝난 후 16분 45초에 10분 동안 다시 알림:
<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"> <gd:reminder minutes="15"/> <gd:reminder absoluteTime="2005-06-06T16:55:00-08:00"/> </gd:when>
스키마
start = reminder
reminder =
element gd:reminder {
gdCommonProperties,
attribute absoluteTime { xs:dateTime }?,
attribute method { xs:string }?,
attribute days { xs:unsignedInt }?,
attribute hours { xs:unsignedInt }?,
attribute minutes { xs:unsignedInt }?
}
gd:리소스 ID
유효한 URI가 아니어도 되므로 atom:id와 구분되는 불투명한 리소스 식별자입니다. 일부 서비스는 후속 요청을 구성할 때 사용할 별도의 식별자를 제공합니다. 정확한 사용법은 서비스별로 다릅니다.
예
<gd:resourceId>9749638</gd:resourceId>
스키마
start = resourceId
resourceId =
element gd:resourceId { xs:string }
gd:언제
기간 또는 인스턴트를 나타냅니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@endTime 중 어느 것인가요? |
xs:dateTime 또는 xs:date |
이벤트가 종료되는 시기를 설명합니다. 시간대를 지정하지 않으면 관찰자의 현지 시간대를 가정합니다. |
@startTime |
xs:dateTime 또는 xs:date |
이벤트가 시작되는 시점을 설명하거나, 이벤트가 발생하지 않을 때 (기간이 0인 이벤트인 경우) 설명합니다. 시간대를 지정하지 않으면 관찰자의 현지 시간대를 가정합니다. |
@valueString 중 어느 것인가요? |
xs:string |
이 기간을 나타내는 데 사용할 수 있는 간단한 문자열 값입니다. |
제한사항
startTime/endTime에서는xs:dateTime를xs:date과 함께 사용할 수 없습니다.endTime을 지정하지 않으면 이벤트가 즉석 실행 시간 (@startTime에 시간이 포함된 경우) 또는 1일 이벤트 (@startTime가 날짜인 경우)로 간주됩니다.
예
일일 일정:
<gd:when startTime="2005-06-06"/>
하루 일정의 대체 표현:
<gd:when startTime="2005-06-06" endTime="2005-06-07"/>
문자열 설명이 있는 2일 일정 (6월 6일 및 6월 7일):
<gd:when startTime="2005-06-06" endTime="2005-06-08" valueString="This weekend"/>
1시간 회의:
<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"/>
기간이 0인 이벤트는 다음과 같습니다.
<gd:when startTime="2005-06-06T17:00:00-08:00"/>
스키마
start = when
when =
element gd:when {
gdCommonProperties,
attribute startTime { (xs:date | xs:dateTime) },
attribute endTime { (xs:date | xs:dateTime) }?,
attribute valueString { xs:string }?
}
gd:위치
포함하는 항목과 연결된 장소 (예: 이벤트 위치)입니다. 연결 유형은 rel 속성에 따라 결정됩니다. 위치 세부정보는 삽입되거나 연결된 연락처 항목에 포함됩니다.
<gd:where> 요소는 <gd:geoPt> 요소보다 더 일반적입니다. 전자는 텍스트 설명 및/또는 Contact 항목을 사용하여 장소를 식별하고, 전자는 특정 지리적 위치를 사용하여 장소를 식별합니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@label 중 어느 것인가요? |
xs:string |
이 위치를 다른 위치와 구분하기 위해 사용자가 읽을 수 있는 라벨을 지정합니다. |
@rel 중 어느 것인가요? |
xs:string |
포함 항목과 포함된 위치 간의 관계를 지정합니다. 가능한 값 (아래 참고)은 다른 요소에 의해 정의됩니다. 예를 들어 <gd:when>는 http://schemas.google.com/g/2005#event를 정의합니다. |
@valueString 중 어느 것인가요? |
xs:string |
이 위치의 표현으로 사용할 수 있는 간단한 문자열 값입니다. |
gd:entryLink 중 어느 것인가요? |
entryLink |
위치 세부정보를 나타내는 항목입니다. 이 항목은 Contact 종류를 구현해야 합니다. |
rel 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event 또는 지정되지 않음 |
인클로징 이벤트가 발생하는 위치입니다. |
http://schemas.google.com/g/2005#event.alternate |
보조 위치. 기본 사이트의 화상 회의 링크가 있는 원격 사이트를 예로 들 수 있습니다. |
http://schemas.google.com/g/2005#event.parking |
근처에 주차장이 있습니다. |
예
일정 위치:
<gd:where valueString="Google Cafeteria (Building 40)"/>
더 복잡한 일정 위치:
<gd:where rel="http://schemas.google.com/g/2005#event" valueString="Joe's Pub">
<gd:entryLink href="http://local.example.com/10018/JoesPub">
<gd:entry>
<id>http://local.example.com/10018/JoesPub</id>
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
<content>Nice place to listen to jazz music</content>
<link href="http://www.joespub.com"/>
<gd:postalAddress>500 West 45th Street, New York, NY 10018</gd:postalAddress>
<gd:geoPt lat="40.75" lon="-74.0"/>
<gd:phoneNumber>(212) 555-1212</gd:phoneNumber>
<gd:email address="info@joespub.com"/>
</gd:entry>
</gd:entryLink>
</gd:where>
위치가 여러 개인 이벤트:
<gd:where label="Mountain View Location (main)"
valueString="Google Cafeteria (Building 40)"/>
<gd:where rel="http://schemas.google.com/g/2005#event.alternate"
label="New York Location (videoconference)"
valueString="Metropolis"/>
스키마
start = where
where =
element gd:where {
gdCommonProperties,
attribute rel { xs:string }?,
attribute label { xs:string }?,
attribute valueString { xs:string }?,
(entryLink?)
}
gd:누가
포함 항목에 연결된 사람입니다. 연결 유형은 rel 속성에 따라 결정됩니다. 사람에 관한 세부정보는 삽입된 연락처 또는 링크된 연락처 항목에 포함됩니다.
<gd:who> 요소는 이메일 발신자 및 수신자, 캘린더 일정 주최자 등을 지정하는 데 사용할 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
@email 중 어느 것인가요? |
xs:string |
이메일 주소입니다. 이 속성은 일반적으로 <gd:entryLink>가 지정되지 않은 경우에 사용됩니다. 주소는 RFC 2822의 섹션 3.4.1을 준수해야 합니다. |
@rel 중 어느 것인가요? |
xs:string |
포함 항목과 포함된 사람 간의 관계를 지정합니다. 가능한 값은 아래를 참고하세요. |
@valueString 중 어느 것인가요? |
xs:string |
이 사람을 나타내는 데 사용할 수 있는 간단한 문자열 값입니다. |
gd:attendeeStatus 중 어느 것인가요? |
gEnumConstruct |
일정 참석자의 상태입니다. 확장 가능한 enum은 아래에 설명되어 있습니다. |
gd:attendeeType 중 어느 것인가요? |
gEnumConstruct |
일정 참석자 유형입니다. 확장 가능한 enum은 아래에 설명되어 있습니다. |
gd:entryLink 중 어느 것인가요? |
entryLink |
사람 세부정보를 나타내는 항목입니다. 이 항목은 Contact 종류를 구현해야 합니다. 대부분의 경우 이 항목은 연락처 피드에서 가져옵니다. |
rel 값
@rel에 유효한 값은 <gd:who> 요소가 표시되는 종류에 따라 다릅니다.
| 가치 | 종류 | 설명 |
|---|---|---|
http://schemas.google.com/g/2005#event.attendee |
이벤트 | 일반 회의/이벤트 참석자 |
http://schemas.google.com/g/2005#event.organizer |
이벤트 | 이벤트 주최자 주최자가 참석자일 필요는 없습니다. |
http://schemas.google.com/g/2005#event.performer |
이벤트 | 공연자 http://schemas.google.com/g/2005#event.speaker와 비슷하지만 음성 전달보다 예술에 더 중점을 둡니다. |
http://schemas.google.com/g/2005#event.speaker |
이벤트 | 스피커 |
http://schemas.google.com/g/2005#message.bcc |
메시지 | 메시지 숨은참조 수신자 |
http://schemas.google.com/g/2005#message.cc |
메시지 | 메시지 참조 수신자 |
http://schemas.google.com/g/2005#message.from |
메시지 | 메시지 (이메일 또는 메신저) 발신자입니다. |
http://schemas.google.com/g/2005#message.reply-to |
메시지 | 의도한 메시지 수신자입니다. |
http://schemas.google.com/g/2005#message.to |
메시지 | 기본 수신자에 메일 전송 |
gd:attendeeType 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event.optional |
선택적 참석자입니다. |
http://schemas.google.com/g/2005#event.required |
필수 참석자입니다. |
gd:attendeeStatus 값
| 가치 | 설명 |
|---|---|
http://schemas.google.com/g/2005#event.accepted |
참석자가 수락했습니다. |
http://schemas.google.com/g/2005#event.declined |
참석자가 거절했습니다. |
http://schemas.google.com/g/2005#event.invited |
초대를 보냈지만 사용자가 수락하지 않았습니다. |
http://schemas.google.com/g/2005#event.tentative |
참석자가 잠정적으로 수락했습니다. |
예
이메일 수신자:
<gd:who rel="http://schemas.google.com/g/2005#message.from" email="jo@example.com"/> <gd:who rel="http://schemas.google.com/g/2005#message.to" valueString="Elizabeth" email="liz@example.com"/>
회의 참석자:
<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
<gd:attendeeType value="http://schemas.google.com/g/2005#event.required"/>
<gd:attendeeStatus value="http://schemas.google.com/g/2005#event.tentative"/>
<gd:entryLink href="http://gmail.com/jo/contacts/Jo">
<entry>
<id>http://gmail.com/jo/contacts/Jo</id>
<category term="user-tag" label="Google"/>
<title>Jo March</title>
<gd:email address="jo@example.com"/>
<gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
</entry>
</gd:entryLink>
</gd:who>
이벤트 주최자:
<gd:who rel="http://schemas.google.com/g/2005#event.organizer" valueString="Receptionist 41"/>
스키마
start = who
who =
element gd:who {
gdCommonProperties,
attribute rel { xs:string }?,
attribute email { xs:string }?,
attribute valueString { xsd:string }?,
(entryLink?
& element gd:attendeeType { gEnumConstruct }?
& element gd:attendeeStatus { gEnumConstruct }?)
}