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 della guida per gli sviluppatori specifiche per i linguaggi di programmazione.
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Google Sites.
È un documento di riferimento; si presuppone che tu abbia compreso 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 dati di Google Sites fornisce i seguenti tipi di feed:
Feed Attività
Il feed Attività è un feed che contiene 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 è un "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 è un "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 a questo feed possono richiedere o meno l'autenticazione, a seconda delle impostazioni (pubblicate) del sito.
Tipi di richieste supportati: GET, POST, PUT e DELETE
Oltre ai parametri di query standard dell'API di dati, l'API Sites consente i seguenti parametri facoltativi
l'invio di una richiesta GET usando il feed di contenuti:
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
ancestor |
Richiedi solo le voci con il predecessore specificato. | stringa | Fornisci l'ID della voce predecessore desiderata. Ad esempio: 0123456789. Restituisce tutte le voci con il predecessore specificato come padre, altro padre di un padre e così via. |
include-deleted |
Specifica se includere le voci eliminate. | booleano | I valori possibili sono true o false. Il valore predefinito è false. |
include-draft |
Specifica se includere le voci bozza. | booleano | I valori possibili sono true o false. Il valore predefinito è false. Devi essere il proprietario o l'autore
della bozza per visualizzarla. |
kind |
Specifica i tipi di voci di contenuto da restituire. che seguono il tipo di pagina di Google Sites. | elenco di stringhe separate da virgole | I valori possibili sono announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Consente di richiedere solo le voci con l'elemento padre specificato. | stringa | Fornisci l'ID della voce principale. Ad esempio: 0123456789. |
path |
Richiede contenuti in una determinata gerarchia di pagine | stringa | Il percorso di una pagina secondaria all'interno di un sito per cui recuperare i contenuti. Ad esempio: path=/path/to/page. |
Feed delle revisioni
Il feed delle revisioni è un feed che contiene 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 è un "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 del sito può essere utilizzato per elencare i siti di Google Sites di proprietà di un utente o per i quali dispone delle autorizzazioni di visualizzazione. Può anche essere utilizzati per creare nuovi siti, copiare un sito o modificare il nome di un sito esistente.
L'URI del feed per l'elenco di Sites è:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName è un "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 viene inviata una richiesta GET per elencare i siti:
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
include-all-sites |
Elenca tutti i siti che possono essere almeno visualizzati dall'utente nel dominio G Suite. | booleano | Questo parametro si applica solo quando vengono elencati i siti di 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. | booleano | 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 l'elenco di Sites è:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName è un "sito" o un dominio G Suite.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET, POST, PUT e DELETE
Informazioni sui 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 complete)
Consulta ciascun feed riportato sopra per visualizzare un elenco dei parametri specifici di quel feed.