Panduan Python

Penting: Dokumen ini ditulis sebelum tahun 2012. Opsi autentikasi yang dijelaskan dalam dokumen ini (OAuth 1.0, AuthSub, dan ClientLogin) telah dihentikan secara resmi mulai 20 April 2012 dan tidak lagi tersedia. Sebaiknya Anda bermigrasi ke OAuth 2.0 sesegera mungkin.

Google Sites Data API memungkinkan aplikasi klien mengakses, memublikasikan, dan mengubah konten dalam Google Sites. Aplikasi klien Anda juga dapat meminta daftar aktivitas terbaru, mengambil histori revisi, dan mendownload lampiran.

Selain memberikan beberapa latar belakang tentang kemampuan Sites Data API, panduan ini memberikan contoh untuk berinteraksi dengan API menggunakan library klien Python. Untuk mendapatkan bantuan dalam menyiapkan library klien, lihat Mulai Menggunakan Library Klien Google Data Python. Jika Anda tertarik untuk lebih memahami protokol dasar yang digunakan oleh library klien Python untuk berinteraksi dengan Sites API klasik, lihat panduan protokol.

Audiens

Dokumen ini ditujukan bagi developer yang ingin menulis aplikasi klien yang berinteraksi dengan Google Sites menggunakan Library Klien Google Data Python.

Memulai

Untuk menggunakan library klien Python, Anda memerlukan Python 2.2+ dan modul yang tercantum di halaman wiki DependencyModules. Setelah mendownload library klien, lihat Memulai Library Google Data Python untuk mendapatkan bantuan menginstal dan menggunakan klien.

Menjalankan sampel

Contoh yang berfungsi penuh terletak di subdirektori samples/sites dari repositori Mercurial project (/samples/sites/sites_example.py).

Jalankan contoh sebagai berikut:

python sites_example.py
# or
python sites_example.py --site [sitename] --domain [domain or "site"] --debug [prints debug info if set]

Jika tanda yang diperlukan tidak disediakan, aplikasi akan meminta Anda untuk memasukkan nilai tersebut. Contoh ini memungkinkan pengguna melakukan sejumlah operasi yang menunjukkan cara menggunakan Sites API klasik. Oleh karena itu, Anda harus melakukan autentikasi untuk melakukan operasi tertentu (misalnya, mengubah konten). Program ini juga akan meminta Anda untuk melakukan autentikasi melalui AuthSub, OAuth, atau ClientLogin.

Untuk menyertakan contoh dalam panduan ini ke dalam kode Anda sendiri, Anda memerlukan pernyataan import berikut:

import atom.data
import gdata.sites.client
import gdata.sites.data

Anda juga harus menyiapkan objek SitesClient, yang mewakili koneksi klien ke Sites API klasik. Teruskan nama aplikasi Anda dan nama ruang web Situs (dari URL-nya):

client = gdata.sites.client.SitesClient(source='yourCo-yourAppName-v1', site='yourSiteName')

Untuk menggunakan Situs yang dihosting di domain G Suite, tetapkan domain menggunakan parameter domain:

client = gdata.sites.client.SitesClient(source='yourCo-yourAppName-v1', site='yourSiteName', domain='example.com')

Dalam cuplikan di atas, argumen source bersifat opsional, tetapi direkomendasikan untuk tujuan logging. Formatnya harus mengikuti format: company-applicationname-version

Catatan: Bagian panduan lainnya mengasumsikan bahwa Anda telah membuat objek SitesClient di variabel client.

Mengautentikasi ke Sites API klasik

Library klien Python dapat digunakan untuk menggunakan feed publik atau pribadi. Sites Data API memberikan akses ke feed pribadi dan publik, bergantung pada izin Situs dan operasi yang Anda coba lakukan. Misalnya, Anda mungkin dapat membaca feed konten Situs publik tetapi tidak dapat memperbaruinya - sesuatu yang memerlukan klien terautentikasi. Hal ini dapat dilakukan melalui autentikasi nama pengguna/sandi ClientLogin, AuthSub, atau OAuth.

Lihat Ringkasan Autentikasi Google Data API untuk mengetahui informasi selengkapnya tentang AuthSub, OAuth, dan ClientLogin.

AuthSub untuk aplikasi web

Autentikasi AuthSub untuk Aplikasi Web harus digunakan oleh aplikasi klien yang perlu mengautentikasi penggunanya ke akun Google atau G Suite. Operator tidak memerlukan akses ke nama pengguna dan sandi untuk pengguna Google Sites - hanya token AuthSub yang diperlukan.

import gdata.gauth

def GetAuthSubUrl():
  next = 'http://www.example.com/myapp.py'
  scopes = ['https://sites.google.com/feeds/']
  secure = True
  session = True
  return gdata.gauth.generate_auth_sub_url(next, scopes, secure=secure, session=session)

print '<a href="%s">Login to your Google account</a>' % GetAuthSubUrl()

def GetAuthSubUrl():
  domain = 'example.com'
  next = 'http://www.example.com/myapp.py'
  scopes = ['https://sites.google.com/feeds/']
  secure = True
  session = True
  return gdata.gauth.generate_auth_sub_url(next, scopes, secure=secure, session=session, domain=domain)

OAuth untuk web atau aplikasi terinstal/seluler

OAuth dapat digunakan sebagai alternatif AuthSub, dan ditujukan untuk aplikasi web. OAuth mirip dengan menggunakan mode aman dan terdaftar dari AuthSub, yaitu semua permintaan data harus ditandatangani secara digital dan Anda harus mendaftarkan domain Anda.

ClientLogin untuk aplikasi seluler/terinstal

ClientLogin harus digunakan oleh aplikasi seluler atau yang diinstal yang perlu melakukan autentikasi penggunanya ke Akun Google. Saat pertama kali dijalankan, aplikasi Anda meminta pengguna untuk memasukkan nama pengguna/sandi. Pada permintaan berikutnya, token autentikasi akan dirujuk.

client = gdata.sites.client.SitesClient(source='yourCo-yourAppName-v1')
client.ClientLogin('user@gmail.com', 'pa$$word', client.source);

Kembali ke atas

Feed Situs

Feed situs dapat digunakan untuk mencantumkan Google Sites yang dimiliki atau memiliki izin lihat oleh pengguna. Alat ini juga dapat digunakan untuk mengubah nama situs yang sudah ada. Terakhir, untuk domain G Suite, domain ini juga dapat digunakan untuk membuat dan/atau menyalin seluruh situs.

Situs listingan

Untuk mencantumkan situs yang dapat diakses pengguna, gunakan metode GetSiteFeed() klien. Metode ini menggunakan argumen opsional, uri, yang dapat Anda gunakan untuk menentukan URI feed situs alternatif. Secara default, GetSiteFeed() menggunakan nama situs dan domain yang ditetapkan pada objek klien. Lihat bagian Memulai untuk mengetahui informasi selengkapnya tentang cara menetapkan nilai ini di objek klien Anda.

Berikut adalah contoh pengambilan daftar situs pengguna terautentikasi:

feed = client.GetSiteFeed()

for entry in feed.entry:
  print '%s (%s)' % (entry.title.text, entry.site_name.text)
  if entry.summary.text:
    print 'description: ' + entry.summary.text
  if entry.FindSourceLink():
    print 'this site was copied from site: ' + entry.FindSourceLink()
  print 'acl feed: %s\n' % entry.FindAclLink()
  print 'theme: ' + entry.theme.text

Cuplikan di atas mencetak judul situs, nama situs, situs asal salinan, dan URI feed ACL.

Membuat situs baru

Catatan: Fitur ini hanya tersedia untuk domain G Suite.

Situs baru dapat disediakan dengan memanggil metode CreateSite() library. Serupa dengan helper GetSiteFeed(), CreateSite() juga menerima argumen opsional, uri, yang dapat Anda gunakan untuk menentukan URI feed situs alternatif (jika membuat situs di domain yang berbeda dengan domain yang ditetapkan pada objek SitesClient).

Berikut adalah contoh pembuatan situs baru dengan tema 'slate' dan memberikan judul serta deskripsi (opsional):

client.domain = 'example2.com'  # demonstrates creating a site under a different domain.

entry = client.CreateSite('Title For My Site', description='Site to hold precious memories', theme='slate')
print 'Site created! View it at: ' + entry.GetAlternateLink().href

Permintaan di atas akan membuat situs baru di domain G Suite example2.com. Oleh karena itu, URL situs akan menjadi https://sites.google.com/a/example2.com/title-for-my-site.

Jika situs berhasil dibuat, server akan merespons dengan objek gdata.sites.data.SiteEntry, yang diisi dengan elemen yang ditambahkan oleh server: link ke situs, link ke feed acl situs, nama situs, judul, ringkasan, dan sebagainya.

Menyalin situs

Catatan: Fitur ini hanya tersedia untuk domain G Suite.

CreateSite() juga dapat digunakan untuk menyalin situs yang ada. Untuk melakukannya, teruskan argumen kata kunci source_site. Situs apa pun yang telah disalin akan memiliki link ini, yang dapat diakses melalui entry.FindSourceLink(). Berikut adalah contoh duplikasi situs yang dibuat di bagian Membuat situs baru:

copied_site = client.CreateSite('Copy of Title For My Site', description='My Copy', source_site=entry.FindSourceLink())
print 'Site copied! View it at: ' + copied_site.GetAlternateLink().href

Poin penting:

• Hanya situs dan template situs yang dimiliki pengguna terautentikasi yang dapat disalin.
• Template situs juga dapat disalin. Situs adalah template jika setelan "Publikasikan situs ini sebagai template" dicentang di halaman setelan Google Sites.
• Anda dapat menyalin situs dari domain lain, dan Anda akan tetap terdaftar sebagai pemilik di situs sumber selama proses berlangsung.

Memperbarui metadata situs

Untuk memperbarui judul atau ringkasan situs, Anda memerlukan SiteEntry yang berisi situs yang dimaksud. Contoh ini menggunakan metode GetEntry() untuk mengambil SiteEntry terlebih dahulu, lalu mengubah judul, deskripsi, dan tag kategorinya:

uri = 'https://sites.google.com/feeds/site/example2.com/title-for-my-site'
site_entry = client.GetEntry(uri, desired_class=gdata.sites.data.SiteEntry)

site_entry.title.text = 'Better Title'
site_entry.summary.text = 'Better Description'
category_name = 'My Category'
category = atom.data.Category(
    scheme=gdata.sites.data.TAG_KIND_TERM,
    term=category_name)
site_entry.category.append(category)
updated_site_entry = client.Update(site_entry)

# To force the update, even if you do not have the latest changes to the entry:
# updated_site_entry = client.Update(site_entry, force=True)

Kembali ke atas

Mengambil Feed Aktivitas

Catatan: Akses ke feed ini mengharuskan Anda menjadi kolaborator atau pemilik Situs. Klien Anda harus melakukan autentikasi menggunakan token AuthSub, OAuth, atau ClientLogin. Lihat Mengautentikasi ke layanan Sites.

Anda dapat mengambil aktivitas terbaru (perubahan) Situs dengan mengambil feed aktivitas. Metode GetActivityFeed() library menyediakan akses ke feed ini:

print "Fetching activity feed of '%s'...\n" % client.site
feed = client.GetActivityFeed()

for entry in feed.entry:
  print '%s [%s on %s]' % (entry.title.text, entry.Kind(), entry.updated.text)

Memanggil GetActivityFeed() akan menampilkan objek gdata.sites.data.ActivityFeed yang berisi daftar gdata.sites.data.ActivityEntry. Setiap entri aktivitas berisi informasi tentang perubahan yang dilakukan pada Situs.

Kembali ke atas

Mengambil Histori Revisi

Catatan: Akses ke feed ini mengharuskan Anda menjadi kolaborator atau pemilik Situs. Klien Anda harus melakukan autentikasi menggunakan token AuthSub, OAuth, atau ClientLogin. Lihat Mengautentikasi ke layanan Sites.

Feed revisi memberikan informasi tentang histori revisi untuk setiap entri konten. Metode GetRevisionFeed() dapat digunakan untuk mengambil revisi untuk entri konten tertentu. Metode ini menggunakan parameter uri opsional yang menerima gdata.sites.data.ContentEntry, URI lengkap entri konten, atau ID entri konten.

Contoh ini membuat kueri feed konten, dan mengambil feed revisi untuk entri konten pertama:

print "Fetching content feed of '%s'...\n" % client.site
content_feed = client.GetContentFeed()
content_entry = content_feed.entry[0]

print "Fetching revision feed of '%s'...\n" % content_entry.title.text
revision_feed = client.GetRevisionFeed(content_entry)

for entry in revision_feed.entry:
  print entry.title.text
  print ' new version on:\t%s' % entry.updated.text
  print ' view changes:\t%s' % entry.GetAlternateLink().href
  print ' current version:\t%s...\n' % str(entry.content.html)[0:100]

Memanggil GetRevisionFeed() akan menampilkan objek gdata.sites.data.RevisionFeed yang berisi daftar gdata.sites.data.RevisionEntry. Setiap entri revisi berisi informasi seperti konten pada revisi tersebut, nomor versi, dan waktu pembuatan versi baru.

Kembali ke atas

Feed konten

Mengambil feed konten

Catatan: Feed konten mungkin memerlukan atau tidak memerlukan autentikasi; bergantung pada izin berbagi Situs. Jika Situs bersifat non-publik, klien Anda harus melakukan autentikasi menggunakan token AuthSub, OAuth, atau ClientLogin. Baca bagian Mengautentikasi ke layanan Sites.

Feed konten menampilkan konten terbaru Situs. Ini dapat diakses dengan memanggil metode GetContentFeed() lib, yang mengambil parameter string uri opsional untuk meneruskan kueri yang disesuaikan.

Berikut adalah contoh pengambilan seluruh feed konten dan mencetak beberapa elemen yang menarik:

print "Fetching content feed of '%s'...\n" % client.site
feed = client.GetContentFeed()

for entry in feed.entry:
  print '%s [%s]' % (entry.title.text, entry.Kind())

  # Common properties of all entry kinds.
  print ' content entry id: ' + entry.GetNodeId()
  print ' revision:\t%s' % entry.revision.text
  print ' updated:\t%s' % entry.updated.text

  if entry.page_name:
    print ' page name:\t%s' % entry.page_name.text

  if entry.content:
    print ' content\t%s...' % str(entry.content.html)[0:100]

  # Subpages/items will have a parent link.
  parent_link = entry.FindParentLink()
  if parent_link:
    print ' parent link:\t%s' % parent_link

  # The alternate link is the URL pointing to Google Sites.
  if entry.GetAlternateLink():
    print ' view in Sites:\t%s' % entry.GetAlternateLink().href

  # If this entry is a filecabinet, announcementpage, etc., it will have a feed of children.
  if entry.feed_link:
    print ' feed of items:\t%s' % entry.feed_link.href

  print

Tips: entry.Kind() dapat digunakan untuk menentukan jenis entri.

Objek feed yang dihasilkan adalah gdata.sites.data.ContentFeed yang berisi daftar gdata.sites.data.ContentEntry. Setiap entri mewakili halaman/item yang berbeda dalam Situs pengguna dan memiliki elemen khusus untuk jenis entrinya. Lihat contoh aplikasi untuk mendapatkan gambaran yang lebih baik tentang beberapa properti yang tersedia di setiap jenis entri.

Kembali ke atas

Contoh kueri feed konten

Anda dapat menelusuri feed konten menggunakan beberapa parameter kueri Google Data API standar dan parameter khusus untuk Sites API klasik. Untuk informasi yang lebih mendetail dan daftar lengkap parameter yang didukung, lihat Panduan Referensi.

Catatan: Contoh di bagian ini menggunakan metode helper gdata.sites.client.MakeContentFeedUri() untuk membuat URI dasar feed konten.

Mengambil jenis entri tertentu

Untuk mengambil hanya jenis entri tertentu, gunakan parameter kind. Sebagai contoh, cuplikan ini hanya menampilkan entri attachment:

kind = 'webpage'

print 'Fetching only %s entries' % kind
uri = '%s?kind=%s' % (client.MakeContentFeedUri(), kind)
feed = client.GetContentFeed(uri=uri)

Untuk menampilkan lebih dari satu jenis, pisahkan setiap kind dengan koma. Misalnya, cuplikan ini menampilkan entri filecabinet dan listpage:

kind = ','.join(['filecabinet', 'listpage'])

print 'Fetching only %s entries' % kind
uri = '%s?kind=%s' % (client.MakeContentFeedUri(), kind)
feed = client.GetContentFeed(uri=uri)

Mengambil halaman berdasarkan jalur

Jika mengetahui jalur relatif halaman dalam Google Sites, Anda dapat menggunakan parameter path untuk mengambil halaman tertentu tersebut. Contoh ini akan menampilkan halaman yang berada di http://sites.google.com/domainName/siteName/path/to/the/page:

path = '/path/to/the/page'

print 'Fetching page by its path: ' + path
uri = '%s?path=%s' % (client.MakeContentFeedUri(), path)
feed = client.GetContentFeed(uri=uri)

Mengambil semua entri pada halaman induk

Jika Anda mengetahui ID entri konten halaman (misalnya, "1234567890" dalam contoh di bawah), Anda dapat menggunakan parameter parent untuk mengambil semua entri turunannya (jika ada):

parent = '1234567890'

print 'Fetching all children of parent entry: ' + parent
uri = '%s?parent=%s' % (client.MakeContentFeedUri(), parent)
feed = client.GetContentFeed(uri=uri)

Untuk parameter tambahan, lihat Panduan Referensi.

Kembali ke atas

Membuat Konten

Catatan: Sebelum membuat konten untuk situs, pastikan Anda telah menetapkan situs di klien.
client.site = "siteName"

Konten baru (halaman web, halaman daftar, lemari file, halaman pengumuman, dll.) dapat dibuat menggunakan CreatePage(). Argumen pertama untuk metode ini harus berupa jenis halaman yang akan dibuat, diikuti dengan judul, dan konten HTML-nya.

Untuk daftar jenis node yang didukung, lihat parameter kind dalam Panduan Referensi.

Membuat item / halaman baru

Contoh ini membuat webpage baru di tingkat teratas, menyertakan beberapa XHTML untuk isi halaman, dan menetapkan judul judul ke 'Judul Halaman Web Baru':

entry = client.CreatePage('webpage', 'New WebPage Title', html='<b>HTML content</b>')
print 'Created. View it at: %s' % entry.GetAlternateLink().href

Jika permintaan berhasil, entry akan berisi salinan entri yang dibuat di server, sebagai gdata.sites.gdata.ContentEntry.

Untuk membuat jenis entri yang lebih kompleks yang diisi saat pembuatan (misalnya, listpage dengan judul kolom), Anda harus membuat gdata.sites.data.ContentEntry secara manual, mengisi properti yang diinginkan, dan memanggil client.Post().

Membuat item/halaman berdasarkan jalur URL kustom

Secara default, contoh sebelumnya akan dibuat di URL http://sites.google.com/domainName/siteName/new-webpage-title dan memiliki judul halaman 'Judul Halaman Web Baru'. Artinya, judul dinormalisasi menjadi new-webpage-title untuk URL. Untuk menyesuaikan jalur URL halaman, Anda dapat menetapkan properti page_name pada entri konten. Helper CreatePage() menyediakan ini sebagai argumen kata kunci opsional.

Contoh ini membuat halaman filecabinet baru dengan judul 'Penyimpanan File', tetapi membuat halaman di bawah URL http://sites.google.com/domainName/siteName/files (bukan http://sites.google.com/domainName/siteName/file-storage) dengan menentukan properti page_name.

entry = client.CreatePage('filecabinet', 'File Storage', html='<b>HTML content</b>', page_name='files')
print 'Created. View it at: ' + entry.GetAlternateLink().href

Server menggunakan aturan prioritas berikut untuk memberi nama jalur URL halaman:

1. page_name, jika ada. Harus memenuhi a-z, A-Z, 0-9, -, _.
2. title, tidak boleh null jika nama halaman tidak ada. Normalisasinya adalah memangkas + menciutkan spasi kosong ke '-' dan menghapus karakter yang tidak cocok dengan a-z, A-Z, 0-9, -, _.

Membuat subhalaman

Untuk membuat subhalaman (turunan) di bawah halaman induk, gunakan argumen kata kunci parent CreatePage(). parent dapat berupa gdata.sites.gdata.ContentEntry atau string yang mewakili ID mandiri lengkap entri konten.

Contoh ini mengkueri feed konten untuk announcementpage dan membuat announcement baru di bawah feed pertama yang ditemukan:

uri = '%s?kind=%s' % (client.MakeContentFeedUri(), 'announcementpage')
feed = client.GetContentFeed(uri=uri)

entry = client.CreatePage('announcement', 'Party!!', html='My place, this weekend', parent=feed.entry[0])
print 'Posted!'

Mengupload file

Sama seperti di Google Sites, API mendukung upload lampiran ke halaman lemari file atau halaman induk. Lampiran harus diupload ke halaman induk. Oleh karena itu, Anda harus menetapkan link induk di ContentEntry yang Anda coba upload. Lihat Membuat subhalaman untuk informasi selengkapnya.

Metode UploadAttachment() library klien menyediakan antarmuka untuk mengupload lampiran.

Mengupload lampiran

Contoh ini mengupload file PDF ke filecabinet pertama yang ditemukan di feed konten pengguna. Lampiran dibuat dengan judul 'Buku Pedoman Karyawan Baru' dan deskripsi (opsional), 'Paket SDM'.

uri = '%s?kind=%s' % (client.MakeContentFeedUri(),'filecabinet')
feed = client.GetContentFeed(uri=uri)

attachment = client.UploadAttachment('/path/to/file.pdf', feed.entry[0], content_type='application/pdf',
                                     title='New Employee Handbook', description='HR Packet')
print 'Uploaded. View it at: %s' % attachment.GetAlternateLink().href

Jika upload berhasil, attachment akan berisi salinan lampiran yang dibuat di server.

Mengupload lampiran ke folder

Filecabinet di Google Sites mendukung folder. UploadAttachment() menyediakan argumen kata kunci tambahan, folder_name, yang dapat Anda gunakan untuk mengupload lampiran ke folder filecabinet. Cukup tentukan nama folder tersebut:

import gdata.data

ms = gdata.data.MediaSource(file_path='/path/to/file.pdf', content_type='application/pdf')
attachment = client.UploadAttachment(ms, feed.entry[0], title='New Employee Handbook',
                                     description='HR Packet', folder_name='My Folder')

Perhatikan bahwa contoh ini meneruskan objek gdata.data.MediaSource ke UploadAttachment(), bukan jalur file. Contoh ini juga tidak meneruskan jenis konten. Sebagai gantinya, jenis konten ditentukan pada objek MediaSource.

Lampiran web

Lampiran web adalah jenis lampiran khusus. Pada dasarnya, link tersebut adalah link ke file lain di web yang dapat Anda tambahkan ke listingan filecabinet. Fitur ini mirip dengan metode upload 'Tambahkan file menurut URL' di UI Google Sites.

Catatan: Lampiran web hanya dapat dibuat di bagian filecabinet. Judul tersebut tidak dapat diupload ke jenis halaman lain.

Contoh ini membuat lampiran web di bagian filecabinet pertama yang ditemukan di feed konten pengguna. Judul dan deskripsi (opsional)nya masing-masing ditetapkan ke 'GoogleLogo' dan 'warna yang bagus'.

uri = '%s?kind=%s' % (client.MakeContentFeedUri(),'filecabinet')
feed = client.GetContentFeed(uri=uri)

parent_entry = feed.entry[0]
image_url = 'http://www.google.com/images/logo.gif'
web_attachment = client.CreateWebAttachment(image_url, 'image/gif', 'GoogleLogo',
                                            parent_entry, description='nice colors')

print 'Created!'

Panggilan tersebut akan membuat link yang mengarah ke gambar di 'http://www.google.com/images/logo.gif' dalam filecabinet.

Kembali ke atas

Memperbarui Konten

Memperbarui metadata dan/atau konten html halaman

Metadata (title, pageName, dll.) dan konten halaman dari jenis entri apa pun dapat diedit dengan menggunakan metode Update() klien.

Berikut adalah contoh pembaruan listpage dengan perubahan berikut:

• Judul diubah menjadi 'Judul yang Diperbarui'
• Konten HTML halaman diperbarui menjadi 'Konten HTML yang Diperbarui'
• Judul kolom pertama daftar diubah menjadi "Pemilik"

uri = '%s?kind=%s' % (client.MakeContentFeedUri(),'listpage')
feed = client.GetContentFeed(uri=uri)

old_entry = feed.entry[0]

# Update the listpage's title, html content, and first column's name.
old_entry.title.text = 'Updated Title'
old_entry.content.html = 'Updated HTML Content'
old_entry.data.column[0].name = 'Owner'

# You can also change the page's webspace page name on an update.
# old_entry.page_name = 'new-page-path'

updated_entry = client.Update(old_entry)
print 'List page updated!'

Mengganti konten + metadata lampiran

Anda dapat mengganti konten file lampiran dengan membuat objek MediaSource baru dengan konten file baru dan memanggil metode Update() klien. Metadata lampiran (seperti judul dan deskripsi) juga dapat diperbarui, atau hanya metadata. Contoh ini menunjukkan pembaruan konten dan metadata file secara bersamaan:

import gdata.data

# Load the replacement content in a MediaSource. Also change the attachment's title and description.
ms = gdata.data.MediaSource(file_path='/path/to/replacementContent.doc', content_type='application/msword')
existing_attachment.title.text = 'Updated Document Title'
existing_attachment.summary.text = 'version 2.0'

updated_attachment = client.Update(existing_attachment, media_source=ms)
print "Attachment '%s' changed to '%s'" % (existing_attachment.title.text, updated_attachment.title.text)

Kembali ke atas

Menghapus Konten

Untuk menghapus halaman atau item dari Google Sites, pertama-tama ambil entri konten, lalu panggil metode Delete() klien.

client.Delete(content_entry)

Anda juga dapat meneruskan metode Delete() link edit entri konten dan/atau memaksa penghapusan:

# force=True sets the If-Match: * header instead of using the entry's ETag.
client.Delete(content_entry.GetEditLink().href, force=True)

Untuk mengetahui informasi selengkapnya tentang ETag, lihat panduan referensi Google Data API.

Kembali ke atas

Mendownload Lampiran

Setiap entri attachment berisi link src konten yang dapat digunakan untuk mendownload konten file. Klien Sites berisi metode bantuan untuk mengakses dan mendownload file dari link ini: DownloadAttachment(). Metode ini menerima gdata.sites.data.ContentEntry atau URI download untuk argumen pertamanya, dan jalur file untuk menyimpan lampiran sebagai yang kedua.

Contoh ini mengambil entri lampiran tertentu (dengan membuat kueri link self-nya) dan mendownload file ke jalur yang ditentukan:

uri = 'https://sites.google.com/feeds/content/site/siteName/1234567890'
attachment = client.GetEntry(uri, desired_class=gdata.sites.data.ContentEntry)

print "Downloading '%s', a %s file" % (attachment.title.text, attachment.content.type)
client.DownloadAttachment(attachment, '/path/to/save/test.pdf')

print 'Downloaded!'

Developer aplikasi dapat menentukan ekstensi file yang sesuai untuk jenis konten lampiran. Jenis konten dapat ditemukan di entry.content.type.

Dalam beberapa kasus, Anda mungkin tidak dapat mendownload file ke disk (misalnya, jika aplikasi Anda berjalan di Google App Engine). Untuk situasi ini, gunakan _GetFileContent() untuk mengambil konten file dan menyimpannya di memori.

Contoh ini mendownload lampiran ke memori.

try:
  file_contents = client._GetFileContent(attachment.content.src)
  # TODO: Do something with the file contents
except gdata.client.RequestError, e:
  raise e

Kembali ke atas

Feed ACL

Ringkasan Izin Berbagi (ACL)

Setiap entri ACL di feed ACL mewakili peran akses entitas tertentu, baik pengguna, grup pengguna, domain, atau akses default (yang merupakan situs publik). Entri hanya akan ditampilkan untuk entitas dengan akses eksplisit - satu entri akan ditampilkan untuk setiap alamat email di panel "Orang dengan Akses" di layar berbagi UI Google Sites. Dengan demikian, admin domain tidak akan ditampilkan, meskipun mereka memiliki akses implisit ke situs.

Peran

Elemen peran merepresentasikan tingkat akses yang dapat dimiliki suatu entity. Ada empat kemungkinan nilai elemen gAcl:role:

• pembaca — pelihat (setara dengan akses hanya baca).
• writer — kolaborator (setara dengan akses baca/tulis).
• owner — biasanya admin situs (setara dengan akses baca/tulis).

Cakupan

Elemen cakupan mewakili entitas yang memiliki tingkat akses ini. Ada empat kemungkinan jenis elemen gAcl:scope:

• user — nilai alamat email, misalnya "user@gmail.com".
• group — alamat email Google Grup, misalnya "group@domain.com".
• domain — nama domain G Suite, mis. "domain.com".
• default — Hanya ada satu kemungkinan cakupan jenis "default", yang tidak memiliki nilai (misalnya, <gAcl:scope type="default">). Cakupan khusus ini mengontrol akses yang dimiliki setiap pengguna secara default di situs publik.

Catatan: Domain tidak boleh memiliki nilai gAcl:role yang ditetapkan ke akses "owner", domain tersebut hanya dapat berupa pembaca atau penulis.

Mengambil feed ACL

Feed ACL dapat digunakan untuk mengontrol izin berbagi situs dan dapat diambil menggunakan metode GetAclFeed().

Contoh berikut mengambil feed ACL untuk situs yang saat ini ditetapkan pada objek SitesClient, dan mencetak entri izin:

print "Fetching acl permissions of site '%s'...\n" % client.site

feed = client.GetAclFeed()
for entry in feed.entry:
  print '%s (%s) - %s' % (entry.scope.value, entry.scope.type, entry.role.value)

Setelah kueri berhasil, feed akan menjadi objek gdata.sites.data.AclFeed yang berisi listingan gdata.sites.data.AclEntry.

Jika Anda menggunakan entri di SiteFeed, setiap SiteEntry berisi link ke feed ACL-nya. Misalnya, cuplikan ini mengambil situs pertama di feed Situs pengguna dan membuat kueri feed ACL-nya:

feed = client.GetSiteFeed()
site_entry = feed.entry[0]

print "Fetching acl permissions of site '%s'...\n" % site_entry.site_name.text
feed = client.GetAclFeed(uri=site_entry.FindAclLink())

Membagikan situs

Catatan: ACL berbagi tertentu hanya dapat dilakukan jika domain dikonfigurasi untuk memberikan izin tersebut (misalnya, berbagi di luar domain untuk domain G Suite diaktifkan, dll.).

Untuk membagikan Google Sites menggunakan API, buat gdata.sites.gdata.AclEntry dengan nilai gdata.acl.data.AclScope dan gdata.acl.data.AclRole yang diinginkan. Lihat bagian Ringkasan feed ACL untuk mengetahui kemungkinan nilai AclScope dan AclRoles.

Contoh ini memberikan izin baca di Situs kepada pengguna 'user@example.com':

import gdata.acl.data

scope = gdata.acl.data.AclScope(value='user@example.com', type='user')
role = gdata.acl.data.AclRole(value='reader')
acl = gdata.sites.gdata.AclEntry(scope=scope, role=role)

acl_entry = client.Post(acl, client.MakeAclFeedUri())
print "%s %s added as a %s" % (acl_entry.scope.type, acl_entry.scope.value, acl_entry.role.value)

Berbagi tingkat Grup dan Domain

Serupa dengan membagikan situs kepada satu pengguna, Anda dapat membagikan situs di grup Google atau domain G Suite. Nilai scope yang diperlukan tercantum di bawah.

Berbagi ke alamat email grup:

scope = gdata.acl.data.AclScope(value='group_name@example.com', type='group')

Berbagi ke seluruh domain:

scope = gdata.acl.data.AclScope(value='example.com', type='domain')

Berbagi di tingkat domain hanya didukung untuk domain G Suite, dan hanya untuk domain tempat situs dihosting. Misalnya, http://sites.google.com/a/domain1.com/siteA hanya dapat membagikan keseluruhan Situs dengan domain1.com, bukan domain2.com. Situs yang tidak dihosting di domain G Suite (misalnya, http://sites.google.com/site/siteB) tidak dapat mengundang domain.

Mengubah izin berbagi

Untuk izin berbagi yang ada di Situs, pertama-tama ambil AclEntry yang dimaksud, ubah izin sesuai keinginan, lalu panggil metode Update() klien untuk mengubah ACL di server.

Contoh ini mengubah acl_entry sebelumnya dari bagian Berbagi situs, dengan memperbarui 'user@example.com' menjadi penulis (kolaborator):

acl_entry.role.value = 'writer'
updated_acl = client.Update(acl_entry)

# To force the update, even if you do not have the latest changes to the entry:
# updated_acl = client.Update(acl_entrys, force=True)

Untuk informasi selengkapnya tentang ETag, lihat panduan referensi Google Data API.

Menghapus izin berbagi

Untuk menghapus izin berbagi, ambil AclEntry terlebih dahulu, lalu panggil metode Delete() klien.

client.Delete(acl_entry)

Anda juga dapat meneruskan metode Delete() link edit entri acl dan/atau memaksa penghapusan:

# force=True sets the If-Match: * header instead of using the entry's ETag.
client.Delete(acl_entry.GetEditLink().href, force=True)

Untuk informasi selengkapnya tentang ETag, lihat panduan referensi Google Data API.

Kembali ke atas

Topik Khusus

Mengambil feed atau entri lagi

Jika ingin mengambil feed atau entri yang telah diambil sebelumnya, Anda dapat meningkatkan efisiensi dengan memberi tahu server untuk mengirim daftar atau entri hanya jika telah berubah sejak terakhir kali Anda mengambilnya.

Untuk melakukan pengambilan bersyarat semacam ini, teruskan nilai ETag ke GetEntry(). Misalnya, jika Anda memiliki objek entry yang sudah ada:

import gdata.client

try:
  entry = client.GetEntry(entry.GetSelfLink().href, desired_class=gdata.sites.data.ContentEntry, etag=entry.etag)
except gdata.client.NotModified, error:
  print 'You have the latest copy of this entry'
  print error

Jika GetEntry() menampilkan pengecualian gdata.client.NotModified, ETag entri akan cocok dengan versi di server, yang berarti Anda memiliki salinan terbaru. Namun, jika klien/pengguna lain telah melakukan perubahan, entri baru akan ditampilkan di entry dan tidak ada pengecualian yang akan ditampilkan.

Untuk informasi selengkapnya tentang ETag, lihat panduan referensi Google Data API.

Kembali ke atas