Designrichtlinien für verbundene Apps

Richtlinien für das Design von verbundenen Apps in Google-Produkten wie der Gemini App und der Google Suche.

Übersicht

Mit einer MCP-verbundenen App können Nutzer ein Large Language Model (LLM) in einem beliebigen anwendbaren Google-Produkt verbinden, um die Daten Ihrer App zu lesen und zu schreiben. Da Ihre App den Kontext der Unterhaltung teilt, können Nutzer Aufgaben mühelos erledigen, ohne Tabs oder Apps wechseln zu müssen. Lesen Sie sich diese Richtlinien durch, um sicherzustellen, dass Ihre verbundene App für die Veröffentlichung in den entsprechenden Google-Produkten genehmigt wird.

Verbundene Apps erstellen

Wann sollten verbundene Apps verwendet werden?

Erstellen Sie verbundene Apps für die folgenden Szenarien:

  • Aufgaben mit einem klaren Anfang und Ende, z. B. eine Bestellung aufgeben, eine Buchung vornehmen oder einen Zeitplan festlegen.
  • Praktische Informationen, die Nutzer sofort anwenden können.
  • Natürliche konversationelle Workflows, z. B. zum Analysieren von Daten, Überprüfen von Dokumenten oder Koordinieren eines Projekts.
  • Hauptfunktionen, die die Möglichkeiten der KI erheblich erweitern.

Ihre Tools sollten Nutzern idealerweise dabei helfen, Aktionen mithilfe von KI auszuführen, z. B. eine Buchung vorzunehmen oder ein Dokument zu schreiben. Konzentrieren Sie sich auf komplexe Aktionen, bei denen das Foundation Model den Prozess vereinfachen kann.

Folgendes muss unbedingt vermieden werden

Vermeiden Sie beim Entwerfen von Connected Apps die folgenden Muster:

  • Drop-downs, Kontextmenüs und Pop-over-Bereiche: Diese Elemente werden durch Containergrenzen abgeschnitten oder kollidieren mit der Benutzeroberfläche der Hostoberfläche.
  • Verschachteltes Scrollen: Vermeiden Sie Scrollen innerhalb eines Scrollcontainers.
  • Mehrschichtige Ansichten: Verwenden Sie keine Breadcrumbs oder Drill-In-Oberflächen.
  • Langwierige Prozesse: Vermeide Abläufe, die den Umfang des Anzeigemodus überschreiten.
  • Eigenständige Web-Apps: Replizieren Sie keine vollständigen Web-Apps.
  • Versprechen nicht einhalten: Wenn Nutzer sehen, dass verbundene Apps geladen werden, erwarten sie ein gewisses Maß an Nutzen. Erstellen Sie keine App, die nur eine triviale Funktion hat, z. B. eine einzelne Schaltfläche.
  • Automatische Weiterleitungen: Externe Websites oder systemeigene Apps dürfen nicht automatisch gestartet werden, ohne dass der Nutzer explizit auf einen deutlich gekennzeichneten externen Link klickt.

Container und Layout

Host-Container umrahmen Ihre verbundene App zusammen mit Modellantworten. Diese Container bieten Partnerzuordnung, einheitliche Rahmen und responsive Größenanpassung für alle anwendbaren Google-Produkte.

Anatomie eines Containers

  1. Header: Hier werden das Symbol und der offizielle Name des Partners angezeigt.
  2. Inhalt: Wird als Inline-Karte oder horizontales Karussell angezeigt.
  3. Antworttext-Kopplung: Anzeigemodi werden immer zusammen mit dem Antworttext des Modells angezeigt. Entwerfen Sie das Design für dieses kombinierte Layout.
  4. UI-Stil: Übernimmt die Stile des Hostcontainers in allen anwendbaren Google-Produkten.

Responsives Verhalten

Verbundene Apps werden in verschiedenen Containerbreiten und Geräte-Darstellungsbereichen gerendert. Vermeiden Sie feste Abmessungen:

  • Horizontaler Umbruch: Verwende flexible Layouts, die sich ohne horizontales Abschneiden an kompakte Seitenleisten, mobile Bildschirme und breite Desktop-Feeds anpassen.
  • Inhalte vertikal anpassen: Inline-Container können so vergrößert werden, dass sie ihren Inhalt bis zu einer angenehmen Lesehöhe aufnehmen können. Fügen Sie Karten niemals feste Leerzeichen hinzu und schließen Sie Inhalte nicht in einer vertikalen Bildlaufleiste ein.
  • Geräteeingaben berücksichtigen: Unterstützen Sie native Touch-Gesten und sichere Bereiche auf Mobilgeräten sowie Hover-Zustände auf Computern.

Folgendes muss unbedingt vermieden werden

  • Doppeltes Padding vermeiden: Verbundene Apps enthalten ein standardmäßiges internes Padding, um die Systemstandards zu erfüllen. Entfernen Sie zusätzliches Padding aus internen Inhalten, um unbeabsichtigte Abstände zu vermeiden.
  • Unproportionale Eckenradien vermeiden: Die Proportionen interner Formen sollten zum Eckenradius des Host-Containers passen, um zu scharfe oder zu stark abgerundete Ecken zu vermeiden.
  • Fügen Sie keine eigenen Striche hinzu: Container enthalten standardmäßig systemdefinierte Rahmenstile. Fügen Sie keine zusätzlichen Rahmen oder Striche um interne Komponenten hinzu.

Anzeigemodi

Anzeigemodi definieren, wie Ihre Erweiterung visuelle UI-Elemente direkt neben den Antworten der entsprechenden Google-Produkte darstellt. Verwenden Sie einen der beiden primären Anzeigemodi: Inline-Karte oder Vollbild.

Inline-Karten

Inline-Karten sind einfache, zweckgebundene Komponenten, die direkt in den Antwortfluss eingebettet sind. Verwenden Sie Inline-Karten für schnelle Bestätigungen, die Prüfung strukturierter Daten oder einstufige Aktionen.

Wann Inline-Karten verwendet werden sollten

  • Statusaktualisierungen und Bestätigungen.
  • Einfache Datenanzeigen oder -auswahlen.
  • Kurze Zusammenfassungen mit optionaler Erweiterung.
  • Schnellaktionen, mit denen die Unterhaltung fortgesetzt wird.

Richtlinien für Inhaltsdichte und Kürzung

  • Titelkürzung: Begrenzen Sie Kartentitel auf 1–2 Zeilen mit Auslassungspunkten, damit Überschriften Aktionen nicht aus dem Sichtfeld verdrängen.
  • Limits für Text und Metadaten: Begrenzen Sie den unterstützenden Text auf 2–3 Zeilen und die Metadaten pro Element auf 2–3 leicht lesbare Attribute.
  • Prägnanter CTA-Text: Verwenden Sie Aktionslabels, die mit einem Verb beginnen (z. B. „Tisch reservieren“ oder „Bestellung bestätigen“), und beschränken Sie die Fußzeile der Karte auf maximal einen primären CTA und eine optionale sekundäre Aktion.

Karussell-Definition: Karussells sollten zwischen 3 und 8 Karten enthalten, um das Scrollen zu rechtfertigen, ohne dass es zu Ermüdung führt. Alle Karten müssen dieselbe Höhe und Breite haben. Kartenüberschriften sollten auf 1–2 Zeilen und Metadaten auf 2–3 Felder pro Karte beschränkt werden.

Interaktionen für Inline-Karten

Inline-Karten sollten sich auf schnelle, direkte Aktionen konzentrieren, die Nutzer in der Unterhaltung halten.

  • Inline-Aktionen: Nutzer können Aktionen direkt auf der Karte ausführen, z. B. Text bearbeiten, Elemente hinzufügen oder Aufgaben abhaken.
  • Statusaktualisierungen: Komplexe Nutzeraktionen werden direkt im Thread und nicht in der Entität angezeigt. Wenn ein Nutzer beispielsweise einen Aufenthalt bucht, generieren Sie eine aktualisierte Karte mit dem Label „Reserviert“ in der Unterhaltung.
  • Hover-Mechanik: Navigationssymbole bleiben standardmäßig ausgeblendet und werden angezeigt, wenn der Mauszeiger auf den Container bewegt wird.
  • Scrims für Überlauf: Im Startzustand wird der Scrim am rechten Rand angezeigt, in der Mitte werden beide Ränder angezeigt und am Ende wird der linke Rand angezeigt.
  • Touch-Gesten: Es wird die native horizontale Wischgeste mit Abstand zwischen den Karussellkarten verwendet.
  • Karten-Peeking: Der Startstatus verwendet einen linken Abstand, der mittlere Status keinen und der Endstatus einen rechten Abstand.

Was Sie bei Inline-Karten vermeiden sollten

  • Verschachteltes Scrollen vermeiden: Fügen Sie niemals eine interne vertikale Scrollleiste ein.
  • Keine mehrstufigen Aufschlüsselungen: Verwenden Sie keine Navigationspfade, Ansichten mit mehreren Tabs und mehrstufigen Aufschlüsselungen in einer Inline-Karte. Komplexe Abläufe in den Vollbildmodus verschieben.
  • Sichtbare Steuerelemente über Menüs vermeiden: Verwenden Sie keine Drop-down-Menüs, Pop-over und Kontextmenüs, da diese zu Container-Clipping und Z-Index-Konflikten führen.
  • Doppelte Eingaben vermeiden: Platziere keine weitere Eingabe in der Karte, da die entsprechenden Google-Produkte bereits die Eingabe haben.
  • Internes vertikales Scrollen vermeiden: Platzieren Sie keine scrollbaren Container in Karten. Dies führt zu Scroll-Trapping und beeinträchtigt die mobile Navigation.
  • Pop-over vermeiden: Da sie Inhalte verdecken und die Benutzeroberfläche unübersichtlich machen, sollten Sie keine Kurzinfos oder Pop-over-Overlays verwenden, um wichtige Details anzuzeigen.
  • Drop-down-Menüs vermeiden: Verstecken Sie Aktionen nicht in Drop-down-Menüs. Stellen Sie primäre Aktionen als explizite Schaltflächen dar.
  • Scroll-Überlauf in Karussells nicht ausblenden: Die angrenzende Karte sollte sichtbar sein, damit Nutzer wissen, dass weitere Inhalte verfügbar sind.
  • Benutzerdefinierte Fehlerkomponenten vermeiden: Verwenden Sie keine benutzerdefinierten Fehlerstatus. Die Host-UI stellt eine Standardfehlerkomponente bereit, die in der gesamten Anwendung einheitlich ist.
  • Modale Fenster vermeiden: MCP-Apps unterstützen keine modalen Fenster. Wenn Sie mehr Platz benötigen, bieten Sie stattdessen eine Option zum Wechseln in den Vollbildmodus an.

Vollbild

Verwenden Sie den Vollbildmodus als immersiven Canvas für umfangreiche, mehrstufige Aufgaben oder datenintensive Workflows, die nicht in einer Inline-Karte untergebracht werden können.

Wann sollte der Vollbildmodus verwendet werden?

  • Durchsuchen von dichten Inhalten wie Immobilienangeboten, Menüs oder interaktiven Karten.
  • Komplexe Workflows, z. B. das Bearbeiten von Canvas-Elementen oder Diagrammen, die mehr Platz als eine Inline-Karte benötigen.
  • Daten und Analysen, z. B. das Ansehen von umfangreichen Dashboards, Datenvisualisierungen und detaillierten Analysetools, die besondere Aufmerksamkeit erfordern.

Layout und Interaktionen für den Vollbildmodus

  1. Kopfzeile: Es wird eine vom System bereitgestellte Kopfzeile mit App-Attribution und Aktionen angezeigt.
  2. Sichtbarer Bereich: Achten Sie darauf, dass unter der Kopfzeile genügend Platz ist, damit sich Inhalte nicht überschneiden.
  3. Schließen und öffnen: Es wird eine Schaltfläche zum Öffnen im Vollbildmodus und eine Schaltfläche zum Schließen im Header der Vollbildansicht angezeigt.

Was Sie im Vollbildmodus vermeiden sollten

  • Vermeide es, deine systemeigene App zu replizieren: Verwende den Vollbildmodus, um die Interaktion bei fokussierten, mehrstufigen Aufgaben zu vertiefen.
  • Doppelte Eingaben vermeiden: Da die entsprechenden Google-Produkte bereits die Eingabe enthalten, sollten Partner keine weitere Eingabe in der Ansicht platzieren.
  • Schwebende Bereiche vermeiden: Verwenden Sie keine schwebenden Modals oder schwebenden ziehbaren Prüf-Symbolleisten, da sie die Benutzeroberfläche unübersichtlich machen und mit Overlays der Hostoberfläche kollidieren.
  • Sicherheitsbereiche nicht überlappen: Halte interaktive Elemente von der Symbolleiste der Hostoberfläche und von Systemanzeigen wie Statusleisten und der Startleiste fern.

Richtlinien für Interaktionen

Wie Nutzer Inhalte in einer verbundenen App bearbeiten, wie Aktionen mit der Host-Unterhaltung synchronisiert werden und wann komplexe Workflows an eine externe App oder Website übergeben werden sollten.

Arbeitsteilung zwischen App-UI und Unterhaltung

Entwerfen Sie Ihre verbundene App und die konversationellen Prompts als sich ergänzende Ebenen:

  • Verbundene App-UI für direkte Manipulation verwenden: Verwenden Sie die UI für räumliches Browsen, z. B. zum Schwenken einer Karte, zum Vergleichen strukturierter Optionen, für Formularsteuerelemente mit mehreren Feldern und für visuelle Auswahlen, bei denen das Eingeben von Text-Prompts mühsam oder mehrdeutig wäre.
  • Host-Unterhaltung für offene Absichten verwenden: Verwenden Sie die Unterhaltung für weiterführende Fragen in natürlicher Sprache, mehrstufige Synthese und allgemeine explorative Abfragen.

Progressive Offenlegung

  • Progressive Offenlegung: Beginne mit dem kompaktesten Anzeigemodus, der die Anforderungen des Nutzers erfüllt (Inline-Karte oder Karussell). Blende sekundäre Details bei Bedarf ein („Mehr anzeigen“) und wechsle nur dann zum Vollbildmodus, wenn eine detaillierte Erkundung erforderlich ist.
  • Sichtbare Steuerelemente statt versteckter Menüs: Zeigen Sie primäre Aktionen als explizite Schaltflächen oder Schalter an, anstatt sie in Symbolleisten, die nur beim Bewegen des Mauszeigers angezeigt werden, in Kontextmenüs, die per Rechtsklick aufgerufen werden, oder in Gesten, die per langem Drücken aufgerufen werden, zu verstecken, da diese auf Mobilgeräten nicht funktionieren.

Externe Übergaben und Verlinkungen

Einige Funktionen gehen über den Umfang eines eingebetteten iFrames hinaus oder erfordern native Betriebssystem- und Hardwarefunktionen. Wann Sie auf Ihre App oder Website verlinken sollten:

  • Betriebssystemeigene oder hardwareabhängige Funktionen (z. B. Live-Navigation, Kamera- oder Sensoraufnahmen oder kontinuierliche Audio- und Standortverfolgung im Hintergrund).
  • Regulierte oder sicherheitsrelevante Abläufe (z. B. endgültige Zahlung oder Identitätsüberprüfung)
  • Komplexe Arbeitsbereiche, die über den Vollbildmodus hinausgehen (z. B. voll ausgestattete Authoring-Suites oder komplexe Unternehmens-Dashboards).

Übergabe entwerfen

  • Deutliche Kennzeichnung externer Links: Kombiniert Buttons für die externe Übergabe immer mit einem expliziten Startindikator (z. B. dem Symbol open_in_new) und einem zielspezifischen Label (z. B. „In Google Maps öffnen“).
  • Deeplink mit beibehaltenem Kontext: Übergeben Sie alle in der Unterhaltung festgelegten Parameter über die API für externe Links des Hosts (openLink) an die Deeplink-URL, damit Nutzer ihre Auswahl nach dem Wechseln der App nicht noch einmal eingeben müssen.

Folgendes muss unbedingt vermieden werden

  • Automatische Weiterleitungen vermeiden: Nutzer sollten niemals automatisch von der Hostoberfläche weggeleitet werden. Das Verlassen der Hostoberfläche muss immer einen expliziten Klick des Nutzers erfordern.
  • Vermeide „Teaser“- oder reine Link-Karten: Erstelle keine verbundene App, deren einziger Zweck darin besteht, ein statisches Banner oder einen Button zu rendern, über den Nutzer auf deine Website weitergeleitet werden.
  • Unangekündigte Kontextwechsel vermeiden: Gestalte einen externen Link niemals so, dass er wie eine Aktion innerhalb der Karte aussieht, ohne darauf hinzuweisen, dass er eine externe App oder einen neuen Browsertab öffnet.

Visuelle Richtlinien

In den entsprechenden Google-Produkten werden leichte, neutrale UI-Elemente und ein weicherer Kontrast bevorzugt, um die kognitive Belastung zu reduzieren.

Visuelle Prinzipien

Wendet grundlegende Designprinzipien an, um die visuelle Dichte und Ästhetik in verbundenen Apps zu steuern:

  • Hellere und minimalistische Benutzeroberfläche: Reduzieren Sie Striche und Containerelemente, um eine klare visuelle Dichte zu erhalten.
  • Neutrale Farbbalance: Priorisieren Sie neutrale Grautöne und reservieren Sie Akzentfarben für primäre CTAs.
  • Höhe: Verwende weiche Oberflächenfüllungen und beschränke Schlagschatten ausschließlich auf den Vollbildmodus und die Steuerelemente für die Karussellnavigation.
  • Stilvererbung: Farben, Typografie und Eckenradien werden so angewendet, dass sich Apps in allen anwendbaren Google-Produkten nativ anfühlen.

Farbe

In den entsprechenden Google-Produkten werden Farben in zwei funktionale Gruppen unterteilt: Systemfarben für das strukturelle Layout und Akzentfarben für primäre Markenelemente. Die Verwendung dieser semantischen Rollen sorgt für eine klare visuelle Hierarchie und eine automatische Anpassung des Designs in allen Produkten.

Systemfarbrollen

Strukturfarben einheitlichen UI-Rollen in allen verbundenen Apps zuordnen:

  • Hintergrundflächen: Verwenden Sie vom Host bereitgestellte neutrale Oberflächenfarben für Kartencontainer und verschachtelte Gruppierungen. Vermeiden Sie es, Containerhintergründe mit benutzerdefinierten Volltonfüllungen, Farbverläufen oder Mustern zu überschreiben.
  • Text- und Inhaltshierarchie: Verwenden Sie Primärfarben für Titel und Schlüsselwerte, gedämpfte Sekundärtöne für den Haupttext und unterstützende Labels sowie semantische Statusfarben (positiv, Warnung, kritisch) für operative Metadaten.
  • Rahmen und Trennlinien: Verwenden Sie dezente Systemfarben für strukturelle Rahmen und Trennlinien, um Inhalte zu trennen, ohne das visuelle Gewicht zu erhöhen.
  • Primäre Akzentfarbe: Verwende die Systemakzentfarbe oder die Markenfarbe deines Partners für primäre Call-to-Action-Buttons.

Anwendungsbereiche für Partnermarken

Leitfaden für die Platzierung der Markenfarbe von Partnern in verbundenen Apps:

  • Empfehlung: Verwenden Sie Markenfarben gezielt für primäre CTA-Buttons, Logos und wichtige Highlights.
  • Nicht empfohlen: Vermeiden Sie es, Markenfarben auf Kartenhintergründe, Textkörper, Titel, strukturelle Rahmen oder sekundäre interaktive Steuerelemente anzuwenden.

Design und heller/dunkler Modus

Verbundene Apps müssen sowohl im hellen als auch im dunklen Design sowie mit dynamischen Oberflächenpaletten einheitlich wirken:

  • Semantische Tokens statt statischer Hex-Werte verwenden: Binden Sie Oberflächen, Text und Rahmen an die semantischen Farbtokens der Hostoberfläche, damit sich die Benutzeroberfläche automatisch an den hellen und dunklen Modus anpasst.
  • Markenakzente für beide Designs anpassen: Achten Sie darauf, dass die Akzentfarbe Ihrer Marke in beiden Designs einen barrierefreien Kontrast aufweist. Stellen Sie im dunklen Modus eine etwas hellere oder weniger gesättigte Variante bereit, wenn Ihre Standardmarkenfarbe auf dunklen Oberflächen zu dunkel oder zu kräftig wirkt.
  • Verwende Medien und Logos, die für das Design geeignet sind: Exportiere Symbole, Logos und Illustrationen mit transparentem Hintergrund, damit im dunklen Modus keine auffälligen weißen Begrenzungsrahmen angezeigt werden.

Symbole

In Connected Apps werden klare, umrissene Symbole verwendet, um die visuelle Harmonie und Lesbarkeit in allen anwendbaren Google-Produkten zu gewährleisten.

Symbolstil und -größe

Richtlinien für Symbolgeometrie, Farbe und Größe in verbundenen Apps:

  • Umrissene, abgerundete Geometrie: Verwende monochrome umrissene Symbole mit einheitlicher Strichstärke und abgerundeten Enden (z. B. Google Material Symbols Outlined) oder ein harmonisiertes Partner-Symbolset, das dem visuellen Gewicht der Hostoberfläche entspricht.
  • Neutrale Tönung: Töne funktionale UI-Symbole mit primären oder sekundären Inhaltsfarben anstatt mit Markenfarben, damit die Symbole die Lesehierarchie unterstützen, ohne mit primären CTAs zu konkurrieren.
  • Größenbeschränkungen: Symbole sollten zwischen 16 Pixel (für kompakte Inline-Metadaten) und 32 Pixel (für auffällige Karten- oder Funktionsüberschriften) groß sein, damit sie auf allen Darstellungsbereichen gut lesbar sind und die Proportionen stimmen.

Bedienungshilfen

Bei den entsprechenden Google-Produkten wird die Einhaltung der Barrierefreiheit gemäß den Standards WCAG 2.1 AA und Material Design 3 erzwungen.

Wichtige Säulen der Barrierefreiheit im Internet

  • Farbkontrast: Erzwingen Sie ein WCAG AA-Kontrastverhältnis von mindestens 4,5:1 für Text auf Oberflächenhintergründen in hellen und dunklen Designs.
  • Minimale Textgröße: Erzwingt eine Schriftgröße von 13 Punkt.
  • Berührungszielbereiche: Erzwingen Sie für interaktive Zielbereiche für Steuerelemente eine Mindestgröße von 48 × 48 Pixeln auf Mobilgeräten und 24 × 24 Pixeln auf Computern.
  • Tastaturfokus: Behalten Sie einen sichtbaren Fokusindikatorring und eine logische Durchlaufreihenfolge für interaktive Kartenkomponenten bei.
  • Dynamischer Alt-Text für Medien: Geben Sie für alle von Partnern bereitgestellten Bilder, Miniaturansichten, Kartenmarkierungen und Datenvisualisierungen einen beschreibenden Alt-Text an.
  • Live-Statusansagen (aria-live): Verwenden Sie aria-live="polite"-Regionen, um dynamische Statusänderungen in der Karte anzukündigen, z. B. das Maximieren von „Mehr anzeigen“-Zeilen, das Filtern von Elementen oder das Abschließen einer Inline-Aktion.
  • Reduzierte Bewegung (prefers-reduced-motion): Berücksichtigen Sie die Medienabfrage prefers-reduced-motion des Nutzers, indem Sie Schimmereffekte und Karussell-Folienübergänge durch statische oder sofortige Statusänderungen ersetzen.
  • Inhaltsüberlauf und Kürzung: Begrenzen Sie lange Textblöcke auf 3–5 Zeilen mit einer barrierefreien Aktion „Mehr lesen“, um Layoutfehler zu vermeiden und die Lesbarkeit zu erhalten.