คําเตือน: หน้านี้เกี่ยวกับ API แบบเก่าของ Google ซึ่งก็คือ Google Data API โดยเกี่ยวข้องกับ API ที่แสดงอยู่ในไดเรกทอรี Google Data API เท่านั้น โดยหลาย API ถูกแทนที่ด้วย API ที่ใหม่กว่า สําหรับข้อมูลเกี่ยวกับ API ใหม่โดยเฉพาะ โปรดดูเอกสารประกอบของ API ใหม่ ดูข้อมูลเกี่ยวกับการให้สิทธิ์คําขอด้วย API ใหม่ได้ที่การตรวจสอบสิทธิ์และการให้สิทธิ์บัญชี Google

บทนำ

บริการที่ใช้ 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"/>

หมายเหตุ: หากคุณใช้ Contact Contact ในบริบทของ Contacts API โปรดทราบว่า Contacts Type เวอร์ชัน 2.0 (ตามที่อธิบายไว้ในเอกสารนี้) จะนําไปใช้โดย Contacts API ตั้งแต่ 3.0 API

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

พร็อพเพอร์ตี้	คำอธิบาย
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*	ที่อยู่ 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"/>

เปิดตัวโปรไฟล์ประเภทในเวอร์ชัน Contacts API เวอร์ชัน 3.0

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

พร็อพเพอร์ตี้	คำอธิบาย
atom:category*	หมวดหมู่ อินสแตนซ์ที่มีแอตทริบิวต์ @label จะถือว่าเป็นแท็ก สําหรับข้อมูลเกี่ยวกับการใช้แอตทริบิวต์ @scheme โปรดดูหมายเหตุ "องค์ประกอบหมวดหมู่" ที่ตอนต้นของส่วนนี้
atom:content	หมายเหตุเกี่ยวกับโปรไฟล์
atom:link*	ลิงก์ไปยังข้อมูลที่เกี่ยวข้อง กล่าวคือ atom:link[@rel='alternate'] จะลิงก์ไปยังหน้า HTML ที่อธิบายโปรไฟล์
atom:title	ชื่อโปรไฟล์ ช่องนี้เป็นแบบอ่านอย่างเดียว
gd:email*	อีเมล
gd:im*	ที่อยู่ 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 แบบขยายได้ซึ่งแสดงอยู่ด้านล่างและสอดคล้องกับพร็อพเพอร์ตี้ 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:ความคิดเห็น
• gd:country
• gd:deleted
• อีเมล:
• ลิงก์:
• gd:extendedProperty
• gd:นามสกุล
• gd:feedLink
• gd:geoPt
• gd:GrantName
• gd:im
• gd:organization
• gd:orgDepartment
• gd:orgJobDescription
• gd:org
• gd:orgSymbol
• gd:org
• gd:ดั้งเดิมกิจกรรม
• gd:หมายเลขโทรศัพท์
• gd:postalAddress
• gd:rating
• gd:การเกิดซ้ํา
• gd:recurrenceข้อยกเว้น
• การช่วยเตือน:
• gd:structuredไปรษณีย์ที่อยู่
• 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:ชื่ออื่นๆ

ระบุชื่อเพิ่มเติม (เช่น ตรงกลาง) ของบุคคล เช่น "Susan"

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

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
@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	ฟีดความคิดเห็น ฟีดนี้ควรใช้ประเภทข้อความ

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

ชื่อประเทศพร้อมรหัสประเทศที่ไม่บังคับ สําหรับค่าหลังจะเป็นไปตาม 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:email

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

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

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

ระบุชื่อครอบครัวของบุคคล เช่น "สมิธ"

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

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

ระบุชื่อของบุคคล เช่น "วิชัย"

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

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

อนุญาตการจัดเก็บชื่อบุคคลโดยมีโครงสร้าง ประกอบด้วยชื่อ ชื่อ ชื่อครอบครัว คํานําหน้า คําต่อท้าย และชื่อเต็ม

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

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
gd:givenName	givenName	ชื่อของบุคคล
gd:additionalName	additionalName	ชื่อของบุคคลเพิ่มเติม เช่น ชื่อกลาง
gd:familyName	familyName	นามสกุลของบุคคลนั้น
gd:namePrefix	namePrefix	คํานําหน้าที่ยอดเยี่ยม เช่น "Mr" หรือ "Mrs"
gd:nameSuffix	nameSuffix	คําลงท้ายที่เชื่อถือได้ เช่น "san" หรือ "III"
gd:fullName	fullName	การนําเสนอชื่อที่ไม่มีโครงสร้าง

ตัวอย่าง

ภาพเขียนของ Sir Winston Leonard Spencer-Churchill, 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:organization

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

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

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

อธิบายหน่วยงานภายในองค์กร ต้องปรากฏในองค์ประกอบ gd:organization

ตัวอย่าง

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

สคีมา

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

gd:orgJobDescription

อธิบายงานภายในองค์กร ต้องปรากฏในองค์ประกอบ gd:organization

ตัวอย่าง

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

สคีมา

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:orgName

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

เทียบเท่ากับพร็อพเพอร์ตี้รหัสการเกิดซ้ําที่ระบุในมาตรา 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#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: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:structuredPostAddress

ที่อยู่ไปรษณีย์แบ่งออกเป็นส่วนประกอบต่างๆ ทําให้คุณสามารถจัดเก็บที่อยู่ในรูปแบบภาษาที่อิสระ คุณจะตีความช่องแล้วใช้เพื่อสร้างที่อยู่ที่อ้างอิงตามสถานที่ได้ องค์ประกอบสํารองของที่อยู่: agent, name name, Street,, P.O. box, ย่าน, เมือง, ภูมิภาคย่อย, ภูมิภาค, รหัสไปรษณีย์, ประเทศ ระบบไม่ได้ใช้องค์ประกอบ 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"
gd:housename	housename	ใช้ในสถานที่ที่บ้านหรืออาคารมีชื่อ (และไม่จําเป็นต้องเป็นตัวเลข) เช่น "พื้นฐาน"
gd:street	street	อาจเป็นถนน ถนน ถนน องค์ประกอบนี้ยังรวมถึงบ้านและหมายเลขห้อง/อพาร์ตเมนต์/แฟลต/ชั้นอีกด้วย
gd:pobox	pobox	ครอบคลุมตู้ ปณ. ลิ้นชัก กระเป๋าที่ล็อกไว้ ฯลฯ ซึ่งจริงๆ แล้วมักจะไม่เหมือนถนน
gd:neighborhood	neighborhood	ใช้เพื่อแยกความแตกต่างของที่อยู่เมื่อเมืองหนึ่งมีถนนชื่อเดียวกันมากกว่า 1 ถนน หรือเพื่อระบุสถานที่เล็กๆ ที่มีเส้นทางผ่านเมืองไปรษณีย์ขนาดใหญ่ ในประเทศจีน อาจเป็นเคาน์ตีหรือเมืองย่อย
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>

ที่อยู่ส่วนตัว:

Madame Duval

27 Rue Pasteur

14390 CABOURG

ฝรั่งเศส

<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:structuredPostAddress" ในเอนทิตีเดียว
• ระบุที่อยู่ที่มีโครงสร้างได้เพียงที่อยู่เดียว
• ที่อยู่ไปรษณีย์ที่ไม่มีโครงสร้างต้องสอดคล้องกับข้อมูลที่มีโครงสร้าง

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

มีการเพิ่มประเภท IM ต่อไปนี้ในเวอร์ชัน 1.0 ในเวอร์ชัน 2.0

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

ระบบไม่รองรับองค์ประกอบต่อไปนี้ของประเภทรายชื่อติดต่อ 1.0 อีกต่อไป

• atom:title - ยังคงแสดงในรายการที่เซิร์ฟเวอร์ส่งกลับมา แต่ไม่สนใจคําขอ PUT และ POST แทนที่ด้วย gd:name
• gd:postalAddress — แทนที่ด้วย gd:structuredPostalAddress

การเปลี่ยนแปลงใน gd:email

เพิ่มแอตทริบิวต์ใหม่ @displayName ใน gd:email ใน 2.0 แล้ว

การเปลี่ยนแปลงใน gd:organization

องค์ประกอบย่อยต่อไปนี้ของ gd:organization เปิดตัวใน 2.0

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

การเปลี่ยนแปลงใน gd:orgName

ในเวอร์ชัน 2.0 องค์ประกอบ gd:orgName ได้รับการปรับปรุงโดยเพิ่มแอตทริบิวต์ @yomi ลงในองค์ประกอบ

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