Dokumen ini menyediakan dokumentasi referensi mendetail untuk protokol mentah (XML dan HTTP) untuk Google Sites Data API.
Dokumen ini tidak berisi informasi tentang library klien bahasa pemrograman. Untuk informasi referensi library klien, lihat link dari bagian khusus bahasa pemrograman dalam panduan developer.
Audiens
Dokumen ini ditujukan bagi para pemrogram yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Google Sites.
Dokumen ini adalah dokumen referensi; dokumen ini mengasumsikan bahwa Anda memahami konsep yang disajikan dalam panduan protokol, dan ide umum di balik protokol Google Data API.
Jenis feed Google Sites
Google Sites Data API menyediakan jenis feed berikut:
Feed aktivitas
Feed Aktivitas adalah feed yang berisi deskripsi semua aktivitas dalam situs.
URI GET feed ini untuk situs dalam domain tertentu adalah:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName dapat berupa "situs", atau domain G Suite.
siteName adalah nama situs seperti yang muncul di URL halaman landing situs: http://sites.google.com/a/domainName/siteName/.
Semua permintaan ke feed ini harus diautentikasi.
Jenis permintaan yang didukung: GET
Feed konten
Feed Konten adalah feed yang berisi konten situs saat ini yang dapat diedit.
URI GET feed ini untuk situs dalam domain tertentu adalah:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName adalah "situs", atau domain G Suite.
siteName adalah nama situs seperti yang muncul di URL halaman landing situs: http://sites.google.com/a/domainName/siteName.
Permintaan ke feed ini mungkin memerlukan atau tidak memerlukan autentikasi, bergantung pada setelan Situs (yang dipublikasikan).
Jenis permintaan yang didukung: GET, POST, PUT, DELETE
Selain parameter kueri Data API standar, Sites Data API mengizinkan parameter opsional berikut
yang mengeluarkan permintaan GET menggunakan feed Konten:
| Parameter | Deskripsi | Jenis | Catatan |
|---|---|---|---|
ancestor |
Hanya meminta entri yang memiliki ancestor yang ditentukan. | string | Berikan ID entri ancestor yang diinginkan. Misalnya: 0123456789. Menampilkan semua entri yang memiliki ancestor yang ditentukan sebagai induk, induk induk, dan sebagainya. |
include-deleted |
Menentukan apakah akan menyertakan entri yang dihapus. | boolean | Nilai yang mungkin adalah true atau false. Jumlah defaultnya adalah false |
include-draft |
Menentukan apakah akan menyertakan entri draf. | boolean | Kemungkinan nilainya adalah true atau false. Jumlah defaultnya adalah false Anda harus menjadi pemilik atau penulis
draf untuk melihatnya. |
kind |
Menentukan jenis entri konten yang akan ditampilkan. Jenis ini mengikuti jenis halaman dalam Google Sites. | daftar string yang dipisahkan koma | Nilai yang mungkin adalah announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Hanya meminta entri yang memiliki induk yang ditentukan. | string | Berikan ID entri induk. Misalnya: 0123456789. |
path |
Meminta konten berdasarkan hierarki halaman tertentu | string | Jalur ke subhalaman dalam Situs untuk mengambil kontennya. Misalnya: path=/path/to/page. |
Feed revisi
Feed revisi adalah feed yang berisi revisi historis konten situs.
URI GET feed ini untuk situs dalam domain tertentu adalah:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName adalah "situs", atau domain G Suite.
siteName adalah nama situs seperti yang muncul di URL halaman landing situs: http://sites.google.com/a/domainName/siteName.
Semua permintaan ke feed ini harus diautentikasi.
Jenis permintaan yang didukung: GET
Feed situs
Feed situs dapat digunakan untuk menampilkan daftar Google Sites yang dimiliki pengguna atau yang izin lihatnya dimiliki pengguna. Alat ini juga dapat digunakan untuk membuat situs baru, menyalin situs, atau mengubah nama situs yang sudah ada.
URI feed untuk listingan Sites adalah:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName dapat berupa "situs", atau domain G Suite.
Semua permintaan ke feed ini harus diautentikasi.
Jenis permintaan yang didukung: GET, POST, PUT
Feed situs mendukung parameter (opsional) berikut saat mengeluarkan permintaan GET untuk mencantumkan situs:
| Parameter | Deskripsi | Jenis | Catatan |
|---|---|---|---|
include-all-sites |
Cantumkan semua situs yang setidaknya dapat dilihat oleh pengguna di domain G Suite. | boolean | Parameter ini hanya berlaku saat mencantumkan situs untuk domain G Suite. Nilai yang mungkin adalah true
atau false. Jumlah defaultnya adalah false |
with-mappings |
Menyertakan pemetaan alamat web dalam entri situs. | boolean | Kemungkinan nilainya adalah true atau false. Jumlah defaultnya adalah false |
Feed ACL
Feed ACL dapat digunakan untuk mencantumkan dan/atau mengubah izin berbagi (ACL) Google Sites.
URI feed untuk listingan Situs adalah:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName dapat berupa "situs", atau domain G Suite.
Semua permintaan ke feed ini harus diautentikasi.
Jenis permintaan yang didukung: GET, POST, PUT, DELETE
Referensi parameter kueri Google Sites
Parameter kueri yang didukung dari protokol Google Data API:
max-resultspublished-max(hanya feed konten)published-min(hanya feed konten)start-indexupdated-maxupdated-minq(kueri teks lengkap)
Lihat setiap feed di atas untuk mengetahui daftar parameter khusus feed tersebut.