Questo documento fornisce una documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) per l'API di dati di Google Sites.
Questo documento non contiene informazioni sulle librerie client dei linguaggi di programmazione. Per informazioni di riferimento sulle librerie client, consulta i link nelle sezioni specifiche dei linguaggi di programmazione della Guida per gli sviluppatori.
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Google Sites.
Si tratta di un documento di riferimento e presuppone che tu comprenda i concetti presentati nella guida ai protocolli e le idee generali alla base del protocollo delle API di dati di Google.
Tipi di feed di Google Sites
L'API di dati di Google Sites fornisce i seguenti tipi di feed:
Feed Attività
Il feed Attività è un feed contenente le descrizioni di tutte le attività all'interno di un sito.
L'URI GET di questo feed per un sito all'interno di un determinato dominio è:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName è "sito" o è un dominio G Suite.
siteName è il nome del sito così come viene visualizzato nell'URL pagina di destinazione del sito: http://sites.google.com/a/domainName/siteName/.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET
Feed di contenuti
Il feed di contenuti è un feed che include i contenuti correnti e modificabili del sito.
L'URI GET di questo feed per un sito all'interno di un determinato dominio è:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName è "sito" o è un dominio G Suite.
siteName è il nome del sito così come viene visualizzato nell'URL pagina di destinazione del sito: http://sites.google.com/a/domainName/siteName.
Le richieste inviate a questo feed possono richiedere o meno l'autenticazione, a seconda delle impostazioni del Sito (pubblicato).
Tipi di richieste supportati: GET, POST, PUT e DELETE
Oltre ai parametri di query dell'API di dati standard, l'API di dati di Sites consente i seguenti parametri facoltativi che inviano la richiesta GET utilizzando il feed di contenuti:
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
ancestor |
Richiede solo le voci che hanno il predecessore specificato. | stringa | Fornisci l'ID della voce predecessore desiderata. Ad esempio: 0123456789. Restituisce tutte le voci il cui predecessore specificato è l'elemento padre, il predecessore e così via. |
include-deleted |
Specifica se includere le voci eliminate. | boolean | I valori possibili sono true o false. Il valore predefinito è false. |
include-draft |
Specifica se includere le voci in bozza. | boolean | I valori possibili sono true o false. Il valore predefinito è false. Devi essere il proprietario o l'autore della bozza per visualizzarla. |
kind |
Specifica il tipo o i tipi di voci di contenuti da restituire. Questi seguono il tipo di pagina all'interno di Google Sites. | elenco di stringhe separate da virgole | I valori possibili sono announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Richiede solo le voci che contengono l'elemento padre specificato. | stringa | Fornisci l'ID della voce padre. Ad esempio: 0123456789. |
path |
Richiede contenuti in una determinata gerarchia di pagine | stringa | Il percorso di una pagina secondaria di un sito per cui recuperare i contenuti. Ad esempio: path=/path/to/page. |
Feed delle revisioni
Il feed Revisione è un feed contenente le revisioni storiche dei contenuti del sito.
L'URI GET di questo feed per un sito all'interno di un determinato dominio è:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName è "sito" o è un dominio G Suite.
siteName è il nome del sito così come viene visualizzato nell'URL pagina di destinazione del sito: http://sites.google.com/a/domainName/siteName.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET
Feed sito
Il feed sito può essere utilizzato per elencare i siti Google di proprietà di un utente o per i quali dispone delle autorizzazioni di visualizzazione. Può essere utilizzato anche per creare nuovi siti, copiare un sito o modificare il nome di un sito esistente.
L'URI del feed per la scheda Sites è:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName è "sito" o è un dominio G Suite.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET, POST, PUT
Il feed del sito supporta i seguenti parametri (facoltativi) quando si invia una richiesta GET per l'elenco dei siti:
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
include-all-sites |
Elenca tutti i siti che possono essere almeno visualizzati dall'utente nel dominio G Suite. | boolean | Questo parametro si applica solo quando si elencano i siti per un dominio G Suite. I valori possibili sono true
o false. Il valore predefinito è false. |
with-mappings |
Include le mappature degli indirizzi web in una voce di sito. | boolean | I valori possibili sono true o false. Il valore predefinito è false. |
Feed ACL
Il feed ACL può essere utilizzato per elencare e/o modificare le autorizzazioni di condivisione (ACL) di un sito Google.
L'URI del feed per la scheda Sites è:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName è "sito" o è un dominio G Suite.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET, POST, PUT e DELETE
Riferimento per i parametri di query di Google Sites
Parametri di query supportati dal protocollo dell'API di dati di Google:
max-resultspublished-max(solo feed di contenuti)published-min(solo feed di contenuti)start-indexupdated-maxupdated-minq(query di testo completo)
Consulta ciascun feed riportato sopra per un elenco dei parametri specifici di quel feed.