บทนำ

บริการที่ใช้ API ของ Google Data มักจะให้ชุดข้อมูลที่เหมือนกันเกี่ยวกับหนึ่งๆ ได้

ตัวอย่างเช่น บริการ Google Data API (หรือ "GData") ต่างๆ อาจมีข้อมูลติดต่อของบุคคลหรือองค์กรต่างๆ จึงควรใช้องค์ประกอบชุดข้อมูลติดต่อเดียวกันดังกล่าว

การรวบรวมองค์ประกอบที่อธิบายถึงรายชื่อติดต่อไว้ด้วยกันเรียกว่า "ประเภท" รายชื่อติดต่อ องค์ประกอบบางอย่างในประเภทข้อมูลติดต่อคือองค์ประกอบ Atom หรือ RSS ทั่วไป ส่วน Google จะกําหนดในเนมสเปซชื่อ "เนมสเปซของ Google Data" โดยทั่วไป เนมสเปซของ Google ข้อมูลมักจะกล่าวถึงในโค้ด XML โดยใช้ชื่อแทน gd: เช่น องค์ประกอบที่มีหมายเลขโทรศัพท์หรือหมายเลขแฟกซ์คือ <gd:phoneNumber> URL ของสคีมาสําหรับเนมสเปซของ Google Data คือ http://schemas.google.com/g/2005

นอกจากนี้ Google ยังกําหนดประเภทอื่นๆ อีกด้วย: กิจกรรม (ชุดขององค์ประกอบที่เป็นมาตรฐานที่รวมกันเป็นกิจกรรมในปฏิทิน) และข้อความ (ชุดขององค์ประกอบที่แสดงถึงข้อความอีเมล การโพสต์ในกลุ่มการสนทนา หรือข้อความอื่นๆ)

องค์ประกอบบางอย่างจากเนมสเปซของ Google Data มีการใช้งานหลายประเภท ตัวอย่างเช่น องค์ประกอบ <gd:who> เชื่อมโยงบุคคล (ตามที่อธิบายไว้ใน <gd:who>) กับรายการที่มีองค์ประกอบ <gd:who> ระบบจะใช้องค์ประกอบนี้ในกิจกรรม "กิจกรรม" เพื่อระบุผู้จัด ผู้เข้าร่วม และอื่นๆ และยังใช้ในประเภทข้อความเพื่อระบุผู้ส่งและผู้รับด้วย

เมื่อรายการในฟีด Google Data API ใช้ประเภทหนึ่งๆ องค์ประกอบจะมีองค์ประกอบ <atom:category> ที่มีแอตทริบิวต์ scheme ตั้งค่าเป็น "http://schemas.google.com/g/2005#kind" และมีการตั้งค่าแอตทริบิวต์ term เป็นชื่อของ URL สคีมาตามด้วยชื่อของประเภท ตัวอย่างเช่น รายการรายชื่อติดต่อมีองค์ประกอบต่อไปนี้

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/g/2005#contact"/>

การดําเนินการนี้จะช่วยให้ลูกค้าระบุข้อมูลประเภทแรกได้อย่างรวดเร็วและง่ายดาย กล่าวคือ เพื่อกําหนดความหมายของรายการ (คุณจะใช้ RSS แทน Atom ก็ได้ โปรดดูเอกสารข้อมูลอ้างอิงโปรโตคอลสําหรับองค์ประกอบ RSS ที่ตรงกับองค์ประกอบ Atom)

เอกสารนี้เป็นเอกสารอ้างอิงสําหรับองค์ประกอบบางประเภทและองค์ประกอบที่มีอยู่

องค์ประกอบที่ไม่ได้บันทึก

เราไม่รวมข้อมูลเกี่ยวกับองค์ประกอบมาตรฐาน <atom:entry> ในประเภทต่างๆ ที่องค์ประกอบเหล่านั้นมีความหมายมาตรฐาน เช่น <atom:id>, <atom:published> และ <atom:updated> มีความหมายมาตรฐานเมื่อปรากฏในประเภท

นอกจากนี้ เรายังไม่รวมข้อมูลเกี่ยวกับองค์ประกอบ Atom มาตรฐานที่ไม่มีความหมายในบริบทที่ระบุ ตัวอย่างเช่น <atom:summary> จะไม่ใช้ในประเภทรายชื่อติดต่อ และแม้ว่า <atom:author> จะเป็นองค์ประกอบที่จําเป็นในรายการ (เว้นแต่จะระบุในฟีดหลัก) ข้อมูลดังกล่าวไม่มีความหมายในประเภทข้อมูลติดต่อ

การสร้างประเภท

อาจเป็นเรื่องยากที่จะระบุข้อมูลที่คุณต้องระบุเมื่อสร้างรายการบางประเภท โดยเฉพาะอย่างยิ่งเนื่องจากองค์ประกอบบางประเภทในประเภทอื่นๆ มีข้อมูลประเภทอื่นๆ

แนวทางหนึ่งที่อาจช่วยได้คือการใช้ไลบรารีของไคลเอ็นต์ที่เรามีให้แทนการพยายามสร้างไลบรารีด้วยตนเอง ไลบรารีของไคลเอ็นต์มีหลายวิธีในการเพิ่มและเปลี่ยนแปลงข้อมูลในรายการแต่ละประเภท โปรดดูรายละเอียดในไลบรารีของไคลเอ็นต์

ความสามารถในการขยายการใช้งาน

ข้อมูลในเอกสารนี้ไม่ได้ครอบคลุมพร็อพเพอร์ตี้และค่าแอตทริบิวต์ที่เป็นไปได้ทั้งหมดสําหรับประเภท บริการอาจขยายประเภทออกไป ดังนั้นบริการบางอย่างอาจใช้พร็อพเพอร์ตี้และค่าที่ไม่รวมอยู่ในเอกสารนี้

แบบแผนการพิมพ์

ในตารางในเอกสารนี้ เราจะใช้รูปแบบต่อไปนี้สําหรับองค์ประกอบที่จําเป็นและไม่บังคับ

ชื่อองค์ประกอบ	องค์ประกอบที่จําเป็น
องค์ประกอบองค์ประกอบ	องค์ประกอบที่ไม่บังคับ
ชื่อองค์ประกอบ*	องค์ประกอบที่ไม่บังคับ อนุญาตหลายอินสแตนซ์

องค์ประกอบและแอตทริบิวต์จะแสดงเป็นรูปแบบ 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*	ที่อยู่ 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 แบบขยายได้ซึ่งแสดงอยู่ด้านล่างและสอดคล้องกับพร็อพเพอร์ตี้ TRANSP ที่ระบุไว้ใน RFC 2445
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:โดยที่

ค่า 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:visible

ค่า	คำอธิบาย
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

พร็อพเพอร์ตี้	คำอธิบาย
http://schemas.google.com/g/2005#message.bcc	ผู้รับสําเนาลับของข้อความ
http://schemas.google.com/g/2005#message.cc	ผู้รับสําเนาข้อความ
http://schemas.google.com/g/2005#message.from	ผู้ส่งข้อความ (อีเมลหรือ IM)
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 Data

ส่วนที่เหลือของเอกสารนี้ประกอบด้วยข้อมูลอ้างอิงสําหรับองค์ประกอบที่ประเภทต่างๆ ใช้

• Enum
• gdCommonProperties
• gd:ความคิดเห็น
• gd:deleted
• อีเมล:
• ลิงก์:
• gd:extendedProperty
• gd:feedLink
• gd:geoPt
• gd:im
• gd:organization
• gd:org
• gd:org
• gd:ดั้งเดิมกิจกรรม
• gd:หมายเลขโทรศัพท์
• gd:postalAddress
• gd:rating
• gd:การเกิดซ้ํา
• gd:recurrenceข้อยกเว้น
• การช่วยเตือน:
• gd:เมื่อใด
• gd:ที่ไหน
• gd:who

Enum

องค์ประกอบส่วนขยายบางรายการต้องระบุพร็อพเพอร์ตี้ที่มีค่ามาจากชุดการแจกแจง รูปแบบทั่วไปของพร็อพเพอร์ตี้มีดังนี้

<gd:propertyName value="propertyValue">

หากค่าพร็อพเพอร์ตี้มาจากเนมสเปซของ Google Data รูปแบบ http://schemas.google.com/g/2005#{kind}.{value} เช่น http://schemas.google.com/g/2005#event.tentative หากพื้นที่ค่าขยายได้ ค่าอาจอยู่ในรูปแบบ URI ด้วยเช่นกัน แบบฟอร์มที่แนะนําสําหรับ URI ค่าเพิ่มเติมคือ {schema URI}#{value} เช่น http://www.example.com/attendeeStatus#AudioConference

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

พร็อพเพอร์ตี้ทั่วไปที่ใช้สําหรับ Google ทุกประเภท โปรดทราบว่าการแสดงข้อมูล anyAttribute และ anyElement ในสคีมาช่วยให้ขยายองค์ประกอบเนมสเปซของ Google Data ทั้งหมดที่ใช้พร็อพเพอร์ตี้ทั่วไปต่อไปได้ในเนมสเปซทั้งหมด โดยเฉพาะการฝังองค์ประกอบ gd หรือองค์ประกอบ Atom/RSS ไว้ในองค์ประกอบ gd อื่นๆ ซึ่งควรดําเนินการอย่างรอบคอบและในกรณีส่วนใหญ่ การใช้งานดังกล่าวควรบันทึกเป็นพร็อพเพอร์ตี้ที่ชัดเจนของประเภทองค์ประกอบ gd ที่มี

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@xml:base	uri	โครงสร้าง XML มาตรฐานสําหรับอธิบายฐานของ URI แบบสัมพัทธ์ที่ซ้อนกัน
@xml:lang	text	ภาษาของสตริงที่ซ้อนกัน

สคีมา

namespace gd = "http://schemas.google.com/g/2005"

gdCommonProperties = {
   atomCommonAttributes,
   anyAttribute*,
   (anyElement*)
}

gd:ความคิดเห็น

มีฟีดความคิดเห็นสําหรับคําที่เกี่ยวข้อง (เช่น กิจกรรมในปฏิทิน)

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@rel	string	ประเภทความคิดเห็นที่มี ปัจจุบันคุณสามารถแยกแยะระหว่างความคิดเห็นปกติกับรีวิวได้
gd:feedLink	feedLink	ฟีดความคิดเห็น ฟีดนี้ควรใช้ประเภทข้อความ

ค่า 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:deleted (ลบ)

องค์ประกอบเครื่องหมายที่แจ้งว่ารายการที่มีอยู่นั้นจะถูกลบ (หากมี)

พร็อพเพอร์ตี้

ไม่มี

สคีมา

start = deleted

deleted =
   element gd:deleted

gd:email

อีเมลที่เกี่ยวข้องกับเอนทิตีที่ระบุ (ซึ่งมักเป็นเอนทิตีที่แสดงถึงบุคคลหรือสถานที่ตั้ง)

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@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	ระบุความสัมพันธ์ของลิงก์เพื่อให้บริการแสดงลิงก์รายการได้หลายประเภทสําหรับเอนทิตีเดียว มีความหมายและค่าที่อนุญาตเหมือนกับแอตทริบิวต์ rel ขององค์ประกอบ <atom:link>
atom:entry	atomEntry	เนื้อหาของรายการ

ข้อจำกัด

• ต้องมี @href หรือ <atom:entry> อย่างใดอย่างหนึ่งหรือทั้ง 2 อย่าง
• หากไม่มี atom:entry ไคลเอ็นต์จะดึงข้อมูลเนื้อหาจาก URI ของรายการใน @href ได้ หากมี 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 ช่วยให้ฟีดฝัง XML ที่ถูกต้องภายในองค์ประกอบ gd:extendedProperty ได้ (ยกเว้นแอตทริบิวต์ 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	ระบุความสัมพันธ์ของลิงก์ อนุญาตให้บริการระบุลิงก์ฟีดหลายประเภทสําหรับเอนทิตีเดียว มีความหมายและค่าที่อนุญาตเหมือนกับแอตทริบิวต์ rel ขององค์ประกอบ <atom:link>
atom:feed	atomFeed	เนื้อหาของฟีด

ข้อจำกัด

• ต้องมี @href หรือ <atom:feed> อย่างใดอย่างหนึ่งหรือทั้ง 2 อย่าง
• หากไม่มี atom:feed ไคลเอ็นต์จะดึงข้อมูลเนื้อหาจาก URI ใน @href ได้ หากมี เนื้อหาต้องเหมือนกับที่ดึงมาจาก @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:im

ที่อยู่สําหรับรับส่งข้อความโต้ตอบแบบทันทีที่เชื่อมโยงกับเอนทิตีที่มีอยู่

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@address	xs:string	ที่อยู่ IM
@label	xs:string	ค่าสตริงแบบง่ายที่ใช้ตั้งชื่อที่อยู่ IM นี้ ช่วยให้ UI แสดงป้ายกํากับได้ เช่น "ที่ทํางาน" "ส่วนตัว" "แนะนํา" ฯลฯ
@rel	xs:string	ค่าแบบเป็นโปรแกรมที่ระบุประเภทของ IM โปรดดูรายละเอียดด้านล่าง
@protocol	xs:string	ระบุเครือข่าย IM ค่าอาจเป็นค่ามาตรฐานค่าใดค่าหนึ่ง (ดังที่แสดงด้านล่าง) หรือ URI ที่ระบุเครือข่าย IM ที่เป็นกรรมสิทธิ์
@primary	xs:boolean	เมื่อส่วนขยาย IM หลายรายการปรากฏในประเภทรายชื่อติดต่อ ให้ระบุว่าส่วนขยายใดเป็นส่วนขยายหลัก ไม่เกิน IM หลัก ค่าเริ่มต้นคือ "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 Talk
http://schemas.google.com/g/2005#ICQ	โปรโตคอล ICQ
http://schemas.google.com/g/2005#JABBER	โปรโตคอล Jabber

ตัวอย่าง

ที่อยู่ IM สําหรับ 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:organization

องค์กรที่มักจะเชื่อมโยงกับรายชื่อติดต่อ

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@label	xs:string	ค่าสตริงแบบง่ายที่ใช้ตั้งชื่อองค์กรนี้ ช่วยให้ UI แสดงป้ายกํากับได้ เช่น "ที่ทํางาน" "อาสาสมัคร" "สมาคมวิชาชีพ" ฯลฯ
@rel	xs:string	ค่าแบบเป็นโปรแกรมที่ระบุประเภทองค์กร
@primary	xs:boolean	เมื่อส่วนขยายองค์กรหลายรายการปรากฏในประเภทรายชื่อติดต่อ จะระบุว่าส่วนขยายใดเป็นส่วนขยายหลัก ไม่เกิน 1 องค์กรหลัก ค่าเริ่มต้นคือ "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:orgName

ชื่อขององค์กร ต้องปรากฏในองค์ประกอบ 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:ดั้งเดิมกิจกรรม

เทียบเท่ากับพร็อพเพอร์ตี้รหัสการเกิดซ้ําที่ระบุในมาตรา 4.8.4.4 ของ RFC 2445 ปรากฏในทุกอินสแตนซ์ของกิจกรรมที่เกิดซ้ํา เพื่อระบุกิจกรรมเดิม

มีองค์ประกอบ <gd:when> ที่ระบุเวลาเริ่มต้นเดิมของอินสแตนซ์ที่กลายเป็นข้อยกเว้น

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@id	xs:string	รหัสเหตุการณ์ของเหตุการณ์เดิม
@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	"เทอม URI" แบบไม่บังคับที่ใช้เพื่อแสดงตัวเลขในรูปแบบอย่างเป็นทางการ ซึ่งมีประโยชน์สําหรับการเข้าถึงแบบเป็นโปรแกรม เช่น บริดจ์ VoIP/PSTN ดูข้อมูลเพิ่มเติมเกี่ยวกับ 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:rating

แสดงถึงคะแนนที่เป็นตัวเลขของเอนทิตีที่เกี่ยวข้อง เช่น ความคิดเห็น การจัดประเภทแต่ละรายการจะมีระดับของตนเอง แม้จะเป็นบริการมาตรฐาน เช่น บริการบางอย่างอาจแปลงคะแนนทั้งหมดเป็นระดับตั้งแต่ 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 คนมีคะแนนเฉลี่ย 4.65 จาก 5:

<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, EXสร้างกฎ และ/หรือ EXDATE ซึ่งกําหนดกิจกรรมที่เกิดซ้ําและข้อยกเว้น (ดูด้านล่าง) (ดูส่วน 4.8.5 ของ RFC 2445 สําหรับข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ของคอมโพเนนต์การเกิดซ้ําเหล่านี้) คอมโพเนนต์สุดท้ายคือคอมโพเนนต์ VMMS ซึ่งระบุกฎเขตเวลาโดยละเอียดสําหรับรหัสเขตเวลาที่กล่าวถึงในพร็อพเพอร์ตี้ก่อนหน้านี้

โดยทั่วไปแล้ว บริการของ Google เช่น Google ปฏิทินจะไม่สร้างพร็อพเพอร์ตี้ EXrule และ EXDATE เพื่อแสดงข้อยกเว้นสําหรับกิจกรรมที่เกิดซ้ํา แต่จะสร้างเอลิเมนต์ <gd:recurrenceException> แทน แต่บริการของ Google อาจมีพร็อพเพอร์ตี้ EXPOLICY และ/หรือ EXDATE ด้วย ตัวอย่างเช่น ผู้ใช้สามารถนําเข้ากิจกรรมและข้อยกเว้นไปยังปฏิทิน และถ้ากิจกรรมที่นําเข้าเหล่านั้นมีพร็อพเพอร์ตี้ EXrule หรือ EXDATE ปฏิทินก็จะให้พร็อพเพอร์ตี้เหล่านั้นเมื่อส่งองค์ประกอบ <gd:recurrence>

โปรดทราบว่าการใช้ <gd:recurrenceException> หมายถึงคุณไม่สามารถมั่นใจได้จากการตรวจสอบองค์ประกอบ <gd:recurrence> ว่ามีข้อยกเว้นใดๆ สําหรับคําอธิบายการเกิดซ้ําหรือไม่ โปรดมองหาองค์ประกอบ <gd:recurrenceException> ในฟีด และใช้องค์ประกอบ <gd:originalEvent> เพื่อจับคู่องค์ประกอบกับ <gd:recurrence> เพื่อให้พบข้อยกเว้นทั้งหมด

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
text()	xs:string	คําอธิบายการเกิดซ้ํา

ตัวอย่าง

กิจกรรมที่เกิดซ้ําซึ่งจัดขึ้นทุกเช้าตั้งแต่เวลา 6:00 น.ถึง 7:00 น. เวลาแปซิฟิกตั้งแต่วันที่ 14 มีนาคมถึง 21 มีนาคม 2006

<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:recurrenceข้อยกเว้น

แสดงถึงกิจกรรมที่มีข้อยกเว้นสําหรับกิจกรรมที่เกิดซ้ํา ซึ่งก็คืออินสแตนซ์ของกิจกรรมที่เกิดซ้ําซึ่งมีการเปลี่ยนแปลงกิจกรรมที่เกิดซ้ําอย่างน้อย 1 ด้าน (เช่น รายการการเข้าร่วม เวลา หรือสถานที่)

มีองค์ประกอบ <gd:originalEvent> ที่ระบุกิจกรรมที่เกิดซ้ําเดิมที่เหตุการณ์นี้เป็นข้อยกเว้น

เมื่อเปลี่ยนอินสแตนซ์ของกิจกรรมที่เกิดซ้ํา อินสแตนซ์ดังกล่าวจะกลายเป็นข้อยกเว้น ข้อยกเว้นจะทํางานตาม 2 รูปแบบเมื่อมีการเปลี่ยนแปลงกิจกรรมที่เกิดซ้ําเดิม ดังนี้ ขึ้นอยู่กับว่าคุณทําการเปลี่ยนแปลงอย่างไร

• หากคุณเพิ่ม เปลี่ยน หรือนําความคิดเห็น ผู้เข้าร่วม หรือผู้เข้าร่วมออก ข้อยกเว้นก็จะยังผูกกับกิจกรรมเดิม และการเปลี่ยนแปลงกิจกรรมเดิมจะเปลี่ยนแปลงข้อยกเว้นด้วย
• หากคุณทําการเปลี่ยนแปลงอื่นๆ กับข้อยกเว้น (เช่น เปลี่ยนเวลาหรือสถานที่) อินสแตนซ์จะกลายเป็น "เชี่ยวชาญ" ซึ่งหมายความว่าอินสแตนซ์จะไม่เชื่อมโยงกับกิจกรรมเดิมอีกต่อไป หากคุณเปลี่ยนกิจกรรมเดิม การยกเว้นเฉพาะกรณีจะไม่เปลี่ยนแปลง โปรดดูด้านล่าง

เช่น สมมติว่าคุณมีการประชุมทุกวันอังคารและพฤหัสบดี เวลา 14.00 น. หากคุณเปลี่ยนรายการการเข้าร่วมของการประชุมในวันพฤหัสบดีนี้ (แต่ไม่ใช่สําหรับการประชุมตามกําหนดการ) กรณีนี้ก็จะกลายเป็นข้อยกเว้น หากคุณเปลี่ยนเวลาสําหรับการประชุมของวันพฤหัสบดีนี้ (แต่ไม่ใช่สําหรับการประชุมที่กําหนดเวลาไว้) เวลาดังกล่าวจะกลายเป็นความเชี่ยวชาญพิเศษ

ไม่ว่าข้อยกเว้นจะเป็นพิเศษหรือไม่ก็ตาม หากคุณดําเนินการลบอินสแตนซ์ที่เป็นข้อยกเว้นของข้อยกเว้น ระบบจะลบข้อยกเว้นนั้นออก โปรดทราบว่าการเปลี่ยนแปลงวันหรือเวลาของกิจกรรมที่เกิดซ้ําจะลบอินสแตนซ์ทั้งหมดและสร้างอินสแตนซ์ใหม่

เช่น หลังจากที่คุณเชี่ยวชาญการประชุมของวันพฤหัสบดีนี้ สมมติว่าคุณเปลี่ยนการประชุมที่เกิดซ้ําให้เกิดขึ้นในวันจันทร์ วันพุธ และวันศุกร์ การเปลี่ยนแปลงดังกล่าวจะลบอินสแตนซ์ที่เกิดซ้ําทั้งหมดของการประชุมวันอังคาร/พฤหัสบดี รวมถึงอินสแตนซ์พิเศษ

หากอินสแตนซ์หนึ่งๆ ของกิจกรรมที่เกิดซ้ํา อินสแตนซ์ดังกล่าวจะปรากฏเป็น <gd:recurrenceException> ที่มี <gd:entryLink> ซึ่งตั้งค่า <gd:eventStatus> เป็น "http://schemas.google.com/g/2005#event.canceled" (ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์ที่ยกเลิกแล้วได้ที่ 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 รายการ หากต้องการระบุระยะเวลาผสม ให้แปลงเป็นหน่วยที่แม่นยําที่สุด เช่น หากต้องการระบุ 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>

การประชุมเดียวกับด้านบน แต่เลื่อนการแจ้งเตือนเป็นเวลา 10 นาทีหลังจากการช่วยเตือนเวลา 16:45 น.

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

ตัวระบุทรัพยากรที่คลุมเครือ ซึ่งแตกต่างจาก atom:id เนื่องจากไม่จําเป็นต้องเป็น URI ที่ถูกต้อง บริการบางอย่างจะมีตัวระบุแยกต่างหากที่จะใช้เมื่อสร้างคําขอที่ตามมา การใช้งานที่แน่นอนมีไว้สําหรับบริการที่เฉพาะเจาะจง

ตัวอย่าง

<gd:resourceId>9749638</gd:resourceId>

สคีมา

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:เมื่อใด

แสดงระยะเวลาหรือทันที

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@endTime	xs:dateTime หรือ xs:date	อธิบายเมื่อกิจกรรมสิ้นสุด หากไม่มีการระบุเขตเวลา ระบบจะถือว่าเป็นเขตเวลาท้องถิ่นของผู้สังเกต
@startTime	xs:dateTime หรือ xs:date	อธิบายเมื่อเหตุการณ์เริ่มต้นหรือ (สําหรับเหตุการณ์ที่ไม่มีระยะเวลา) เมื่อเกิด หากไม่มีการระบุเขตเวลา ระบบจะถือว่าเป็นเขตเวลาท้องถิ่นของผู้สังเกต
@valueString	xs:string	ค่าสตริงง่ายๆ ที่ใช้แสดงช่วงเวลานี้

ข้อจำกัด

• ผสม xs:dateTime กับ xs:date ใน startTime/endTime ไม่ได้
• หากไม่ได้ระบุ endTime ระบบจะถือว่ากิจกรรมเกิดขึ้นทันที (หาก @startTime รวมเวลา) หรือเหตุการณ์แบบวันเดียว (หาก @startTime เป็นวันที่เท่านั้น)

ตัวอย่าง

กิจกรรมแบบ 1 วัน

<gd:when startTime="2005-06-06"/>

สิ่งที่ใช้แทนกิจกรรมแบบ 1 วัน

<gd:when startTime="2005-06-06" endTime="2005-06-07"/>

กิจกรรม 2 วัน (วันที่ 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> ประเภทแรกจะระบุสถานที่โดยใช้คําอธิบายข้อความและ/หรือรายการรายชื่อติดต่อ ส่วนรายการหลังจะระบุสถานที่โดยใช้สถานที่ตั้งทางภูมิศาสตร์ที่เฉพาะเจาะจง

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@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:who

บุคคลที่เกี่ยวข้องกับนิติบุคคลที่มี ประเภทของการเชื่อมโยงจะกําหนดโดยแอตทริบิวต์ 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	ข้อความ	ผู้ส่งข้อความ (อีเมลหรือ IM)
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 }?)
   }

กลับไปด้านบน