Bu belgede, Google Sites Data API'sı için ham protokol (XML ve HTTP) hakkında ayrıntılı referans dokümanlar yer almaktadır.
Bu belge, programlama dili istemci kitaplıklarıyla ilgili bilgi içermiyor. İ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 Sites ile etkileşimde bulunabilecek istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Bu bir referans belgedir. Protokol kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün temelindeki genel fikirleri anladığınız varsayılır.
Google Sites feed türleri
Google Sites Data API'sı 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 özet akışının belirli bir alandaki bir site için GET
URI'sı:
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ündüğü şekliyle 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 barındıran bir feed'dir.
Bu özet akışının belirli bir alandaki bir site için GET
URI'sı:
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ündüğü şekliyle site adıdır: http://sites.google.com/a/domainName/siteName.
Bu feed'e gönderilen istekler, sitenin (yayınlanan) ayarlarına bağlı olarak kimlik doğrulama gerektirebilir veya gerektirmeyebilir.
Desteklenen istek türleri: GET
, POST
, PUT
, DELETE
Standart Data API sorgu parametrelerine ek olarak Sites Data API, İçerik feed'ini kullanarak GET
isteği yayınlayan aşağıdaki isteğe bağlı parametrelere izin verir:
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 öğesi üst öğe, üst öğe vb. olarak belirtilen tüm girişleri döndürür. |
include-deleted |
Silinen girişlerin eklenip eklenmeyeceğini belirtir. | boolean | Olası değerler true veya false 'dir. false varsayılandır. |
include-draft |
Taslak girişlerinin dahil edilip edilmeyeceğini belirtir. | boolean | Olası değerler true veya false 'dir. false varsayılandır. Taslağı görmek için sahibi veya yazarı olmanız gerekir. |
kind |
Döndürülecek içerik girişi türlerini belirtir. Bunlar, Google Sites'taki sayfa türünü izler. | dizelerin virgülle ayrılmış listesi | Olası değerler şunlardır: 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ında içerik ister | dize | Bir site içindeki içerik getirilecek alt sayfaya giden yol. Örneğin: path=/path/to/page . |
Düzeltme feed'i
Düzeltme yayını, site içeriğinin geçmişteki revizyonlarını içeren bir yayındır.
Bu özet akışının belirli bir alandaki bir site için GET
URI'sı:
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ündüğü şekliyle 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 özet akışı
Site feed'i, bir kullanıcının sahip olduğu veya görüntüleme iznine sahip olduğu Google Sites sitelerini listelemek için kullanılabilir. Ayrıca, yeni siteler oluşturmak, bir siteyi kopyalamak veya mevcut bir sitenin adını değiştirmek için de kullanılabilir.
Sites girişinin 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, listeleme siteleri için bir 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ülenebilecek tüm siteleri listeleyin. | boolean | Bu parametre yalnızca bir G Suite alanı için siteleri listelerken kullanılabilir. Olası değerler true veya false 'dir. false varsayılandır. |
with-mappings |
Site girişindeki web adresi eşlemelerini içerir. | boolean | Olası değerler true veya false 'dir. 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.
Sites girişinin 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 Veri API'sı protokolünden desteklenen sorgu parametreleri:
max-results
published-max
(yalnızca içerik feed'i)published-min
(yalnızca içerik feed'i)start-index
updated-max
updated-min
q
(tam metin sorguları)
Bu feed'e özgü parametrelerin listesi için yukarıdaki her feed'e bakın.