Guida di riferimento

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.

Torna all'inizio