Cerca nei documenti di Google Gadget
Sfortunatamente, la seguente documentazione non è aggiornata. Se preferisci, utilizza la più recente versione in inglese. Siamo spiacenti per qualsiasi inconveniente.

Guida introduttiva

Benvenuto nella API di Google Gadget! Questa guida per gli sviluppatori è rivolta agli utenti che desiderano utilizzare l'API di Google Gadget per creare gadget. I gadget sono così facili da creare che rappresentano un buon inizio per chi desidera compiere i primi passi nella programmazione web.

Sommario

  1. "Hello, World"
  2. Che cosa contiene un gadget?
  3. Appunti: inizia adesso
  4. Quali sono i passaggi successivi dopo questa sezione

"Hello, World"

Il modo più semplice per imparare a utilizzare questa API è vedere un esempio. Questo gadget di esempio visualizza semplicemente il messaggio "Hello, world!": 

<?xml version="1.0" encoding="UTF-8" ?> 
<Module>
  <ModulePrefs title="hello world example" /> 
  <Content type="html">
     <![CDATA[ 
       Hello, world!
     ]]>
  </Content> 
</Module>

Per visualizzare le specifiche del gadget vere e proprie, fai clic qui.

Per eseguire questo esempio:

  1. Apri la pagina http://www.google.com/ig.
  2. Per aggiungere un gadget, devi disporre di una pagina iGoogle. Se non disponi già di una pagina iGoogle, devi prima crearne una facendo clic su Come iniziare. Quindi, accedi con il tuo account Google esistente oppure crea un nuovo account.
  3. Una volta creata la tua pagina iGoogle, puoi aggiungervi gadget facendo clic su Aggiungi elementi nell'angolo in alto a destra. Si aprirà la directory dei contenuti. Puoi utilizzare la directory dei contenuti per cercare i gadget e aggiungerli alla tua home page.
  4. Fai clic su Aggiungi da URL (accanto al pulsante "Cerca nei contenuti per la home page").
  5. Nella casella di testo Aggiungi da URL digita "hello.xml", quindi fai clic su Aggiungi.
  6. Fai clic su Torna alla home page, dove potrai constatare che il gadget è stato aggiunto.

Il testo "hello.xml" è l'abbreviazione dell'URL http://www.google.com/ig/modules/hello.xml. Puoi inserire l'URL di qualsiasi specifica di gadget nella casella di testo Aggiungi da URL includendo i gadget creati da te o dai tuoi amici (a condizione che siano pubblicati su un server web pubblico).

Nell'esempio "Hello, world!" tieni presente quanto segue:

Che cosa contiene un gadget?

L'API di Google Gadget è costituita da alcuni semplici blocchi costruttivi: XML, HTML e JavaScript. Per iniziare, devi avere una conoscenza di base del linguaggio HTML. Ti illustreremo tutto ciò che devi sapere sull'XML per poter scrivere gadget. In seguito, quando comincerai a creare gadget più complessi, vorrai probabilmente imparare alcune nozioni fondamentali del linguaggio JavaScript, se non lo conosci già.

XML è un linguaggio di marcatura per uso generico. Descrive dati strutturati in un modo tale da risultare leggibile e scrivibile sia dai computer che dalle persone.

L'XML è il linguaggio utilizzato per scrivere le specifiche dei gadget. Un gadget è un semplice file XML, situato in una posizione su Internet nella quale può essere trovato da Google. Il file XML che indica un gadget contiene istruzioni su come elaborare e visualizzare il gadget. Il file XML può contenere tutti i dati e il codice del gadget oppure può contenere riferimenti (URL) che rimandano a una pagina nella quale si trova il resto degli elementi.

HTML è un linguaggio di marcatura utilizzato per formattare pagine su Internet. Il contenuto statico di un gadget è scritto normalmente in HTML. L'HTML ha un aspetto simile all'XML, ma si utilizza per formattare documenti web anziché per descrivere dati strutturati.

JavaScript è un linguaggio di scripting che puoi utilizzare per conferire un comportamento dinamico ai tuoi gadget.

Nota: i gadget erano precedentemente chiamati "moduli". Ciò spiega il motivo per cui il termine "Module" appare ancora all'interno dell'API.

Appunti: inizia adesso

Il modo più semplice per iniziare a creare gadget è quello di utilizzare gli Appunti. Gli Appunti ti permettono di modificare le specifiche del gadget e di fare clic su Preview (Anteprima) per visualizzare in tempo reale il risultato delle tue modifiche senza dover uscire dalla guida per gli sviluppatori. Esistono tre diversi modi per utilizzare gli Appunti:

Per impostazione predefinita, gli Appunti contengono le specifiche del gadget "Hello World." Puoi modificare il titolo e il testo del messaggio "Hello World", ad esempio: 

<?xml version="1.0" encoding="UTF-8" ?> 
<Module>
  <ModulePrefs title="My first gadget" /> 
  <Content type="html"> 
  <![CDATA[ 
    <B>Welcome to my first gadget!</B> 
  ]]> 
  </Content> 
</Module>

Per visualizzare il risultato delle modifiche negli Appunti, fai clic su Preview (Anteprima). Quando ricarichi la pagina, le specifiche originali del gadget "Hello World" appariranno nuovamente negli Appunti. Sotto gli Appunti sono presenti link ad altri gadget di esempio che potrai visualizzare o modificare.

Modificami! Fai clic su "Preview" (Anteprima) per salvare le modifiche.


Quali sono i passaggi successivi dopo questa sezione

Utilizza questa "Guida introduttiva" per un'introduzione ai gadget e per effettuare alcuni test con gli Appunti. Quando sei pronto per passare alla fase successiva, vai alla sezione Creazione di gadget personali. Da qui puoi passare alla sezione Nozioni fondamentali per lo sviluppo oppure tornare alla home page della documentazione per una panoramica delle sezioni e degli argomenti.

 

Torna all'inizio

Aggiornato il