Questo documento fornisce la documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) dell'API Google Sites Data.
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 per linguaggio di programmazione della guida per gli sviluppatori.
Pubblico
Questo documento è rivolto ai programmatori che vogliono scrivere applicazioni client in grado di interagire con Google Sites.
È un documento di riferimento; presuppone che tu abbia compreso i concetti presentati nella guida sul protocollo e le idee generali alla base del protocollo delle API di dati di Google.
Tipi di feed di Google Sites
L'API Google Sites Data fornisce i seguenti tipi di feed:
Feed Attività
Il feed Attività è un feed contenente 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 visualizzato nell'URL della 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 contenente i contenuti attuali 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 è "site" o un dominio G Suite.
siteName è il nome del sito visualizzato nell'URL della 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 Data, l'API Sites Data consente i seguenti parametri facoltativi per l'emissione di una richiesta GET
utilizzando il feed di contenuti:
Parametro | Descrizione | Tipo | Note |
---|---|---|---|
ancestor |
Richiede solo le voci che hanno l'antenato specificato. | stringa | Fornisci l'ID della voce dell'antenato desiderata. Ad esempio: 0123456789 . Restituisce tutte le voci che hanno l'antenato specificato come elemento principale, l'elemento principale di un elemento principale 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 in bozza. | booleano | I valori possibili sono true o false . Il valore predefinito è false . Per visualizzarla, devi essere il proprietario o l'autore della bozza. |
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 e
template . |
parent |
Richiede solo le voci che hanno l'elemento principale specificato. | stringa | Fornisci l'ID della voce principale. Ad esempio: 0123456789 . |
path |
Richiede contenuti in base a 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 di revisione
Il feed delle revisioni è 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 è "site" o un dominio G Suite.
siteName è il nome del sito visualizzato nell'URL della 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ò essere utilizzata anche per creare nuovi siti, copiare un sito o modificare il nome di un sito esistente.
L'URI del feed per la scheda Siti è:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName è "site" o un dominio G Suite.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET
, POST
, PUT
Il feed dei siti supporta i seguenti parametri (facoltativi) quando viene emessa una richiesta GET
per l'inserimento di 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 del 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 la scheda Siti è:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName è "site" o un dominio G Suite.
Tutte le richieste a questo feed devono essere autenticate.
Tipi di richieste supportati: GET
, POST
, PUT
, DELETE
Informazioni sui parametri di query di Google Sites
Parametri di query supportati dal protocollo dell'API di dati di Google:
max-results
published-max
(solo feed di contenuti)published-min
(solo feed di contenuti)start-index
updated-max
updated-min
q
(query di testo complete)
Consulta ogni feed sopra per un elenco dei parametri specifici del feed.