Questo documento fornisce la 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 del linguaggio di programmazione. Per informazioni di riferimento sulla libreria client, consulta i link nelle sezioni specifiche del linguaggio di programmazione della guida dello sviluppatore.
Audience
Questo documento è destinato ai programmatori che intendono scrivere applicazioni client in grado di interagire con Google Sites.
Si tratta di un documento di riferimento; presuppone che tu abbia compreso i concetti presentati nella guida al protocollo 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 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 è il seguente:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName è un"dominio"o un dominio G Suite.
siteName è il nome del sito visualizzato nell'URL pagina di destinazione del sito: http://sites.google.com/a/domainName/siteName/.
Tutte le richieste in 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 è il seguente:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName è un"dominio"o un dominio G Suite.
siteName è il nome del sito 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, in base alle impostazioni del Sito (pubblicate).
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 una richiesta GET utilizzando il feed dei contenuti:
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
ancestor |
Richiede solo le voci che hanno l'antenato specificato. | string | Fornisci l'ID della voce predecessore desiderata. Ad esempio: 0123456789. Restituisce tutte le voci che hanno l'antenato specificato come padre, un elemento padre di un elemento principale 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 bozze delle voci. | boolean | I valori possibili sono true o false. Il valore predefinito è false. Per visualizzarlo, devi essere il proprietario o l'autore della bozza. |
kind |
Specifica i tipi di voci di contenuti da restituire. che seguono il tipo di pagina in Google Sites. | elenco di stringhe separato da virgole | I valori possibili sono: announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template. |
parent |
Richiede solo le voci che hanno l'elemento principale specificato. | string | Fornisci l'ID della voce principale. Ad esempio: 0123456789. |
path |
Richiede contenuti in una determinata gerarchia di pagine | string | Il percorso di una pagina secondaria all'interno di un sito di cui recuperare contenuti. Ad esempio: path=/path/to/page. |
Feed di revisione
Il feed Revisione è 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 è il seguente:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName è un"dominio"o un dominio G Suite.
siteName è il nome del sito visualizzato nell'URL pagina di destinazione del sito: http://sites.google.com/a/domainName/siteName.
Tutte le richieste in questo feed devono essere autenticate.
Tipi di richieste supportati: GET
Feed del sito
Il feed del sito può essere utilizzato per elencare i siti Google di proprietà di un utente o per cui si 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 Siti è:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName è un"dominio"o un dominio G Suite.
Tutte le richieste in questo feed devono essere autenticate.
Tipi di richieste supportati: GET, POST e PUT
Per l'invio di una richiesta GET per i siti elencati, il feed dei siti supporta i seguenti parametri (facoltativi):
| Parametro | Descrizione | Tipo | Note |
|---|---|---|---|
include-all-sites |
Elenca tutti i siti che possono essere visualizzati dall'utente almeno nel dominio G Suite. | boolean | Questo parametro è applicabile solo quando elenchi 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 nella voce di un 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 Siti è:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName è un"dominio"o un dominio G Suite.
Tutte le richieste in questo feed devono essere autenticate.
Tipi di richieste supportati: GET, POST, PUT e DELETE
Riferimento per i parametri di ricerca di Google Sites
Parametri di ricerca 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 ogni feed in alto per un elenco di parametri specifico per quel feed.