Halaman ini diterjemahkan oleh Cloud Translation API.

Elemen Umum: "Jenis"

Pengantar

Hal ini sering berguna bagi layanan yang menggunakan Google Data API agar dapat memberikan kumpulan informasi yang konsisten tentang jenis item tertentu.

Misalnya, berbagai layanan Google Data API (atau "GData") mungkin memberikan informasi kontak untuk seseorang atau organisasi; jadi, sebaiknya semua layanan tersebut menggunakan kumpulan elemen informasi kontak yang sama.

Kumpulan elemen yang menjelaskan kontak disebut "jenis" Kontak. Beberapa elemen dalam jenis Contact adalah elemen Atom atau RSS biasa; elemen lainnya ditentukan oleh Google dalam namespace yang disebut "namespace Data Google". Berdasarkan konvensi, namespace Data Google biasanya dirujuk dalam kode XML menggunakan alias gd:; misalnya, elemen yang berisi nomor telepon atau faks adalah <gd:phoneNumber>. URL skema untuk namespace Data Google adalah http://schemas.google.com/g/2005.

Google juga menentukan jenis lain: Acara (kumpulan elemen standar yang bersama-sama mewakili acara kalender) dan Pesan (kumpulan elemen yang mewakili pesan email, postingan grup diskusi, atau pesan lain).

Beberapa elemen dari namespace Google Data digunakan oleh beberapa jenis. Misalnya, elemen <gd:who> mengaitkan seseorang (dijelaskan dalam <gd:who>) dengan entri yang berisi elemen <gd:who>. Elemen ini digunakan dalam jenis Acara untuk menentukan penyelenggara, peserta, dan sebagainya. Atribut ini juga digunakan di jenis Message untuk menentukan pengirim dan penerima.

Saat entri di feed Google Data API menggunakan jenis tertentu, entri tersebut berisi elemen <atom:category> dengan atribut scheme miliknya yang disetel ke "http://schemas.google.com/g/2005#kind" dan atribut term-nya ditetapkan ke nama URL skema yang diikuti dengan nama jenisnya. Misalnya, entri Contact menyertakan elemen berikut:

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

Hal ini memungkinkan klien untuk menentukan dengan cepat dan mudah jenis data yang ada di entri—yaitu, menentukan semantik entri. (Jika ingin, Anda dapat menggunakan RSS dan bukan Atom; lihat dokumen referensi protokol untuk elemen RSS yang sesuai dengan elemen Atom.)

Dokumen ini merupakan referensi untuk beberapa jenis umum dan elemen yang ada di dalamnya.

Elemen yang tidak terdokumentasi

Kami tidak menyertakan informasi tentang elemen standar <atom:entry> sebagaimana jenis-jenisnya memiliki arti standar. Misalnya, <atom:id>, <atom:published>, dan <atom:updated> semuanya memiliki arti standar saat muncul dalam jenis.

Kami juga tidak menyertakan informasi tentang elemen Atom standar yang tidak akan memiliki arti dalam konteks tertentu; misalnya, <atom:summary> tidak digunakan dalam jenis Kontak, dan meskipun <atom:author> adalah elemen yang diperlukan dalam entri (kecuali jika ditentukan dalam feed induk), elemen tersebut tidak memiliki arti yang berguna dalam jenis Kontak.

Membuat jenis

Mungkin sulit untuk mengetahui dengan tepat informasi apa yang perlu Anda sertakan saat membuat entri jenis tertentu, terutama karena beberapa elemen dalam jenis itu berisi jenis lainnya.

Salah satu pendekatan yang mungkin membantu adalah menggunakan library klien yang kami sediakan, bukan mencoba membuat jenis secara manual. Library klien menyediakan berbagai metode untuk menambahkan dan mengubah data dalam entri jenis tertentu; lihat dokumentasi library klien untuk mengetahui detailnya.

Ekstensibilitas

Informasi dalam dokumen ini tidak mencakup semua kemungkinan properti dan nilai atribut untuk berbagai jenis. Layanan dapat memperluas jenis layanan, sehingga layanan tertentu dapat menggunakan properti dan nilai yang tidak disertakan dalam dokumen ini.

Konvensi tipografi

Dalam tabel dalam dokumen ini, kami menggunakan konvensi berikut untuk elemen wajib dan opsional:

namaelemen	Elemen wajib
elemenName?	Elemen opsional
elemenNama*	Elemen opsional, beberapa instance diizinkan

Elemen dan atribut ditampilkan dalam notasi XPath standar.

Jenis kontak

Merepresentasikan kontak: orang, tempat seperti klub atau restoran, atau organisasi.

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

Properti

Properti	Deskripsi
`atom:category`*	Kategori. Instance dengan atribut `@label` diperlakukan sebagai tag. Untuk informasi tentang penggunaan atribut `@scheme`, lihat catatan di awal bagian ini.
`atom:content`	Catatan tentang kontak.
`atom:link`*	Link ke informasi terkait. Secara khusus, `atom:link[@rel='alternate']` menautkan ke halaman HTML yang mendeskripsikan kontak.
`atom:title`	Nama kontak.
`gd:email`*	Alamat email.
`gd:im`*	Alamat IM.
`gd:phoneNumber`*	Nomor telepon dan faks.
`gd:postalAddress`*	Alamat pos.
`gd:organization`*	Kerapian.
`gd:extendedProperty`*	Properti yang diperluas.
`gContact:groupMembershipInfo`*	Informasi keanggotaan grup.
`gd:deleted`*	Status entri kontak dihapus.

Contoh

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

Jenis peristiwa

Merepresentasikan acara kalender. Lokasi acara diwakili oleh jenis Kontak yang disematkan di (atau ditautkan dari) elemen <gd:where>; perencana dan tamu acara diwakili sebagai jenis Kontak yang disematkan di (atau ditautkan dari) elemen <gd:who>.

Elemen kategori: <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>

Properti

Properti	Deskripsi
`atom:author`	Orang yang membuat acara ini.
`atom:category`*	Kategori. Instance dengan atribut `@label` diperlakukan sebagai tag. Untuk informasi tentang penggunaan atribut `@scheme`, lihat catatan di awal bagian ini.
`atom:content`	Deskripsi peristiwa yang lebih panjang.
`atom:link`*	Link. Secara khusus, `atom:link[@rel='alternate']` menyediakan link ke halaman HTML yang mendeskripsikan peristiwa.
`atom:title`	Judul singkat untuk acara.
`gd:comments`?	Feed komentar.
`gd:eventStatus`?	Enum yang dapat diperluas yang didokumentasikan di bawah.
`gd:recurrence`?	Aturan pengulangan.
`gd:transparency`?	Enum yang dapat diperluas yang didokumentasikan di bawah, sesuai dengan properti TRANSP yang ditentukan di RFC 2445.
`gd:visibility`?	Enum yang dapat diperluas yang didokumentasikan di bawah.
`gd:when`*	Waktu peristiwa. Atribut `startTime` dan `endTime` harus ditetapkan, meskipun untuk acara sepanjang hari atribut tersebut hanya berupa tanggal, tanpa waktu.
`gd:when/gd:reminder`*	Pengingat untuk acara.
`gd:where`*	Lokasi peristiwa atau kebutuhan terdekat seperti tempat parkir. Jika elemen `<gd:where>` ditentukan di level feed, tetapi tidak ada elemen `<gd:where>` di level entri, entri tersebut akan mewarisi nilai `<gd:where>` tingkat feed.
`gd:who`*	Orang yang terkait dengan acara: penyelenggara, tamu, pembicara, pembawa acara, dll.
`gd:who/gd:attendeeStatus`?	Status penerimaan.
`gd:who/gd:attendeeType`?	Jenis peserta: `required` atau `optional`.

nilai rel untuk gd:where

nilai rel	Deskripsi
`http://schemas.google.com/g/2005#event` atau tidak ditentukan.	Tempat berlangsungnya acara.
`http://schemas.google.com/g/2005#event.alternate`	Lokasi sekunder. Misalnya, situs jarak jauh dengan link konferensi video ke situs utama.
`http://schemas.google.com/g/2005#event.parking`	Tempat parkir terdekat.

Nilai gd:eventStatus

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event.canceled`	Acara telah dibatalkan.
`http://schemas.google.com/g/2005#event.confirmed`	Acara ini direncanakan.
`http://schemas.google.com/g/2005#event.tentative`	Acara tersebut hanya dijadwalkan untuk sementara.

nilai gd:visibilitas

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event.confidential`	Izinkan beberapa pembaca untuk melihat peristiwa.
`http://schemas.google.com/g/2005#event.default`	Mewarisi perilaku dari preferensi pemilik kalender tempat acara muncul.
`http://schemas.google.com/g/2005#event.private`	Izinkan sedikit pembaca untuk melihat peristiwa.
`http://schemas.google.com/g/2005#event.public`	Izinkan sebagian besar pembaca melihat peristiwa.

Nilai gd:transparency

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event.opaque`	Mengindikasikan bahwa acara menghabiskan waktu di kalender; waktu acara akan ditandai sebagai sibuk dalam penelusuran senggang/sibuk.
`http://schemas.google.com/g/2005#event.transparent`	Mengindikasikan bahwa acara tidak menggunakan waktu apa pun di kalender; waktu acara tidak akan ditandai sebagai sibuk dalam penelusuran senggang/sibuk.

Contoh

Rapat:

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

Acara online:

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

Jenis pesan

Merepresentasikan pesan, seperti email, postingan grup diskusi, atau komentar.

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

Properti

Properti	Deskripsi
`atom:category`*	Kategori. Instance dengan atribut `@label` diperlakukan sebagai tag. Untuk informasi tentang penggunaan atribut `@scheme`, lihat catatan di awal bagian ini. Untuk informasi tentang penggunaan atribut `@term`, lihat tabel di bawah.
`atom:content`	Isi pesan.
`atom:link`*	Lampiran pesan. Khususnya, untuk mengupload lampiran, gunakan `<link rel="enclosure">` dan masukkan konten lampiran ke dalam koleksi media Atom.
`atom:title`	Subjek pesan.
`gd:geoPt`?	Lokasi geografis tempat pesan diposting.
`gd:rating`?	Rating kualitas (seperti yang ditentukan oleh aplikasi).
`gd:who`*	Orang yang terkait dengan pesan ini. Semantik yang tepat bergantung pada nilai `@rel`. Lihat tabel di bawah.

Kategori nilai @term

Semua kategori di bawah ini termasuk dalam skema http://schemas.google.com/g/2005.

Istilah	Deskripsi
`http://schemas.google.com/g/2005#message.chat`	Pesan ini merupakan transkrip dari sesi chat.
`http://schemas.google.com/g/2005#message.inbox`	Pesan ditandai sebagai milik kotak masuk.
`http://schemas.google.com/g/2005#message.sent`	Pesan ditandai sebagai terkirim.
`http://schemas.google.com/g/2005#message.spam`	Pesan ini dianggap sebagai spam.
`http://schemas.google.com/g/2005#message.starred`	Pesan ditandai sebagai berbintang.
`http://schemas.google.com/g/2005#message.unread`	Pesan belum dibaca.

nilai rel untuk gd:who

Properti	Deskripsi
`http://schemas.google.com/g/2005#message.bcc`	Kirim pesan ke penerima BCC.
`http://schemas.google.com/g/2005#message.cc`	Penerima CC pesan.
`http://schemas.google.com/g/2005#message.from`	Pengirim pesan (email atau IM).
`http://schemas.google.com/g/2005#message.reply-to`	Penerima pesan balasan yang dituju.
`http://schemas.google.com/g/2005#message.to`	Kirim pesan ke penerima utama.

Contoh

Pesan email:

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

Referensi elemen namespace Data Google

Bagian selanjutnya dari dokumen ini terdiri dari materi referensi untuk elemen yang digunakan oleh jenis materi tersebut.

Enum
gdCommonProperties
gd:komentar
gd:dihapus
gd:email
gd:entriLink
gd:extendedProperty
gd:feedLink
gd:geoPt
ID
gd:organisasi
gd.orgNama
gd.orgJudul
gd:originalEvent
gd:nomorTelepon
gd:Alamatalamat
gd:rating
gd:pengulangan
gd:pengulanganException
gd:pengingat
gd:kapan
gd:tempat
gd:siapa

Enumerasi

Beberapa elemen ekstensi perlu menentukan properti yang nilainya berasal dari kumpulan yang disebutkan. Bentuk umum dari properti tersebut adalah:

<gd:propertyName value="propertyValue">

Jika nilai properti berasal dari namespace Google Data, akan diperlukan format http://schemas.google.com/g/2005#{kind}.{value}. Contoh: http://schemas.google.com/g/2005#event.tentative. Jika ruang nilai dapat diperluas, nilai juga dapat berbentuk URI. Format yang direkomendasikan untuk URI nilai yang diperluas adalah {schema URI}#{value}. Contoh: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

Properti umum yang digunakan untuk semua jenis Google. Perhatikan bahwa adanya anyAttribute dan anyElement dalam skema memungkinkan semua elemen namespace Data Google yang menggunakan properti umum diperluas lebih lanjut di namespace apa pun. Secara hukum, sebaiknya Anda menempatkan elemen gd atau elemen Atom/RSS apa pun di dalam elemen gd lainnya. Hal ini harus dilakukan dengan bijaksana, dan dalam kebanyakan kasus, penggunaan seperti itu harus didokumentasikan sebagai properti eksplisit dari jenis elemen gd yang memuatnya.

Properti

Properti	Jenis	Deskripsi
`@xml:base`	`uri`	Konstruksi XML standar untuk menjelaskan dasar URI relatif bertingkat.
`@xml:lang`	`text`	Bahasa string bertingkat.

Skema

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

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

gd:komentar

Berisi feed komentar untuk entri lampiran (seperti acara kalender).

Properti

Properti	Jenis	Deskripsi
`@rel`?	`string`	Jenis komentar yang ada di dalamnya. Saat ini, ada perbedaan antara komentar dan ulasan reguler.
`gd:feedLink`?	`feedLink`	Feed komentar. Feed ini harus menerapkan jenis Pesan.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#regular` atau tidak dicantumkan	Komentar reguler (dari pengguna).
`http://schemas.google.com/g/2005#reviews`	Ulasan profesional.

Contoh

Feed komentar:

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

Feed ulasan:

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

Skema

start = comments

comments =
   element gd:comments {
      gdCommonProperties,
      attribute rel { xs:string }?,
      (feedLink?)
   }

gd:dihapus

Elemen penanda yang, jika ada, menunjukkan entri yang memuatnya telah dihapus.

Properti

Tidak ada.

Skema

start = deleted

deleted =
   element gd:deleted

email:gd

Alamat email yang terkait dengan entitas penampung (yang biasanya merupakan entitas yang mewakili orang atau lokasi).

Properti

Properti	Jenis	Deskripsi
`@address`	`xs:string`	Alamat email.
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama alamat email ini. UI dapat menampilkan label seperti "Kantor", "Pribadi", "Preferensi", dll.
`@rel`?	`xs:string`	Nilai terprogram yang mengidentifikasi jenis email; lihat di bawah untuk detailnya.
`@primary`?	`xs:boolean`	Jika beberapa ekstensi email muncul dalam jenis kontak, menunjukkan ekstensi email mana yang utama. Maksimal satu email dapat berupa email utama. Nilai defaultnya adalah `"false"`.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	Alamat email yang bukan rumah atau kantor. `label` dapat digunakan untuk menunjukkan jenis sebenarnya.
`http://schemas.google.com/g/2005#work`

Contoh

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

Skema

start = email

email =
   element gd:email {
      attribute address { xs:string },
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:entriLink

Merepresentasikan entri bertingkat yang logis. Misalnya, <gd:who> yang mewakili kontak mungkin memiliki entri bertingkat dari feed kontak.

Properti

Properti	Jenis	Deskripsi
`@href`?	`xs:string`	Menentukan URI entri. Jika entri bertingkat disematkan dan tidak ditautkan, atribut ini dapat dihilangkan.
`@readOnly`?	`xs:boolean`	Menentukan apakah entri yang dimuat adalah hanya baca. Nilai default-nya adalah `"false"`.
`@rel`?	`xs:string`	Menentukan hubungan link; memungkinkan layanan menyediakan beberapa jenis link entri untuk satu entitas. Memiliki semantik dan nilai yang diizinkan yang sama dengan atribut `rel` dari elemen `<atom:link>`.
`atom:entry`?	`atomEntry`	Konten entri.

Batasan

Salah satu dari keduanya atau @href atau <atom:entry> harus ada.
Jika atom:entry tidak ada, klien dapat mengambil konten dari URI entri di @href. Jika atom:entry ada, konten harus sama dengan yang akan diambil dari @href pada saat entri dibuat.
Jika PUT atau POST berisi <gd:entryLink> dan atribut @href ditentukan, nilai atribut akan digunakan untuk membuat link; jika elemen atom:entry juga ada, elemen tersebut akan diabaikan. Jika atribut @href tidak ditentukan, maka elemen atom:entry akan disimpan sebagai entri sematan atau disimpan di feed lain dan ditautkan. Perhatikan bahwa beberapa layanan mungkin tidak mendukung semua opsi tersebut.

Contoh

Informasi kontak dalam <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>

Hanya referensi eksternal (entri hanya baca):

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

Skema

start = entryLink

entryLink =
   element gd:entryLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      (atomEntry?)
   }

gd:ekstensiproperti

Memungkinkan Anda menyimpan data kustom dalam jumlah terbatas sebagai properti tambahan dari entitas yang mencakupnya.

Perhatikan bahwa adanya anyForeignElement memungkinkan feed menyematkan XML yang valid secara opsional dalam elemen gd:extendedProperty (secara eksklusif saling dengan atribut value).

Properti

Properti	Jenis	Deskripsi
`@name`	`xs:string`	Menentukan nama properti yang dinyatakan sebagai URI. URI properti yang diperluas biasanya mengikuti konvensi {scheme}#{local-name}.
`@value`?	`xs:string`	Nilai properti.

Contoh

ID eksternal untuk acara kalender:

<gd:extendedProperty name="http://www.example.com/schemas/2007#mycal.id"
  value="1234"></gd:extendedProperty>

Xml tambahan untuk entri kontak

<gd:extendedProperty name="com.google">
  <some_xml>value</some_xml>
</gd:extendedProperty>

Skema

start = extendedProperty

extendedProperty =
   element gd:extendedProperty {
      attribute name { xs:string },
      attribute value { xs:string } ?,
      (anyForeignElement*)
   }

gd:feedFeed

Merepresentasikan feed bertingkat yang logis. Misalnya, feed kalender mungkin memiliki feed bertingkat yang mewakili semua komentar pada entri.

Properti

Properti	Jenis	Deskripsi
`@countHint`?	`xs:unsignedInt`	Petunjuk tentang jumlah entri dalam feed. Bergantung pada penerapan, mungkin ini bukan jumlah yang tepat.
`@href`?	`xs:string`	Menentukan URI feed. Jika feed bertingkat disematkan dan tidak ditautkan, atribut ini dapat dihilangkan.
`@readOnly`?	`xs:boolean`	Menentukan apakah feed yang dimuat bersifat hanya baca.
`@rel`?	`xs:string`	Menentukan hubungan link; memungkinkan layanan menyediakan beberapa jenis link feed untuk satu entitas. Memiliki semantik dan nilai yang diizinkan yang sama dengan atribut `rel` dari elemen `<atom:link>`.
`atom:feed`?	`atomFeed`	Konten feed.

Batasan

Salah satu dari keduanya atau @href atau <atom:feed> harus ada.
Jika atom:feed tidak ada, klien dapat mengambil konten dari URI di @href. Jika ada, konten harus sama dengan yang akan diambil dari @href pada saat feed dibuat.
Jika PUT atau POST berisi <gd:feedLink> dan atribut @href ditentukan, nilai atribut akan digunakan untuk membuat link; jika elemen <atom:feed> juga ada, elemen ini akan diabaikan. Jika atribut @href tidak ditentukan, maka elemen <atom:feed> akan disimpan sebagai feed tersemat. Perhatikan bahwa beberapa layanan mungkin tidak mendukung semua opsi tersebut.

Contoh

Blog:

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

Hanya referensi eksternal:

<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments"
            countHint="10"/>

Feed yang disematkan dalam entri Atom yang mewakili daftar:

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

Skema

start = feedLink

feedLink =
   element gd:feedLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      attribute countHint { xs:unsignedInt }?,
      (atomFeed?)
   }

gd:geoPt

Lokasi geografis (lintang, bujur, ketinggian).

Tidak digunakan lagi. Elemen ini tidak digunakan lagi. Untuk data pemberian tag geografis, gunakan GeoRSS.

Properti

Properti	Jenis	Deskripsi
`@elev`?	`xs:float`	Ketinggian dalam meter. Nilai negatif menunjukkan kedalaman di bawah permukaan laut rata-rata.
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama lokasi ini. Hal ini memungkinkan UI menampilkan label seperti "Posisi Saat Ini".
`@lat`	`xs:float`	Lintang dalam derajat. Nilai positif berarti Utara, nilai negatif berarti Selatan. Rentangnya adalah [-90.0, 90.0].
`@lon`	`xs:float`	Bujur dalam derajat. Nilai positif berarti Timur, nilai negatif berarti Barat. Rentangnya adalah [-180.0, 180.0].
`@time`?	`xs:dateTime`	Stempel waktu.

Contoh

<gd:geoPt lat="40.75" lon="-74.0"/>

<gd:geoPt lat="27.98778" lon="86.94444" elev="8850.0"/>

Skema

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

Alamat pesan instan yang terkait dengan entitas yang memuatnya.

Properti

Properti	Jenis	Deskripsi
`@address`	`xs:string`	Alamat IM.
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama alamat IM ini. UI dapat menampilkan label seperti "Kantor", "Pribadi", "Preferensi", dll.
`@rel`?	`xs:string`	Nilai terprogram yang mengidentifikasi jenis IM; lihat di bawah untuk detailnya.
`@protocol`?	`xs:string`	Mengidentifikasi jaringan IM. Nilainya bisa berupa salah satu nilai standar (ditampilkan di bawah) atau URI yang mengidentifikasi jaringan IM eksklusif.
`@primary`?	`xs:boolean`	Jika beberapa ekstensi IM muncul dalam jenis kontak, menunjukkan ekstensi IM mana yang utama. Maksimal satu IM dapat berupa primer. Nilai defaultnya adalah `"false"`.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	Alamat IM yang bukan rumah atau kantor. `label` dapat digunakan untuk menunjukkan jenis sebenarnya.
`http://schemas.google.com/g/2005#work`

nilai atribut protokol

Tabel berikut menunjukkan beberapa kemungkinan nilai untuk atribut @protocol.

Nilai	Deskripsi
`http://schemas.google.com/g/2005#AIM`	Protokol AOL Instant Messenger
`http://schemas.google.com/g/2005#MSN`	Protokol MSN Messenger
`http://schemas.google.com/g/2005#YAHOO`	Protokol Yahoo Messenger
`http://schemas.google.com/g/2005#SKYPE`	Protokol Skype
`http://schemas.google.com/g/2005#QQ`	Protokol QQ
`http://schemas.google.com/g/2005#GOOGLE_TALK`	Protokol Google Talk
`http://schemas.google.com/g/2005#ICQ`	Protokol ICQ
`http://schemas.google.com/g/2005#JABBER`	Protokol Jabber

Contoh

Alamat IM untuk 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"/>

Alamat IM yang diberikan pengguna dengan protokol yang tidak ditentukan. Alamat tersebut berguna untuk tujuan tampilan, tetapi sulit untuk ditangani secara terprogram.

<gd:im label="Other" address="foo@baz.example.com"/>

Skema

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

Organisasi, biasanya dikaitkan dengan kontak.

Properti

Properti	Jenis	Deskripsi
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama organisasi ini. UI dapat menampilkan label seperti "Kantor", "Sukarelawan", "Lembaga Profesional", dll.
`@rel`?	`xs:string`	Nilai terprogram yang mengidentifikasi jenis organisasi.
`@primary`?	`xs:boolean`	Jika beberapa ekstensi organisasi muncul dalam jenis kontak, menunjukkan ekstensi mana yang bersifat utama. Maksimal satu organisasi dapat bersifat utama. Nilai defaultnya adalah `"false"`.
`gd:orgName`?	`orgName`	Nama organisasi.
`gd:orgTitle`?	`orgTitle`	Jabatan seseorang dalam organisasi.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#other`	Organisasi yang tidak berfungsi. `label` dapat digunakan untuk menunjukkan jenis sebenarnya.
`http://schemas.google.com/g/2005#work`

Contoh

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

Skema

start = organzation

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
      orgName?,
      orgTitle?,
   }

Nama:

Nama organisasi. Harus muncul dalam elemen gd:organization.

Contoh

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

Skema

start = orgName

orgName =
   element gd:orgName { xs:string }

gd.orgJudul

Jabatan seseorang dalam organisasi. Harus muncul dalam elemen gd:organization.

Contoh

<gd:orgTitle>President and CEO</gd:orgTitle>

Skema

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:OriginalEvent

Setara dengan properti ID Pengulangan yang ditentukan dalam bagian 4.8.4.4 pada RFC 2445. Muncul di setiap acara rutin, untuk mengidentifikasi acara asli.

Berisi elemen <gd:when> yang menentukan waktu mulai asli dari instance yang telah menjadi pengecualian.

Properti

Properti	Jenis	Deskripsi
`@id`	`xs:string`	ID peristiwa untuk peristiwa asli.
`@href`	`xs:string`	URL feed peristiwa untuk peristiwa asli.

Contoh

Menentukan peristiwa asli:

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

Skema

start = originalEvent

originalEvent =
   element gd:originalEvent {
      attribute id { xs:string },
      attribute href { xs:string },
      when
   }

gd:nomor telepon

Nomor telepon yang terkait dengan entitas penampung (yang biasanya merupakan entitas yang mewakili orang atau lokasi).

Properti

Properti	Jenis	Deskripsi
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama nomor telepon ini. Pada umumnya, `@label` tidak diperlukan karena `@rel` secara unik mengidentifikasi angka dan memungkinkan UI menampilkan label yang tepat seperti "Seluler", "Rumah", "Kantor", dll. Namun, jika satu orang memiliki (misalnya) beberapa ponsel, properti ini dapat digunakan untuk membedakannya.
`@rel`?	`xs:string`	Nilai terprogram yang mengidentifikasi jenis nomor telepon; lihat di bawah untuk mengetahui detailnya.
`@uri`?	`xs:string`	"URI telp" opsional yang digunakan untuk mewakili nomor dengan cara formal, berguna untuk akses terprogram, seperti jembatan VoIP/PSTN. Lihat RFC 3966 untuk informasi selengkapnya tentang URI tel.
`@primary`?	`xs:boolean`	Jika beberapa ekstensi nomor telepon muncul dalam jenis kontak, menunjukkan ekstensi mana yang utama. Maksimal satu nomor telepon dapat menjadi nomor utama. Nilai defaultnya adalah `"false"`.
`text()`	`xs:string`	Nomor telepon yang dapat dibaca manusia; dapat dalam format nomor telepon apa pun. Spasi kosong di awal dan akhir tidak signifikan. Baris baru dalam string juga tidak signifikan, dan dapat dihapus atau diratakan menjadi satu spasi.

nilai rel

Nilai	Deskripsi
`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`	Jenis angka khusus yang tidak sesuai dengan nilai `rel` lainnya. Misalnya, perangkat TTY. `label` dapat digunakan untuk menunjukkan jenis sebenarnya.
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`

Contoh

Nomor telepon sederhana yang dimasukkan oleh pengguna:

<gd:phoneNumber>(425) 555-8080 ext. 72585</gd:phoneNumber>

Nomor telepon yang sama diambil dari direktori:

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

Nomor dengan label:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212">
  +1 206 555 1212
</gd:phoneNumber>

Skema

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

Alamat pos.

Properti

Properti	Jenis	Deskripsi
`@label`?	`xs:string`	Nilai string sederhana yang digunakan untuk memberi nama alamat ini.
`@rel`?	`xs:string`	Nilai terprogram yang mengidentifikasi jenis alamat pos; lihat di bawah untuk mengetahui detailnya.
`@primary`?	`xs:boolean`	Jika beberapa ekstensi alamat pos muncul dalam jenis kontak, menunjukkan ekstensi mana yang utama. Maksimal satu alamat pos dapat berupa alamat utama. Nilai defaultnya adalah `"false"`.
`text()`	`xs:string`	Alamat sebagai teks. Spasi kosong di awal dan akhir tidak signifikan. Baris baru dalam string sangat penting.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	Alamat yang bukan rumah atau kantor. `label` dapat digunakan untuk menunjukkan jenis sebenarnya.
`http://schemas.google.com/g/2005#work`

Contoh

<gd:postalAddress>
  500 West 45th Street
  New York, NY 10036
</gd:postalAddress>

Skema

start = postalAddress

postalAddress =
   element gd:postalAddress {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      (xs:string)
   }

gd:rating

Mewakili rating numerik entitas yang menyertakan entitas, seperti komentar. Setiap rating menyediakan skalanya sendiri, meskipun dapat dinormalisasi oleh layanan; misalnya, beberapa layanan mungkin mengonversi semua rating menjadi skala dari 1 hingga 5.

Properti

Properti	Jenis	Deskripsi
`@average`?	`xs:float`	Rating rata-rata.
`@max`	`xs:int`	Nilai maksimum skala rating.
`@min`	`xs:int`	Nilai minimum skala rating.
`@numRaters`?	`xs:int`	Jumlah rating yang diperhitungkan saat menghitung nilai rata-rata.
`@rel`?	`xs:string`	Menentukan aspek yang diberi rating. Jika tidak ditentukan, rating adalah rating secara keseluruhan.
`@value`?	`xs:int`	Nilai rating.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#overall` atau tidak dicantumkan	Rating secara keseluruhan. Nilai yang lebih tinggi berarti rating yang lebih baik.
`http://schemas.google.com/g/2005#price`	Rating harga. Nilai yang lebih tinggi berarti harga lebih tinggi.
`http://schemas.google.com/g/2005#quality`	Rating kualitas. Nilai yang lebih tinggi berarti kualitas yang lebih baik.

Contoh

Peringkat keseluruhan 4/5:

<gd:rating value="4" min="1" max="5"/>

Rating rentang harga yang paling mahal:

<gd:rating rel="http://schemas.google.com/g/2005#price" value="5" min="1" max="5"/>

Dinilai oleh 200 pengguna dengan peringkat rata-rata 4,65 dari 5:

<gd:rating average="4.65" min="1" max="5" numRaters="200"/>

Skema

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

Menyatakan tanggal dan waktu saat acara berulang berlangsung.

String yang menentukan pengulangan terdiri dari serangkaian properti, yang masing-masing ditentukan dalam standar iCalendar (RFC 2445).

Secara khusus, string biasanya dimulai dengan properti DTSTART yang menunjukkan waktu mulai dari instance pertama peristiwa, dan sering kali properti DTEND atau properti DURATION untuk menunjukkan kapan instance pertama berakhir. Selanjutnya adalah properti Rrules, RDATE, EXrule, dan/atau EXDATE, yang secara kolektif menentukan peristiwa berulang dan pengecualiannya (tetapi lihat di bawah). (Lihat bagian 4.8.5 dari RFC 2445 untuk informasi selengkapnya tentang properti komponen pengulangan ini.) Terakhir dilengkapi komponen Vv2, yang memberikan aturan zona waktu mendetail untuk setiap ID zona waktu yang disebutkan di properti sebelumnya.

Layanan Google seperti Google Kalender biasanya tidak membuat properti EXrule dan EXDATE untuk mewakili pengecualian pada acara rutin. Sebaliknya, layanan tersebut menghasilkan elemen <gd:recurrenceException>. Namun, layanan Google dapat tetap menyertakan properti EXrule dan/atau EXDATE; misalnya, pengguna dapat mengimpor acara dan pengecualian ke Kalender, dan jika acara yang diimpor tersebut berisi properti EXrule atau EXDATE, Kalender akan memberikan properti tersebut saat mengirimkan elemen <gd:recurrence>.

Perhatikan bahwa penggunaan <gd:recurrenceException> berarti Anda tidak dapat memastikan hanya dengan memeriksa elemen <gd:recurrence> apakah ada pengecualian untuk deskripsi pengulangan. Untuk memastikan Anda menemukan semua pengecualian, cari elemen <gd:recurrenceException> di feed, dan gunakan elemen <gd:originalEvent> untuk mencocokkannya dengan elemen <gd:recurrence>.

Properti

Properti	Jenis	Deskripsi
`text()`	`xs:string`	Deskripsi berulang.

Contoh

Acara rutin yang berlangsung setiap pagi dari pukul 06.00 hingga 07.00, Waktu Pasifik, dari 14 Maret hingga 21 Maret 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>

Skema

start = recurrence

recurrence =
   element gd:recurrence {
      (xs:string)
   }

gd:pengulanganException

Merupakan acara yang merupakan pengecualian untuk acara rutin—yaitu, acara rutin yang di dalamnya satu atau beberapa aspek acara rutin (seperti daftar kehadiran, waktu, atau lokasi) telah diubah.

Berisi elemen <gd:originalEvent> yang menentukan acara rutin asli yang menjadi pengecualian untuk peristiwa ini.

Jika Anda mengubah acara rutin, acara tersebut menjadi pengecualian. Bergantung pada perubahan yang Anda lakukan pada peristiwa, pengecualian berperilaku dengan salah satu dari dua cara yang berbeda saat peristiwa berulang asli diubah:

Jika Anda menambahkan, mengubah, atau menghapus komentar, tamu, atau respons tamu, pengecualian akan tetap terkait dengan acara asli, dan perubahan pada acara asli juga akan mengubah pengecualian.
Jika Anda membuat perubahan lain pada pengecualian (seperti mengubah waktu atau lokasi), instance akan menjadi "khusus", yang berarti instance tersebut tidak lagi terikat erat dengan peristiwa aslinya. Jika Anda mengubah acara asli, pengecualian khusus tidak akan berubah. Namun, lihat di bawah ini.

Misalnya, Anda mengadakan rapat setiap hari Selasa dan Kamis pukul 14.00. Jika Anda mengubah daftar kehadiran untuk rapat Kamis ini (tetapi bukan untuk rapat yang dijadwalkan secara rutin), rapat akan menjadi pengecualian. Jika Anda mengubah waktu untuk rapat Kamis ini (tetapi bukan untuk rapat yang dijadwalkan secara rutin), acara tersebut akan menjadi khusus.

Terlepas dari apakah pengecualian bersifat khusus atau tidak, jika Anda melakukan sesuatu yang menghapus instance tempat asal pengecualian tersebut, pengecualian akan dihapus. Perhatikan bahwa mengubah hari atau waktu acara rutin akan menghapus semua acara, dan membuat yang baru.

Misalnya, setelah Anda mengkhususkan rapat hari Kamis ini, misalnya Anda mengubah rapat berulang yang akan dilakukan pada hari Senin, Rabu, dan Jumat. Perubahan tersebut akan menghapus semua instance berulang dari rapat Selasa/Kamis, termasuk instance khusus.

Jika instance tertentu dari acara rutin dihapus, instance tersebut akan muncul sebagai <gd:recurrenceException> yang berisi <gd:entryLink> dengan <gd:eventStatus> yang ditetapkan ke "http://schemas.google.com/g/2005#event.canceled". (Untuk informasi selengkapnya tentang peristiwa yang dibatalkan, lihat RFC 2445.)

Properti

Properti	Jenis	Deskripsi
`@specialized`	`xs:boolean`	Menunjukkan apakah pengecualian bersifat khusus atau tidak.
`gd:entryLink`	`entryLink`	Entri Peristiwa yang memberikan detail tentang pengecualian.
`gd:originalEvent`	`originalEvent`	Peristiwa berulang asli yang menjadi pengecualian ini.

Contoh

Pengecualian untuk acara rutin (dengan beberapa bagian diganti dengan ID yang dicetak miring singkat agar lebih jelas):

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

Skema

start = recurrenceException

recurrenceException =
   element gd:recurrenceException {
      attribute specialized { xs:boolean },
      (entryLink
       & originalEvent)
   }

gd:pengingat

Paling sering digunakan di: <gd:when>

Interval waktu, yang menunjukkan berapa lama sebelum atribut @startTime atau @dueTime entitas penampung harus dikeluarkan. Atau, dapat menentukan waktu absolut untuk mengirim pengingat. Juga menentukan metode notifikasi, yang menunjukkan media apa yang harus digunakan sistem untuk mengingatkan pengguna.

Properti

Properti	Jenis	Deskripsi
`@absoluteTime`?	`xs:dateTime`	Waktu absolut saat pengingat akan dikeluarkan. Ini biasanya digunakan ketika pengguna menggunakan fitur "tunda" untuk menunda pengingat sebelumnya. Jika zona waktu tidak ditentukan, waktu lokal observer akan diasumsikan.
`@method`?	`xs:string`	Metode notifikasi yang sebaiknya digunakan pengingat. Dapat memiliki salah satu nilai berikut: `alert` (menyebabkan notifikasi muncul saat pengguna melihat kalender di browser), `email` (mengirim pesan email kepada pengguna), atau `sms` (mengirim pesan teks SMS kepada pengguna).
`@days`?	`xs:unsignedInt`	Jangka waktu sebelum `gd:when/@startTime` saat pengingat harus dikeluarkan. Jika waktu target parent entity adalah tanggal, bukan waktu tertentu, atribut ini relatif terhadap tengah malam (00.00) pada tanggal tersebut.
`@hours`?	`xs:unsignedInt`
`@minutes`?	`xs:unsignedInt`

Saat Anda membuat atau mengedit entri <gd:when>, gunakan konvensi berikut untuk mencapai hasil tertentu:

Untuk memberi tahu layanan agar menggunakan pengingat default pengguna, sertakan elemen <gd:reminder> tanpa atribut. Jika Anda menentukan atribut durasi tetapi tanpa method, layanan akan menggunakan metode notifikasi default pengguna dengan durasi yang Anda tentukan.
Untuk memberi tahu layanan agar tidak mengeluarkan pengingat apa pun untuk acara (atau menghapus pengingat yang ada saat memperbarui acara), jangan sertakan elemen <gd:reminder>.

Batasan

Maksimal satu dari @days, @hours, @minutes, atau @absoluteTime dapat ditentukan. Untuk menentukan durasi campuran, konversikan ke unit yang paling tepat. Misalnya, untuk menentukan 1 jam 30 menit, gunakan @minutes="90".
Anda tidak dapat menggunakan nilai negatif untuk atribut (jadi jika ingin pengingat terjadi setelah waktu mulai, Anda harus menggunakan @absoluteTime).
Peristiwa tertentu tidak dapat memiliki lebih dari lima pengingat yang terkait dengannya.
Saat menambahkan pengingat ke acara, jika Anda menentukan metode alert, email, atau sms, Anda juga harus menentukan durasi.

Contoh

Pengingat 15 menit untuk rapat:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00">
  <gd:reminder minutes="15"/>
</gd:when>

Rapat yang sama seperti di atas, tetapi ditunda selama 10 menit setelah pengingat pukul 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>

Skema

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

ID resource buram, berbeda dengan atom:id karena tidak harus berupa URI yang valid. Beberapa layanan menyediakan ID terpisah untuk digunakan saat membuat permintaan berikutnya. Penggunaan persisnya adalah spesifik per layanan.

Contoh

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

Skema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:kapan

Merepresentasikan jangka waktu atau instan.

Properti

Properti	Jenis	Deskripsi
`@endTime`?	`xs:dateTime` atau `xs:date`	Menjelaskan kapan acara berakhir. Jika zona waktu tidak ditentukan, zona waktu lokal observer akan diasumsikan.
`@startTime`	`xs:dateTime` atau `xs:date`	Menjelaskan kapan peristiwa dimulai atau (untuk peristiwa berdurasi nol) saat peristiwa terjadi. Jika zona waktu tidak ditentukan, zona waktu lokal observer akan diasumsikan.
`@valueString`?	`xs:string`	Nilai string sederhana yang dapat digunakan sebagai representasi jangka waktu ini.

Batasan

xs:dateTime tidak dapat digabungkan dengan xs:date di startTime/endTime.
Jika endTime tidak ditentukan, maka acara dianggap sebagai instan dalam waktu (jika @startTime menyertakan waktu) atau acara satu hari (jika @startTime hanya tanggal).

Contoh

Acara satu hari:

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

Representasi alternatif dari acara satu hari:

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

Acara dua hari (6 dan 7 Juni) dengan deskripsi string:

<gd:when startTime="2005-06-06" endTime="2005-06-08" valueString="This weekend"/>

Rapat satu jam:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"/>

Peristiwa berdurasi nol:

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

Skema

start = when

when =
   element gd:when {
      gdCommonProperties,
      attribute startTime { (xs:date | xs:dateTime) },
      attribute endTime { (xs:date | xs:dateTime) }?,
      attribute valueString { xs:string }?
   }

gd.di mana

Tempat (seperti lokasi acara) yang terkait dengan entitas yang memuatnya. Jenis atribusi ditentukan oleh atribut rel; detail lokasi terdapat dalam entri Kontak yang disematkan atau ditautkan.

Elemen <gd:where> lebih umum daripada elemen <gd:geoPt>. Panduan ini mengidentifikasi tempat menggunakan deskripsi teks dan/atau entri Kontak, sedangkan yang kedua mengidentifikasi tempat menggunakan lokasi geografis tertentu.

Properti

Properti	Jenis	Deskripsi
`@label`?	`xs:string`	Menentukan label yang dapat dibaca pengguna untuk membedakan lokasi ini dengan lokasi lain.
`@rel`?	`xs:string`	Menentukan hubungan antara entity yang memuatnya dan lokasi yang dimuat. Nilai yang memungkinkan (lihat di bawah) ditentukan oleh elemen lain. Misalnya, `<gd:when>` menentukan `http://schemas.google.com/g/2005#event`.
`@valueString`?	`xs:string`	Nilai string sederhana yang dapat digunakan sebagai representasi lokasi ini.
`gd:entryLink`?	`entryLink`	Entri yang merepresentasikan detail lokasi. Entri ini harus menerapkan jenis Contact.

nilai rel

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event` atau tidak dicantumkan	Tempat berlangsungnya acara penutup.
`http://schemas.google.com/g/2005#event.alternate`	Lokasi sekunder. Misalnya, situs jarak jauh dengan link konferensi video ke situs utama.
`http://schemas.google.com/g/2005#event.parking`	Tempat parkir terdekat.

Contoh

Lokasi acara:

<gd:where valueString="Google Cafeteria (Building 40)"/>

Lokasi acara yang lebih rumit:

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

Acara dengan beberapa lokasi:

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

Skema

start = where

where =
   element gd:where {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute label { xs:string }?,
      attribute valueString { xs:string }?,
      (entryLink?)
   }

gd:siapa

Orang yang terkait dengan entitas penampung. Jenis atribusi ditentukan oleh atribut rel; detail tentang orang tersebut terdapat dalam entri Kontak yang disematkan atau ditautkan.

Elemen <gd:who> dapat digunakan untuk menentukan pengirim dan penerima email, penyelenggara acara kalender, dan sebagainya.

Properti

Properti	Jenis	Deskripsi
`@email`?	`xs:string`	Alamat email. Properti ini biasanya digunakan saat `<gd:entryLink>` tidak ditentukan. Alamat harus mematuhi RFC 2822, bagian 3.4.1.
`@rel`?	`xs:string`	Menentukan hubungan antara entity yang memuatnya dan orang yang ada di dalamnya. Lihat di bawah untuk mengetahui kemungkinan nilai.
`@valueString`?	`xs:string`	Nilai string sederhana yang dapat digunakan sebagai representasi dari orang ini.
`gd:attendeeStatus`?	`gEnumConstruct`	Status tamu acara. Enum yang dapat diperluas yang didokumentasikan di bawah.
`gd:attendeeType`?	`gEnumConstruct`	Jenis tamu acara. Enum yang dapat diperluas yang didokumentasikan di bawah.
`gd:entryLink`?	`entryLink`	Entri yang merepresentasikan detail orang. Entri ini harus menerapkan jenis Contact. Dalam banyak kasus, entri ini akan berasal dari feed kontak.

nilai rel

Nilai yang valid untuk @rel bergantung pada jenis elemen <gd:who> yang muncul.

Nilai	Jenis	Deskripsi
`http://schemas.google.com/g/2005#event.attendee`	Peristiwa	Rapat umum/pengacara acara.
`http://schemas.google.com/g/2005#event.organizer`	Peristiwa	Penyelenggara acara. Penyelenggara belum tentu merupakan tamu.
`http://schemas.google.com/g/2005#event.performer`	Peristiwa	Pengisi acara. Mirip dengan `http://schemas.google.com/g/2005#event.speaker`, tetapi lebih menekankan seni daripada pengiriman ucapan.
`http://schemas.google.com/g/2005#event.speaker`	Peristiwa	Pembicara.
`http://schemas.google.com/g/2005#message.bcc`	Pesan	Kirim pesan ke penerima BCC.
`http://schemas.google.com/g/2005#message.cc`	Pesan	Penerima CC pesan.
`http://schemas.google.com/g/2005#message.from`	Pesan	Pengirim pesan (email atau IM).
`http://schemas.google.com/g/2005#message.reply-to`	Pesan	Penerima pesan balasan yang dituju.
`http://schemas.google.com/g/2005#message.to`	Pesan	Kirim pesan ke penerima utama.

Nilai gd:attendeeType

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event.optional`	Peserta opsional.
`http://schemas.google.com/g/2005#event.required`	Peserta wajib diisi.

Nilai gd:attendeeStatus

Nilai	Deskripsi
`http://schemas.google.com/g/2005#event.accepted`	Peserta telah menerima.
`http://schemas.google.com/g/2005#event.declined`	Peserta telah menolak.
`http://schemas.google.com/g/2005#event.invited`	Undangan telah dikirim, tetapi orang tersebut belum menerimanya.
`http://schemas.google.com/g/2005#event.tentative`	Peserta telah menerima secara tentatif.

Contoh

Penerima email:

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

Peserta rapat:

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

Penyelenggara acara:

<gd:who rel="http://schemas.google.com/g/2005#event.organizer" valueString="Receptionist 41"/>

Skema

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 }?)
   }

Kembali ke atas