In diesem Dokument werden die unterschiedlichen Optionen zum Veröffentlichen Ihres Gadgets beschrieben.
Ihre Gadgets können Sie in die folgenden Umgebungen einfügen:
Für eine bestimmte Umgebung ist nicht jedes Gadget geeignet. In der folgenden Tabelle finden Sie die Anforderungen für die jeweiligen Umgebungen.
| Zielumgebung | Anforderungen |
|---|---|
| iGoogle-Seite | Für das Hinzufügen von Gadgets zur iGoogle-Seite gibt es keine besonderen Anforderungen oder Einschränkungen. |
| Andere Google-Websites, wie beispielsweise Google Page Creator und Google Desktop | Gadgets dürfen nicht aus dem Content-Typ html-inline bestehen. Bei einigen Websites wird das Bearbeitungsfeld "userprefs" (Nutzereinstellungen) nicht angezeigt. In diesem Fall kann der Nutzer in dem Feld keine Einstellungen zur Gadget-Funktion vornehmen. |
| Google-Startseiten-Content | Entwickler, die Gadgets im Startseiten-Content veröffentlichen, sollten sich an die unter Veröffentlichen im Startseiten-Content aufgelisteten Richtlinien halten. |
| Syndication | Gadgets dürfen nicht aus dem Content-Typ html-inline bestehen. Die Funktion für die dynamische Höhe und "Setprefs" (Einstellungen festlegen) können unter Syndication nicht genutzt werden. Das Bearbeitungsfeld "userprefs" (Nutzereinstellungen) wird nicht angezeigt, da die Gadget-Funktionalität zum Festlegen von Einstellungen nicht verwendet werden soll. |
Vor einer Veröffentlichung sollten Sie Ihr Gadget unter Berücksichtigung der Anforderungen und Einschränkungen der jeweiligen Zielumgebung testen.
Folgende Tests sollten für alle Gadgets durchgeführt werden:
Falls Sie _IG_FetchContent() verwenden, probieren Sie aus, was passiert, wenn die Datenquelle ausgefallen ist oder einen Fehler zurückgibt. Sie können dieses Verhalten simulieren, indem Sie vorübergehend eine andere URL angeben.
Die Größeneinstellung für ein Gadget hängen weitgehend von der Veröffentlichungsumgebung ab. Bei einer Ausführung unter Syndication sind bestimmte Höhen- und Breitenmaße nur Vorschläge für Website-Eigentümer, die jedoch nach Belieben geändert werden können. Bei der iGoogle-Seite spielen die Einstelllungen zur Breite keine Rolle, denn die Breite des Gadgets wird automatisch auf 32 % festgelegt.
Die dynamische Höhe funktioniert nur bei der iGoogle-Seite. Sie sollten deshalb unter Syndication verschiedene Größen ausprobieren. Ihr Gadget können Sie auf der Syndication-Erstellungsseite unter Verwendung einer URL und des folgenden Formats testen:
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Bei dem Entwickeln und Testen Ihrer Gadgets sollten Sie außergewöhnliche Breiten von 200 Pixel bis zu 600 Pixel berücksichtigen. Bei einigen Gadgets sollte die Breite sogar noch größer sein. Eine Faustregel: Entwerfen Sie das Gadget so, dass es bei zusätzlichem Platz korrekt angezeigt wird. Karten sollten beispielsweise ihren Bereich ausfüllen, Bild-Gadgets sollten im Rahmen zentriert ausgerichtet sein, bei Gadgets mit Anzeigentext sollte der Text nach oben ausgerichtet sein (z. B. der Link "Weitere Details", der in der Regel im unteren Bereich platziert ist, sollte gleich neben dem Inhalt zu sehen sein und nicht im unteren Bereich des Gadget-Fensters untergebracht werden).
Ein Vorteil der Google Gadgets besteht darin, dass Sie sie nach der Entwicklung zuerst auf der iGoogle-Seite testen und anschließend in anderen Websites wie beispielsweise Google Desktop und Google Page Creator nutzen können. Sie können aber auch Syndication zur Bereitstellung der Gadgets auf Blogger- oder auf Ihren eigenen HTML-Seiten nutzen. Weitere Details hierzu finden Sie unter Veröffentlichen über Syndication.
Die meisten Gadgets können Sie Google Desktop und Google Page Creator hinzufügen. Allerdings sind Gadgets nicht vollständig mit Google Desktop- und Google Page Creator-Gadgets austauschbar. Es gelten folgende Einschränkungen:
So fügen Sie ein Gadget zu Google Desktop über die Google Desktop-Seitenleiste hinzu:
So fügen Sie ein Gadget zu Google Page Creator hinzu:
Nach dem Entwurf, dem Implementieren und Testen Ihres Gadgets können Sie es nun an Google zum Veröffentlichen im Startseiten-Content senden. Die Gadget-Übergabe an Google entspricht dem Verfahren zur Auflistung Ihres Gadgets im Syndication-Verzeichnis. Weitere Informationen hierzu finden Sie unter Syndizierte Gadgets. In diesem Abschnitt werden die Vorbereitungsschritte für die Gadget-Veröffentlichung beschrieben.
In der Referenz werden sämtliche <ModulePrefs>-Attribute aufgelistet. Diese Moduleinstellungen können Sie nutzen, um Ihrem Gadget die erforderlichen Metainformationen hinzuzufügen. In Ihrer Gadget-Spezifikation sollten folgende Informationen enthalten sein:
Falls Sie auf der Autoren-Seite aufgelistet werden möchten, können Sie diese zusätzlichen Attribute angeben:
Weitere Informationen finden Sie hier und ein Beispiel hier.
Prüfen Sie auch, ob Sie Ihr Gadget zum Schutz vor möglichen Sicherheitsrisiken sachgerecht codiert haben.
Nicht alle Gadgets können in allen Umgebungen ausgeführt werden. So kann ein Gadget beispielsweise einen bestimmten Browser oder spezifische Software erfordern. In den <Moduleinstellungen> können Sie mit dem Tag <MayRequire> angeben, welche Voraussetzungen für Ihr Gadget erfüllt sein müssen. Weitere Informationen hierzu finden Sie unter Festlegen der Voraussetzungen für die Kompatibilität.
In den <ModulePrefs> können Sie mit den <Locale>-Tags die von Ihrem Gadget unterstützten Gebietsschemata festlegen. Weitere Informationen hierzu finden Sie unter Angabe von Gebietsschemata.
Wenn Sie für Ihr Gadget werben möchten, können Sie auf Ihrer Webseite die Schaltfläche "Add to Google" (Zu Google hinzufügen) anbringen.
Sie können dazu hier klicken. In den häufig gestellten Fragen erfahren Sie, wie Sie Ihr Gadget im Startseiten-Content finden können und welche Faktoren dessen Platzierung bestimmen. Anleitungen zur Vorbereitung eines Gadgets für Syndication – d. h. einer Veröffentlichung auf Webseiten von Drittanbietern – finden Sie unter Syndizierte Gadgets.
Falls Sie mehrere Gadget-Versionen an verschiedene URLs gesendet haben und nur eine Version als die offizielle angeben möchten, können Sie dazu die Webseite Submit an Alias Request (Alias-Anfrage senden) nutzen.
Mit Syndication können Sie Google-Gadgets auf den Webseiten von Drittanbietern bereitstellen. Ein aktives Gadget ist beispielsweise auf dieser Webseite veröffentlicht:
In diesem Beispiel wurde dem HTML-Code dieser Webseite einfach nur die Anweisung <script src ="http://gadget-URL …" </script> hinzugefügt. Im Anschluss erfahren Sie mehr dazu.
Sie können dieses Gadget in der Erstellungsseite öffnen, wenn Sie hier klicken.
Zur Vorbereitung eines Gadgets für Syndication müssen Sie keine besonderen Schritte ausführen. Damit ein Gadget jedoch für Syndication genutzt werden kann, muss es folgende Richtlinien erfüllen:
Bei einem syndizierten Gadget können die Nutzereinstellungen derzeit nur vor der Bereitstellung des Gadgets auf der Webseite bearbeitet werden. Sobald das Gadget veröffentlicht wurde, kann jedoch auf diese Einstellungen nicht mehr zugegriffen werden. Angenommen, Sie verfügen über ein Gadget, das Informationen entsprechend der Städtenamen anzeigt, die von den Nutzern eingegeben werden. Sie müssten den Nutzern deshalb ermöglichen, diese Informationen über die Gadget-Oberfläche und nicht über die Nutzereinstellungen einzugeben.
Sie sehen anschließend ein Gadget-Beispiel. Das Gadget zeigt ein Nutzerprofil mit einem Foto und Angaben zum Alter und den Hobbys. Es ermöglicht auch das Festlegen der Hintergrundfarbe:
<?xml version="1.0" encoding="UTF-8" ?>
<Module>
<ModulePrefs title="Card for __UP_myname__" height="400" />
<UserPref name="myname" display_name="Name" default_value="Touki" />
<UserPref name="myphoto" display_name="Photo" default_value="http://doc.examples.googlepages.com/touki.jpg" />
<UserPref name="myage" display_name="Age" default_value="4" />
<UserPref name="myhobby" display_name="Hobbies" default_value="agility, swimming" />
<UserPref name="mycolor" display_name="Color" default_value="Pink" datatype="enum" >
<EnumValue value="Pink" />
<EnumValue value="Red" />
<EnumValue value="Aqua" />
<EnumValue value="Lime" />
<EnumValue value="Yellow" />
<EnumValue value="Orange" />
<EnumValue value="White" />
</UserPref>
<Content type="html">
<![CDATA[
<div id="content_div" style="font-size:12pt; font-family:Arial, Helvetica; text-align:center; padding:5px;">
<script type="text/javascript">
// Get userprefs
var prefs = new _IG_Prefs(__MODULE_ID__);
showCard();
// Display the card showing the user profile
function showCard (){
// Apply userpref-specified background color to the div
var element = document.getElementById('content_div');
element.style.backgroundColor = prefs.getString("mycolor");
// Build HTML string used to display content
var html = "";
html += '<img src="' + prefs.getString("myphoto") + '">';
html += "<br><b>Age: </b>" + prefs.getString("myage");
html += "<br><b>Hobbies: </b>" + prefs.getString("myhobby");
// render HTML string in the div
_gel("content_div").innerHTML = html;
}
</script>
]]>
</Content>
</Module>
So testen Sie ein Gadget unter Syndication:
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Ihre Gadget-Probe können Sie dann auf der Erstellungsseite unter dieser URL ansehen:
http://gmodules.com/ig/creator?synd=open&url=http://doc.examples.googlepages.com/baseball-card.xml
Wenn Sie zum Testen das Zwischenspeichern deaktivieren möchten, fügen Sie Ihrer URL den Parameter &nocache=1 hinzu. Den Parameter &nocache=1 zur Bereitstellung aktiver Gadgets sollten Sie jedoch nicht verwenden, da dies die Leistung beinträchtigen kann.
http://gmodules.com/ig/creator?synd=open&nocache=1&url=http://doc.examples.googlepages.com/baseball-card.xml
Auf der Erstellungsseite können Website-Eigentümer
Wenn Sie die oben angezeigte URL zum Aufrufen der Erstellungsseite für das Beispiel-Gadget nutzen, sehen Sie Folgendes:
Beachten Sie Folgendes:
<script src="http://gmodules.com/ig/ifr?url=http://doc.examples.googlepages.com/baseball-card.xml&up_myname=Touki
&up_myphoto=&up_myage=&up_myhobby=&up_mycolor=Pink&synd=open&w=320&h=400&title=Card+for+__UP_myname__
&border=%23ffffff%7C3px%2C1px+solid+%23999999&output=js"></script>
Diese URL beinhaltet die folgenden Parameter:
Sie können Ihr Gadget unter Syndication testen, indem Sie im Google Page Creator den Modus "edit html" aufrufen und die auf der Erstellungsseite generierte Zeichenfolge in den HTML-Code der Google Page Creator-Webseite einfügen. Die veröffentlichte Seite enthält dann das aktive Gadget mit den auf der Erstellungsseite angegebenen Einstellungen.
Alternativ dazu können Sie Ihr Gadget auch in Blogger testen. Zur Anzeige eines syndizierten Gadgets in Blogger müssen Sie es der Vorlage und nicht dem HTML-Code einer bestimmten Seite hinzufügen. Da im Blogger die Höhe möglicherweise gekürzt wird, erzielen Sie mit kleineren Gadgets bessere Ergebnisse.
Sofern Ihr Gadget über <Locale>-Elemente gemäß den in Internationalisierung enthaltenen Beschreibungen verfügt, befindet sich auf der Erstellungsseite ein Menü für Sprache, in dem Sie alle von Ihrem Gadget unterstützten Sprachen finden. Bei der Auswahl einer Sprache wird diese der Syndication-URL des Gadget mit dem Parameter &lang hinzugefügt. Der Parameter &country ist ebenfalls enthalten. Die Standardeinstellung hierzu lautet ALL:
<script src="http://gmodules.com/ig/ifr?url=http://examples.com/hello-i18n.xml …&lang=zh-CN&country=ALL …</script>
Zum Ändern der Einstellungen für &country bearbeiten Sie die URL manuell. Falls beim Hinzufügen einer Sprache oder eines Landes das Gadget nicht über ein entsprechendes <Locale>-Element verfügt, hat eine Änderung der URL keine Auswirkung.
Eine Liste der von Google Gadgets unterstützten Sprachen und Länder finden Sie unter Unterstützte Sprachen und Länder.
In der Erstellungsseite können Sie den Rahmen auswählen, der auf der Ziel-Webseite das Gadget umrandet. Als mögliche Arten stehen bildbasierte und CSS-basierte Rahmen zur Verfügung.
Auf einen bildbasierten Rahmen verweist eine URL mit diesem Format http://hostname/some/path/ (muss mit einem Schrägstrich enden). Für diese Rahmenart wird ein Satz von 9 Bildern verwendet:
Die Abmessungen für "Breite x Höhe" lauten wie folgt:
Vorgaben finden Sie in http://www.google.com/ig/images/ …, wie beispielsweise http://www.google.com/ig/images/br.gif.
Einige der auf der Erstellungsseite bereitgestellten Rahmen basieren auf CSS-Definitionen. Die Rahmen bestehen aus einem mit CSS-Parameter beschriebenen Zeilensatz. Das Format lautet wie folgt:
<bgcolor>|<n>px, <n>px <linetype> <color>|<n>px, <n>px <linetype> <color>| …
Die Farben haben hier entweder einfache Namen wie "black" oder verfügen über RGB-Werte wie #000000. Die Linientypen sind Standard-CSS-Linientypen, so wie es hier beschrieben wird.
Bei diesem Rahmen beispielsweise, werden zwei schwarze Linien auf einen weißen Hintergrund gedruckt (verwendet URL-Escaping):
&border=%23ffffff%7C1px%2C1px+solid+black%7C1px%2C1px+solid+black%7C0px%2C1px+black
Das Senden Ihres Gadgets an das Syndication-Verzeichnis entspricht einer herkömmlichen Gadget-Übergabe an den Startseiten-Content, so wie es hier beschrieben wird. Merken Sie sich in diesem Zusammenhang einfach, dass ein Gadget für Syndication kein Inline-Gadget sein kann und keinen Status speichert.
©2009 Google – Datenschutzbestimmungen – Allgemeine Geschäftsbedingungen – Über Google
Aktualisiert am:
