Bu belgede, Google Sites Data API'nin ham protokolü (XML ve HTTP) için ayrıntılı referans dokümanları sağlanmaktadı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şime geçebilecek istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Bu referans dokümanı, protokol kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün temel fikirlerini anladığınızı varsaymaktadır.
Google Sites özet akışı 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 bir 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 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 gerektirmeyebilir.
Desteklenen istek türleri: GET, POST, PUT, DELETE
Sites Data API, standart Data API sorgu parametrelerine ek olarak Content feed'ini kullanarak GET isteği gönderirken 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 | İstediğiniz ata girişinin kimliğini girin. Örneğin: 0123456789. Belirtilen atayı üst öğe, üst öğenin üst öğesini vb. içeren 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'dur. Varsayılan değer false'tir. |
include-draft |
Taslak girişlerin eklenip eklenmeyeceğini belirtir. | boolean | Olası değerler true veya false'dur. Varsayılan değer false'tir. Görüntülemek için taslağın sahibi veya yazarı
olmanız gerekir. |
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 | Muhtemel 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çerikleri talep eder. | dize | Site içinde içerik getirilecek 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 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 feed'i, kullanıcının sahibi olduğu veya görüntüleme izinlerine sahip olduğu Google Sites sitelerini listelemek için kullanılabilir. Ayrıca yeni siteler oluşturmak, site kopyalamak veya mevcut bir sitenin adını değiştirmek için de kullanılabilir.
Siteler girişinin 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, 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 site listelenirken geçerlidir. Olası değerler true veya false'dur. false varsayılandır. |
with-mappings |
Bir site girişindeki web adresi eşlemelerini içerir. | boolean | Olası değerler true veya false'dur. Varsayılan değer false'tir. |
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 Veri API'si protokolünde 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.