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
. Jikaatom:entry
ada, konten harus sama dengan yang akan diambil dari@href
pada saat entri dibuat. - Jika
PUT
atauPOST
berisi<gd:entryLink>
dan atribut@href
ditentukan, nilai atribut akan digunakan untuk membuat link; jika elemenatom:entry
juga ada, elemen tersebut akan diabaikan. Jika atribut@href
tidak ditentukan, maka elemenatom: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 tanpamethod
, 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
, atausms
, 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 denganxs:date
distartTime
/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 }?) }