이 페이지는 Cloud Translation API를 통해 번역되었습니다.

공통 요소: '종류'

경고: 이 페이지는 Google의 이전 API인 Google Data API에 관한 것으로, Google Data API 디렉터리에 표시된 API 중 상당수가 최신 API로 대체된 API입니다. 특정 새 API에 대한 자세한 내용은 새 API 문서를 참조하세요. 최신 API를 사용하여 요청을 승인하는 방법은 Google 계정 인증 및 승인을 참고하세요.

소개

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

참고: Contacts API의 컨텍스트에서 Contact 종류를 사용하고 있다면 Contact API 버전 3.0부터 Contact API에서 2.0(이 문서에서 설명)을 사용합니다.

속성

속성	설명
`atom:category`*	카테고리: `@label` 속성이 있는 인스턴스는 태그로 취급됩니다. `@scheme` 속성 사용에 관한 자세한 내용은 이 섹션의 시작 부분에 있는 참고를 참고하세요.
`atom:content`	연락처 관련 메모입니다.
`atom:link`*	관련 정보 링크 구체적으로 `atom:link[@rel='alternate']`는 연락처를 설명하는 HTML 페이지로 연결됩니다.
`atom:title`	연락처 이름입니다. 읽기 전용 필드입니다. 연락처 이름을 수정하려면 `gd:name`을 참조하세요.
`gd:email`*	이메일 주소입니다.
`gd:extendedProperty`*	확장 속성
`gd:deleted` 중 어느 것인가요?	이 요소의 존재는 이 연락처 항목이 삭제되었음을 나타냅니다.
`gd:im`*	메신저 주소.
`gd:name` 중 어느 것인가요?	구조화된 양식의 연락처 이름입니다.
`gd:organization`*	정리
`gd:phoneNumber`*	전화번호 및 팩스 번호입니다.
`gd:structuredPostalAddress`*	연락처의 우편 주소를 구조화된 형식으로 나타냅니다.
`gd:where` 중 어느 것인가요?	연락처와 연결된 장소입니다.

예

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

프로필 종류

Google 사용자 또는 기타 항목과 관련된 프로필을 나타냅니다. 프로필 종류는 연락처 종류와 많은 구조를 공유합니다. 확장 속성을 포함하거나 삭제된 것으로 표시할 수 없다는 점에서 몇 가지 차이점이 있습니다.

카테고리 요소: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#profile"/>

프로필 종류가 주소록 API 버전 3.0에 도입되었습니다.

속성

속성	설명
`atom:category`*	카테고리: `@label` 속성이 있는 인스턴스는 태그로 취급됩니다. `@scheme` 속성 사용에 관한 자세한 내용은 이 섹션의 시작 부분에 있는 '카테고리 요소' 메모를 참고하세요.
`atom:content`	프로필에 대한 참고사항입니다.
`atom:link`*	관련 정보 링크 구체적으로 `atom:link[@rel='alternate']`은 프로필을 설명하는 HTML 페이지로 연결됩니다.
`atom:title`	프로필의 이름입니다. 읽기 전용 필드입니다.
`gd:email`*	이메일 주소입니다.
`gd:im`*	메신저 주소.
`gd:name` 중 어느 것인가요?	구조화된 형식의 이름입니다.
`gd:organization`*	정리
`gd:phoneNumber`*	전화번호 및 팩스 번호입니다.
`gd:structuredPostalAddress`*	구조화된 형식의 우편 주소입니다.
`gd:where` 중 어느 것인가요?	프로필과 연결된 장소

예

<entry xmlns='http://www.w3.org/2005/Atom'
xmlns:gContact='http://schemas.google.com/contact/2008'
xmlns:batch='http://schemas.google.com/gdata/batch'
xmlns:gd='http://schemas.google.com/g/2005'
  <category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#profile' />
  <title>Elizabeth Bennett</title>
  <gd:name>
    <gd:givenName>Elizabeth</gd:givenName>
    <gd:familyName>Bennett</gd:familyName>
  </gd:name>
  <gd:structuredPostalAddress rel='http://schemas.google.com/g/2005#work'>
    <gd:formattedAddress>Longbourne, Nr. Meryton, Hertfordshire, England</gd:formattedAddress>
  </gd:structuredPostalAddress>
</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:extendedProperty`*	확장 속성
`gd:originalEvent` 중 어느 것인가요?	반복 이벤트의 원래 이벤트 식별자입니다.
`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:additionalName
gd:댓글
gd:국가
gd:삭제됨
gd:이메일
gd:entryLink
gd:extendedProperty
gd:가족 이름
gd:feedLink
gd:geoPt
gd:지정된 이름
gd:im
gd:조직
gd:org 부서
gd:orgJobDescription
gd:orgName
gd:orgSymbol
gd:orgTitle
gd:originalEvent
gd:전화번호
gd:postalAddress
gd:rating
gd:반복
gd:recurrenceException
gd:알림
gd:structuredpostalAddress
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:additionalName

사용자의 추가 (예: 중간) 이름을 지정합니다. 예: '수전'

속성

속성	유형	설명
`@yomi` 중 어느 것인가요?	`xs:string`	편의 표현.
`text()`	`xs:string`	개인의 성

예

<gd:additionalName yomi="'suz@n">Susan<gd:additionalName>

스키마

start = additionalName

additionalName =
   element gd:additionalName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:댓글

인클로징 항목에 대한 댓글 피드가 포함됩니다 (예: 캘린더 일정).

속성

속성	유형	설명
`@rel` 중 어느 것인가요?	`xs: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:국가

국가 이름과 함께 국가 코드를 입력합니다. 후자는 ISO 3166-1 alpha-2에 따라 부여됩니다.

속성

속성	유형	설명
`@code` 중 어느 것인가요?	`xs:string`	ISO 3166-1 alpha-2와 같은 국가 코드입니다.
`text()`	`xs:string`	국가 이름입니다.

예

<gd:country code='PL'>Poland</gd:country>
<gd:country>Gabon</gd:country>

스키마

start = country

country =
   element gd:country {
      attribute code { xs:string }?,
      xs:string?
   }

gd:이메일

포함하는 개체 (일반적으로 사람 또는 위치를 나타내는 개체)와 연결된 이메일 주소입니다.

속성

속성	유형	설명
`@address`	`xs:string`	이메일 주소입니다.
`@displayName` 중 어느 것인가요?	`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" displayName="Foo Bar" />
<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 displayName { 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는 보통 {schema}#{local-name} 규칙을 따릅니다.
`@value` 중 어느 것인가요?	`xs:string`	속성 값입니다.
`@realm` 중 어느 것인가요?	`xs:string`	일부 API에서 확장 속성이 적용되는 위치를 지정하는 데 사용됩니다.

예

캘린더 일정의 외부 식별자:

<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*),
      attribute realm { xs:string } ?
   }

gd:가족 이름

개인의 성을 입력합니다. 예: 'Smith'.

속성

속성	유형	설명
`@yomi` 중 어느 것인가요?	`xs:string`	표음 표현.
`text()`	`xs:string`	개인의 성

예

<gd:familyName yomi="smɪð">Smith<gd:familyName>

스키마

start = familyName

familyName =
   element gd:familyName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

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#netmeeting`
`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:지정된 이름

사람의 이름을 지정합니다. 예: '존'

속성

속성	유형	설명
`@yomi` 중 어느 것인가요?	`xs:string`	표음 표현.
`text()`	`xs:string`	사용자의 이름입니다.

예

<gd:givenName yomi="dʒon">John<gd:givenName>

스키마

start = givenName

givenName =
   element gd:givenName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:금액

특정 통화로 금액을 지정합니다.

속성

속성	유형	설명
`@amount`	`xsd:float`	금액
`@currencyCode`	`xsd:string`	ISO4217 통화 코드입니다.

예

<gd:money amount='650.0' currencyCode='EUR'/>

스키마

element gd:money {
  attribute amount { xsd:float },
  attribute currencyCode { xsd:string }
}

gd:이름

사람 이름을 체계적으로 저장할 수 있습니다. 이름, 추가 이름, 성, 접두사, 접미사, 성명으로 구성됩니다.

속성

속성	유형	설명
`gd:givenName` 중 어느 것인가요?	`givenName`	사용자의 이름입니다.
`gd:additionalName` 중 어느 것인가요?	`additionalName`	사용자의 추가 이름입니다(예: 중간 이름).
`gd:familyName` 중 어느 것인가요?	`familyName`	개인의 성
`gd:namePrefix` 중 어느 것인가요?	`namePrefix`	경칭 프리픽스(예: 'Mr' 또는 'Mrs'
`gd:nameSuffix` 중 어느 것인가요?	`nameSuffix`	경어 서픽스 예: 'San' 또는 'III'.
`gd:fullName` 중 어느 것인가요?	`fullName`	이름을 구조화하지 않은 표현입니다.

예

윈스턴 레너드 스펜서 처칠 경의 구조적 표현(KG)

<gd:name>
  <gd:givenName>Winston</gd:givenName>
  <gd:additionalName>Leonard</gd:additionalName>
  <gd:familyName>Spencer-Churchill</gd:familyName>
  <gd:namePrefix>Sir</gd:namePrefix>
  <gd:nameSuffix>OG</gd:nameSuffix>
</gd:name>

스키마

start = name

name =
   element gd:name {
      givenName?
      & additionalName?
      & familyName?
      & namePrefix?
      & nameSuffix?
   }

제한사항

이름의 구조화되지 않은 구성요소는 구조화된 표현과 일치해야 합니다.

gd:조직

일반적으로 연락처와 연결된 조직입니다.

속성

속성	유형	설명
`@label` 중 어느 것인가요?	`xs:string`	이 조직의 이름을 지정하는 데 사용되는 간단한 문자열 값입니다. UI를 통해 '직장', '자원봉사자', '전문직 협회' 등의 라벨을 표시할 수 있습니다.
`gd:orgDepartment` 중 어느 것인가요?	`orgDepartment`	조직 내 부서를 지정합니다.
`gd:orgJobDescription` 중 어느 것인가요?	`orgJobDescription`	조직 내 작업에 대한 설명입니다.
`gd:orgName` 중 어느 것인가요?	`orgName`	조직의 이름입니다.
`gd:orgSymbol` 중 어느 것인가요?	`orgSymbol`	조직의 상징.
`gd:orgTitle` 중 어느 것인가요?	`orgTitle`	조직 내 직책
`@primary` 중 어느 것인가요?	`xs:boolean`	연락처 종류에 여러 조직 확장이 표시되는 경우 기본 조직임을 나타냅니다. 기본 조직은 최대 한 개입니다. 기본값은 `"false"`입니다.
`@rel` 중 어느 것인가요?	`xs:string`	조직 유형을 식별하는 프로그래매틱 값입니다. 자세한 내용은 아래를 참고하세요.
`gd:where` 중 어느 것인가요?	`where`	조직과 관련된 장소입니다(예: 사무실 위치).

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:orgJobDescription>Writes documentation</gd:orgJobDescription>
  <gd:orgDepartment>Software Development</gd:orgDepartment>
  <gd:orgSymbol>GOOG</gd:orgSymbol>
</gd:organization>

스키마

start = organization

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      ( orgDepartment? &
      orgJobDescription? &
      orgName? &
      orgSymbol? &
      orgTitle? &
      where? )
   }

gd:org 부서

조직 내 부서를 설명합니다. gd:organization 요소 내에 표시되어야 합니다.

예

<gd:orgDepartment>Research and Development</gd:orgDepartment>

스키마

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

gd:org작업 설명

조직 내의 작업을 설명합니다. gd:organization 요소 내에 표시되어야 합니다.

예

<gd:orgJobDescription>Documenting public APIs</gd:orgJobDescription>

스키마

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:org 이름

조직의 이름입니다. gd:organization 요소 내에 표시되어야 합니다.

속성

속성	설명
`@yomi` 중 어느 것인가요?	Yomigana (일본어 독서 도우미)입니다.

예

<gd:orgName>Google, Inc.</gd:orgName>

스키마

start = orgName

orgName =
   element gd:orgName {
     attribute yomi {xs:string},
     xs:string
   }

gd:orgSymbol

조직의 상징을 제공합니다. gd:organization 요소 내에 표시되어야 합니다.

예

<gd:orgSymbol>GOOG</gd:orgSymbol>

스키마

start = orgSymbol

orgSymbol = element gd:orgSymbol { 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#assistant`
`http://schemas.google.com/g/2005#callback`
`http://schemas.google.com/g/2005#car`
`http://schemas.google.com/g/2005#company_main`
`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#isdn`
`http://schemas.google.com/g/2005#main`
`http://schemas.google.com/g/2005#mobile`
`http://schemas.google.com/g/2005#other`	다른 `rel` 값이 적합하지 않은 특별한 유형의 숫자입니다. `label`는 실제 유형을 나타내는 데 사용할 수 있습니다.
`http://schemas.google.com/g/2005#other_fax`
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#radio`
`http://schemas.google.com/g/2005#telex`
`http://schemas.google.com/g/2005#tty_tdd`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`
`http://schemas.google.com/g/2005#work_mobile`
`http://schemas.google.com/g/2005#work_pager`

예

사용자가 입력한 간단한 전화번호:

<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:구조화된우편번호주소

주소로 분할된 우편 주소입니다. 주소를 독립적으로 독립적으로 저장할 수 있습니다. 필드를 해석하여 형식이 지정된 언어에 종속된 주소를 생성하는 데 사용할 수 있습니다. 주소에 에이전트, 집 이름, 도로명, 사서함, 동네, 도시, 하위 지역, 지역, 우편번호, 국가 요소가 포함되어 있습니다. subregion 요소는 우편 주소에 사용되지 않으며 주소의 확장 사용에만 제공됩니다. 구조화되지 않은 형식의 우편 주소를 저장할 수 있도록 형식이 지정된 주소 입력란을 제공하세요.

속성

속성	유형	설명
`@rel` 중 어느 것인가요?	`xs:string`	주소의 유형입니다. 지정된 `work` 유형으로 가정하지 않는 한
`@mailClass` 중 어느 것인가요?	`xs:string`	주소로 수신된 수업입니다. 지정되지 않은 경우 `both`이 가정됩니다.
`@usage` 중 어느 것인가요?	`xs:string`	이 부가기능이 사용되는 컨텍스트입니다. 로컬 주소는 일반 주소와 레이아웃이 다르고 라틴어 스크립트가 아닌 로컬 스크립트를 자주 사용하게 되지만, 일반 주소에서는 로컬 스크립트가 허용됩니다. 지정된 `general` 사용이 가정되지 않는 한
`@label` 중 어느 것인가요?	`xs:string`	주소의 일반 라벨입니다.
`@primary` 중 어느 것인가요?	`xs:boolean`	주소를 기본 주소로 지정합니다. 기본값은 `false`입니다.
`gd:agent` 중 어느 것인가요?	`agent`	메일을 실제로 수신하는 상담사 직장 주소에 사용됩니다. '전교(c/o)' 또는 'c/o'라고도 합니다.
`gd:housename` 중 어느 것인가요?	`housename`	주택 또는 건물 이름이 포함된 번호 (숫자일 필요는 없음)에 사용됩니다. 예를 들면 다음과 같습니다. 'The 기둥'.
`gd:street` 중 어느 것인가요?	`street`	도로, 거리, 도로 등일 수 있습니다. 이 요소에는 번지수, 방/아파트, 층수도 포함됩니다.
`gd:pobox` 중 어느 것인가요?	`pobox`	실제 사서함, 서랍, 자물쇠 가방 등에 대해 다룹니다. 일반적으로 도로와 항상 함께 사용되는 것은 아닙니다.
`gd:neighborhood` 중 어느 것인가요?	`neighborhood`	이는 도시에 같은 이름의 도로가 두 개 이상 있는 경우 주소를 구별하거나 더 큰 우편번호를 통해 메일이 라우팅되는 작은 장소를 지정하는 데 사용됩니다. 중국에서는 카운티 또는 작은 도시일 수 있습니다.
`gd:city` 중 어느 것인가요?	`city`	구/군/시, 자치구 등 우편 주소가 될 수 있으며 반드시 거주지나 업체가 있는 것은 아닙니다.
`gd:subregion` 중 어느 것인가요?	`subregion`	우편 주소 지정에 사용되지 않는 미국 또는 영국 카운티와 같은 행정 구역을 처리합니다. 하위 지역은 배송지 주소가 아닙니다.
`gd:region` 중 어느 것인가요?	`region`	주, 도, 카운티 (아일랜드), 토지 (독일), 출발 (프랑스) 등
`gd:postcode` 중 어느 것인가요?	`postcode`	우편번호. 일반적으로 전국을 대상으로 하지만 도시와 관련된 경우도 있습니다 (예: '더블린 2, 아일랜드' 주소의 '2').
`gd:country` 중 어느 것인가요?	`country`	국가의 이름 또는 코드입니다.
`gd:formattedAddress` 중 어느 것인가요?	`formattedAddress`	구조화되지 않은 전체 우편 주소입니다.

rel 값

가치	설명
`http://schemas.google.com/g/2005#work`	직장 주소입니다. 다른 경우가 아니라면 기본값입니다.
`http://schemas.google.com/g/2005#home`	집 주소입니다.
`http://schemas.google.com/g/2005#other`	기타 모든 유형의 주소

mailClass 값

가치	설명
`http://schemas.google.com/g/2005#both`	소포와 편지를 해당 주소로 보낼 수 있습니다. 다른 경우가 아니라면 기본값입니다.
`http://schemas.google.com/g/2005#letters`	주소로는 문자만 보낼 수 있습니다.
`http://schemas.google.com/g/2005#parcels`	상품은 소포로만 보낼 수 있습니다.
`http://schemas.google.com/g/2005#neither`	주소는 순수한 위치이므로 메일에 사용할 수 없습니다.

사용량 값

가치	설명
`http://schemas.google.com/g/2005#general`	이 주소는 일반 용도입니다. 다른 경우가 아니라면 기본값입니다.
`http://schemas.google.com/g/2005#local`	이 주소는 로컬용입니다.

예

회사 주소:

홍길동

Google Inc.

1600 Amphitheatre Parkway

Mountain View, CA 94043

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#letters' label='John at Google'>
  <gd:street>1600 Amphitheatre Parkway</gd:street>
  <gd:city>Mountain View</gd:city>
  <gd:region>CA</gd:region>
  <gd:postcode>94043</gd:postcode>
</gd:structuredPostalAddress>

비공개 주소:

마담 듀발

27, 파스퇴르 거리

14390 카부르

프랑스

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#both' label='Madame Duval'>
  <gd:street>27, rue Pasteur</gd:street>
  <gd:city>CABOURG</gd:city>
  <gd:postcode>14390</gd:postcode>
  <gd:country>FRANCE</gd:country>
</gd:structuredPostalAddress>

스키마

start = structuredPostalAddress

structuredPostalAddress =
   element gd:structuredPostalAddress {
      attribute label { xs:string }?,
      attribute mailClass { xs:string }?,
      attribute primary { xs:boolean }?,
      attribute rel { xs:string }?,
      attribute usage { xs:string }?,
      (agent?
       & housename?
       & street?
       & poBox?
       & neighborhood?
       & city?
       & subregion?
       & region?
       & postcode?
       & country?
       & formattedAddress? )
}

제한사항

하나의 항목에 'gd:postalAddress' 및 'gd:structuredpostalAddress'를 둘 다 포함할 수 없습니다.
하나의 구조화된 주소만 기본 주소로 지정할 수 있습니다.
구조화되지 않은 우편 주소는 구조화된 데이터와 일치해야 합니다.

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 { xs:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

맨 위로

1.0 이후 변경사항

연락처 종류 변경사항

버전 1.0에 없는 다음 요소는 연락처 종류 2.0에 추가되었습니다.

gd:name
gd:structuredPostalAddress
gd:where

버전 1.0에 없는 다음 휴대전화 유형이 버전 2.0에 추가되었습니다.

http://schemas.google.com/g/2005#assistant
http://schemas.google.com/g/2005#callback
http://schemas.google.com/g/2005#car
http://schemas.google.com/g/2005#company_main
http://schemas.google.com/g/2005#isdn
http://schemas.google.com/g/2005#main
http://schemas.google.com/g/2005#other_fax
http://schemas.google.com/g/2005#radio
http://schemas.google.com/g/2005#telex
http://schemas.google.com/g/2005#tty_tdd
http://schemas.google.com/g/2005#work_mobile
http://schemas.google.com/g/2005#work_pager

버전 1.0에 없는 다음 IM 유형은 버전 2.0에 추가되었습니다.

http://schemas.google.com/g/2005#netmeeting

1.0 연락처 종류의 다음 요소는 더 이상 지원되지 않습니다.

atom:title — 서버에서 반환된 항목에는 계속 존재하지만 PUT 및 POST 요청에서 무시됩니다. gd:name로 대체되었습니다.
gd:postalAddress - gd:structuredPostalAddress으로 대체되었습니다.

`gd:email`의 변경사항

새 속성 @displayName가 2.0의 gd:email에 추가되었습니다.

`gd:organization`의 변경사항

2.0에서 도입된 gd:organization의 하위 요소는 다음과 같습니다.

gd:orgDepartment
gd:orgJobDescription
gd:orgSymbol
gd:where

`gd:orgName`의 변경사항

버전 2.0에서는 @yomi 속성을 추가하여 gd:orgName 요소가 개선되었습니다.

맨 위로