Bu belgede, Google Sites Data API'nin ham protokolü (XML ve HTTP) için ayrıntılı referans belgeleri sağlanmaktadır.
Bu belgede, programlama dili istemci kitaplıkları hakkında bilgi verilmemektedir. İstemci kitaplığı referans bilgileri için geliştirici kılavuzunun programlama diline özgü bölümlerindeki bağlantılara bakın.
Kitle
Bu belge, Google Siteler ile etkileşim kurabilen istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Bu belge, referans belgesi niteliğindedir. Protokol kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün arkasındaki genel fikirleri anladığınız varsayılır.
Google Sites feed türleri
Google Sites Data API, aşağıdaki feed türlerini sağlar:
Etkinlik feed'i
Etkinlik feed'i, bir sitedeki tüm etkinliklerin açıklamalarını içeren bir feed'dir.
Bu feed'in belirli bir alan adındaki site için GET URI'si:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName "site" veya bir G Suite alanıdır.
siteName, sitenin açılış sayfası URL'sinde görünen site adıdır: http://sites.google.com/a/domainName/siteName/.
Bu feed'e yapılan tüm isteklerin kimliği doğrulanmalıdır.
Desteklenen istek türleri: GET
İçerik feed'i
İçerik feed'i, mevcut ve düzenlenebilir site içeriğini içeren bir feed'dir.
Bu feed'in belirli bir alan adındaki site için GET URI'si:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName "site" veya bir G Suite alanıdır.
siteName, sitenin açılış sayfası URL'sinde görünen site adıdır: http://sites.google.com/a/domainName/siteName.
Bu feed'e yapılan istekler, Sitenin (yayınlanan) ayarlarına bağlı olarak kimlik doğrulama gerektirebilir veya gerektirmeyebilir.
Desteklenen istek türleri: GET, POST, PUT, DELETE
Sites Data API, standart Data API sorgu parametrelerine ek olarak aşağıdaki isteğe bağlı parametrelerin kullanılmasına olanak tanır.GET
| Parametre | Açıklama | Tür | Notlar |
|---|---|---|---|
ancestor |
Yalnızca belirtilen üst öğeye sahip girişleri ister. | dize | İstenen üst öğe girişinin kimliğini sağlayın. Örneğin: 0123456789. Belirtilen üst öğeye sahip tüm girişleri (üst öğe, üst öğenin üst öğesi vb.) döndürür. |
include-deleted |
Silinen girişlerin dahil edilip edilmeyeceğini belirtir. | boolean | Olası değerler true veya false'dir. Varsayılan değer false'dır. |
include-draft |
Taslak girişlerin dahil edilip edilmeyeceğini belirtir. | boolean | Olası değerler true veya false'dir. Varsayılan değer false'dır. Taslağı görüntülemek için sahibi veya yazarı olmanız gerekir. |
kind |
Döndürülecek içerik girişlerinin türlerini belirtir. Bunlar, Google Sites'taki sayfa türüne göre değişir. | virgülle ayrılmış dize listesi | Olası değerler: announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Yalnızca belirtilen üst öğeye sahip girişleri ister. | dize | Üst girişin kimliğini sağlayın. Örneğin: 0123456789. |
path |
Belirli bir sayfa hiyerarşisi altındaki içerikleri ister. | dize | İçeriğin getirileceği bir Site'deki alt sayfanın yolu. Örneğin: path=/path/to/page. |
Düzeltme feed'i
Düzeltme feed'i, site içeriğinin geçmiş düzeltmelerini içeren bir feed'dir.
Bu feed'in belirli bir alan adındaki site için GET URI'si:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName "site" veya bir G Suite alanıdır.
siteName, sitenin açılış sayfası URL'sinde görünen site adıdır: http://sites.google.com/a/domainName/siteName.
Bu feed'e yapılan tüm isteklerin kimliği doğrulanmalıdır.
Desteklenen istek türleri: GET
Site feed'i
Site feed'i, kullanıcının sahibi olduğu veya görüntüleme izni olan Google Sites'ları listelemek için kullanılabilir. Yeni siteler oluşturmak, site kopyalamak veya mevcut bir sitenin adını değiştirmek için de kullanılabilir.
Siteler listelemesi için feed URI'si:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName "site" veya bir G Suite alanıdır.
Bu feed'e yapılan tüm isteklerin kimliği doğrulanmalıdır.
Desteklenen istek türleri: GET, POST, PUT
Site feed'i, listeleme siteleri için GET isteği gönderirken aşağıdaki (isteğe bağlı) parametreleri destekler:
| Parametre | Açıklama | Tür | Notlar |
|---|---|---|---|
include-all-sites |
G Suite alanında kullanıcı tarafından en azından görüntülenebilen tüm siteleri listeleyin. | boolean | Bu parametre yalnızca bir G Suite alanıyla ilgili siteler listelenirken geçerlidir. Olası değerler true veya false'dir. Varsayılan değer false'dır. |
with-mappings |
Bir site girişindeki web adresi eşlemelerini içerir. | boolean | Olası değerler true veya false'dir. Varsayılan değer false'dır. |
EKL feed'i
EKL feed'i, bir Google Sites'ın paylaşım izinlerini (EKL'ler) listelemek ve/veya değiştirmek için kullanılabilir.
Siteler listelemesi için feed URI'si:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName "site" veya bir G Suite alanıdır.
Bu feed'e yapılan tüm isteklerin kimliği doğrulanmalıdır.
Desteklenen istek türleri: GET, POST, PUT, DELETE
Google Sites sorgu parametreleri referansı
Google Data API protokolünden desteklenen sorgu parametreleri:
max-resultspublished-max(yalnızca içerik feed'i)published-min(yalnızca içerik feed'i)start-indexupdated-maxupdated-minq(tam metin sorguları)
İlgili feed'e özgü parametrelerin listesi için yukarıdaki her feed'e bakın.