Bu belgede, Google Sites Data API için ham protokol (XML ve HTTP) hakkında ayrıntılı referans dokümanlar sunulmaktadır.
Bu belge, programlama dili istemci kitaplıkları hakkında bilgi içermez. İstemci kitaplığı referans bilgileri için geliştirici kılavuzunun programlama diline özel bölümlerindeki bağlantılara bakın.
Kitle
Bu doküman, Google Sites ile etkileşimde bulunabilecek istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Referans belgedir; 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 özet akışı türleri
Google Sites Data API'si aşağıdaki yayın 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 alandaki bir siteye ait 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, düzenlenebilir site içeriğini içeren bir feed'dir.
Bu feed'in belirli bir alandaki bir siteye ait 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 gerekmeyebilir.
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ı parametrelere de izin verir.
İçerik feed'i kullanılarak GET isteği verme:
| 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. Örnek: 0123456789. Belirtilen üst öğeye üst öğe, üst öğe vb. olarak sahip tüm girişleri döndürür. |
include-deleted |
Silinen girişlerin dahil edilip edilmeyeceğini belirtir. | boolean | Olası değerler: true veya false. false varsayılandır. |
include-draft |
Taslak girişlerin eklenip eklenmeyeceğini belirtir. | boolean | Olası değerler: true veya false. false varsayılandır. Sahip veya yazar olmanız gerekir
taslağa dokunun. |
kind |
Döndürülecek içerik girişlerinin türlerini belirtir. Bunlar Google Sites içindeki sayfa türüne uygundur. | 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. Örnek: 0123456789. |
path |
Belirli bir sayfa hiyerarşisi altındaki içeriği istiyor | dize | Site içinde içerik getirilecek alt sayfanın yolu. Örnek: 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 alandaki bir siteye ait 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 özet akışı, bir kullanıcının sahip olduğu veya görüntüleme izinlerine sahip olduğu Google Sites sitelerini listelemek için kullanılabilir. Ayrıca Yeni site oluşturmak, bir siteyi kopyalamak veya mevcut bir sitenin adını değiştirmek için kullanılır.
Google Sites listesinin yayın 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, siteleri listelemek için GET isteği verirken aşağıdaki (isteğe bağlı) parametreleri destekler:
| Parametre | Açıklama | Tür | Notlar |
|---|---|---|---|
include-all-sites |
G Suite alanında en azından kullanıcı tarafından görüntülenebilecek tüm siteleri listeleyin. | boolean | Bu parametre yalnızca bir G Suite alanı için siteler listelenirken geçerlidir. Olası değerler: true
veya false. false varsayılandır. |
with-mappings |
Bir site girişindeki web adresi eşlemelerini içerir. | boolean | Olası değerler: true veya false. false varsayılandır. |
EKL feed'i
EKL feed'i, bir Google Sites sitesinin paylaşım izinlerini (EKL'ler) listelemek ve/veya değiştirmek için kullanılabilir.
Google Sites listesinin yayın 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ı)
Söz konusu feed'e özgü parametrelerin listesi için yukarıdaki her feed'e bakın.