Il 22 novembre 2016 è stata lanciata una versione ricostruita di Sites. L'API Sites non può accedere ai siti creati con questa versione o modificarli, ma può comunque accedere alla versione classica di Sites.

Guida di riferimento

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-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 in alto per un elenco di parametri specifico per quel feed.

Torna all'inizio