Guida di riferimento

Questo documento fornisce una documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) per l'API Google Sites Data.

Questo documento non contiene informazioni sulle librerie client del linguaggio di programmazione. Per informazioni di riferimento sulle librerie client, consulta i link delle sezioni specifiche per linguaggio di programmazione della guida per gli sviluppatori.

Pubblico

Questo documento è destinato ai programmatori che vogliono scrivere applicazioni client in grado di interagire con Google Sites.

Si tratta di un documento di riferimento che presuppone che tu comprenda i concetti presentati nella guida al protocollo e le idee generali alla base del protocollo delle API Google Data.

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 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 è "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 di contenuti

Il feed dei contenuti è un feed contenente i contenuti del sito attuali e modificabili.

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 potrebbero richiedere o meno l'autenticazione, a seconda delle impostazioni (pubblicate) del sito.

Tipi di richieste supportati: GET, POST, PUT, DELETE

Oltre ai parametri di query standard dell'API Data, l'API Sites Data consente i seguenti parametri facoltativi che emettono la 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 principale desiderata. Ad esempio: 0123456789. Restituisce tutte le voci che hanno l'antenato specificato come genitore, genitore di un genitore 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 visualizzare la bozza, devi esserne il proprietario o l'autore.
kind Specifica 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 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 da cui recuperare i contenuti. Ad esempio: path=/path/to/page.

Feed delle revisioni

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 dei siti 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 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 del sito supporta i seguenti parametri (facoltativi) quando viene emessa una richiesta GET per i siti di schede:

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 è applicabile solo quando vengono elencati 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 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

Riferimento ai parametri di query di Google Sites

Parametri di query supportati dal protocollo Google Data API:

  • max-results
  • published-max (solo feed di contenuti)
  • published-min (solo feed di contenuti)
  • start-index
  • updated-max
  • updated-min
  • q (query di testo completo)

Consulta ciascun feed sopra per un elenco dei parametri specifici per quel feed.

Torna all'inizio