Gemini uygulaması ve Arama gibi Google ürünlerinde Bağlı Uygulamalar tasarlama yönergeleri.
Genel Bakış
MCP'ye bağlı bir uygulama, kullanıcıların geçerli herhangi bir Google ürününde büyük dil modelini (LLM) bağlayarak uygulamanızın verilerini okuyup yazmasına olanak tanır. Uygulamanız, sohbet bağlamını paylaştığı için kullanıcılar sekme veya uygulama değiştirmeden görevleri zahmetsizce tamamlayabilir. Bağlı uygulamanızın geçerli Google ürünlerinde yayınlanmak üzere onaylandığından emin olmak için bu yönergeleri inceleyin.
Bağlı uygulamalar oluşturma
Bağlı Uygulamalar ne zaman kullanılır?
Aşağıdaki senaryolar için Bağlı Uygulamalar oluşturun:
- Sipariş verme, rezervasyon yapma veya programı kesinleştirme gibi net bir başlangıcı ve sonu olan görevler.
- Kullanıcıların hemen uygulayabileceği, işlem yapılabilir bilgiler.
- Veri analiz etme, doküman inceleme veya proje koordine etme gibi doğal, sohbet tabanlı iş akışları.
- Yapay zekanın yapabileceklerini anlamlı bir şekilde genişleten temel işlevler.
Araçlarınız, kullanıcıların yapay zekanın yardımıyla rezervasyon yapma veya belge yazma gibi işlemleri tamamlamasına yardımcı olmalıdır. Temel modelin süreci basitleştirebileceği karmaşık işlemlere odaklanın.
Kaçınılması gerekenler
Bağlı uygulamaları tasarlarken aşağıdaki kalıplardan kaçının:
- Açılır listeler, bağlam menüleri ve popover paneller: Bu öğeler, kapsayıcı sınırları tarafından kırpılır veya ana yüzey kullanıcı arayüzüyle çakışır.
- İç içe kaydırma: Kaydırılabilir bir kapsayıcı içinde kaydırma yapmaktan kaçının.
- Çok katmanlı görünümler: Gezinme yolu veya ayrıntıya gitme arayüzleri kullanmayın.
- Uzun süreçler: Görüntüleme modunun kapsamını aşan akışlardan kaçının.
- Bağımsız web uygulamaları: Tam web uygulamalarını kopyalamayın.
- Vaadi yerine getirememe: Kullanıcılar, bağlı uygulamaların yüklendiğini gördüklerinde temel düzeyde bir fayda bekler. Yalnızca tek bir düğme gibi önemsiz bir işlevi yerine getirmek için uygulama oluşturmayın.
- Otomatik yönlendirmeler: Kullanıcı, açıkça işaretlenmiş bir harici bağlantıyı tıklamadığı sürece harici web sitelerini veya yerel uygulamaları otomatik olarak başlatmayın.
Kapsayıcı ve düzen
Ana kapsayıcılar, bağlı uygulamanızı model yanıtlarıyla birlikte çerçeveler. Bu kapsayıcılar, geçerli Google ürünlerinde iş ortağı ilişkilendirmesi, tutarlı kenarlıklar ve duyarlı boyutlandırma sağlar.
Kapsayıcı anatomisi
- Üstbilgi: İş ortağının simgesini ve resmi ismini gösterir.
- İçerik: Satır içi kart veya yatay bant olarak görünür.
- Yanıt metni eşleme: Görüntüleme modları her zaman model yanıt metniyle birlikte gösterilir. Bu birleştirilmiş düzene göre tasarım yapın.
- Kullanıcı arayüzü stili: Geçerli Google ürünlerinde ana kapsayıcı stillerini devralır.
Duyarlı davranış
Bağlı Uygulamalar, farklı kapsayıcı genişliklerinde ve cihaz görüntü alanlarında oluşturulur. Sabit boyutlardan kaçının:
- Yatay olarak yeniden akış: Kompakt kenar çubukları, mobil ekranlar ve geniş masaüstü feed'leri arasında yatay kırpma olmadan düzgün bir şekilde uyum sağlayan esnek düzenler kullanın.
- İçeriği dikey olarak sığdır: Satır içi kapsayıcıların, içeriklerini rahat bir okuma yüksekliğine sığdıracak şekilde büyümesine izin verin. Kartları asla sabit boşluklarla doldurmayın veya içeriği dikey kaydırma çubuğuna sıkıştırmayın.
- Cihaz girişlerine saygı gösterin: Mobil cihazlarda yerel dokunma hareketlerini ve güvenli alanları, masaüstünde ise fareyle üzerine gelme durumlarını destekleyin.
Kaçınılması gerekenler
- Çift dolgudan kaçının: Bağlı uygulamalar, sistem standartlarını karşılamak için varsayılan bir iç dolgu içerir. İstenmeyen boşlukları önlemek için dahili içerikteki fazladan dolguyu kaldırın.
- Dengesiz köşe yarıçapından kaçının: Aşırı keskin veya yuvarlak köşelerden kaçınmak için iç şekilleri ana kapsayıcının köşe yarıçapıyla orantılı tutun.
- Kendi konturunuzu eklemekten kaçının: Kapsayıcılar, varsayılan olarak sistem tarafından tanımlanan kenarlık stilini içerir. Dahili bileşenlerin çevresine fazladan kenarlık veya çizgi uygulamayın.
Görüntü modları
Görüntüleme modları, uzantınızın görsel kullanıcı arayüzünü geçerli Google ürünlerinin yanıtlarının hemen yanında nasıl göstereceğini tanımlar. İki birincil görüntüleme modundan birini kullanın: Satır içi kart veya tam ekran.
Satır içi kartlar
Satır içi kartlar, doğrudan yanıt akışına yerleştirilmiş hafif, tek amaçlı bileşenlerdir. Hızlı onaylar, yapılandırılmış veri denetimi veya tek adımlı işlemler için satır içi kartları kullanın.
Satır içi kartlar ne zaman kullanılır?
- Durum güncellemeleri ve onaylar.
- Basit veri görüntüleme veya seçimler.
- İsteğe bağlı genişletme seçeneğiyle kısa özetler.
- Sohbeti devam ettiren hızlı işlemler.
İçerik yoğunluğu ve kısaltma önlemleri
- Başlık sıkıştırma: Başlıkların işlemleri görünümden çıkarmaması için kart başlıklarını üç nokta ile kısaltarak 1-2 satırla sınırlayın.
- Gövde ve meta veri sınırları: Destekleyici metni 2-3 satırla sınırlayın ve öğe başına meta verileri 2-3 taranabilir özellikle sınırlandırın.
- Kısa CTA metni: Fiille başlayan işlem etiketleri (ör. "Masa ayırt" veya "Siparişi onayla") kullanın ve kart altbilgisini en fazla 1 birincil CTA ve 1 isteğe bağlı ikincil işlemle sınırlayın.
Dönen öğe tanımı: Dönen öğeler, kullanıcıyı yormadan kaydırma işlemini anlamlı kılmak için 3 ila 8 kart içermelidir. Tüm kartlar aynı yükseklik ve genişlik boyutlarına sahip olmalıdır. Kart başlıklarını 1-2 satırla, meta verileri ise kart başına 2-3 alanla sınırlayın.
Satır içi kartlar için etkileşimler
Satır içi kartlar, kullanıcıların sohbette kalmasını sağlayan hızlı ve doğrudan işlemlere odaklanmalıdır.
- Satır içi işlemler: Kullanıcıların metin düzenleme, öğe ekleme veya görevleri işaretleme gibi işlemleri doğrudan kart içinde yapmasına olanak tanır.
- Durum güncellemeleri: Karmaşık kullanıcı işlemlerini öğe içinde değil, doğrudan ileti dizisinde yansıtın. Örneğin, bir kullanıcı konaklama rezervasyonu yaptığında görüşmede "Rezerve edildi" etiketini gösteren güncellenmiş bir kart oluşturun.
Masaüstü bant gezinme menüsü
- Fareyle üzerine gelme mekaniği: Gezinme simgesi düğmeleri varsayılan olarak gizli kalır ve fareyle kapsayıcının üzerine gelindiğinde gösterilir.
- Taşma perdeleri: Başlangıç durumu sağ kenar perdesini, Orta her iki kenarı ve Bitiş sol kenarı gösterir.
Mobil cihazlarda bant deneyimi
- Dokunma hareketleri: Doğal yatay kaydırma hareketini kullanır ve dönen kartlar arasında boşluk bırakır.
- Kart önizleme: Başlangıç durumu sol dolgu kullanır, Orta durumda dolgu yoktur ve Bitiş durumu sağ dolgu kullanır.
Satır içi kartlarda kaçınılması gerekenler
- İç içe kaydırmadan kaçının: Hiçbir zaman dahili dikey kaydırma çubuğu eklemeyin.
- Çoklu görünüm ayrıntılandırmasından kaçının: Satır içi kartlarda gezinme yolu, çok sekmeli görünümler ve çok adımlı ayrıntılandırmalar kullanmayın. Karmaşık akışları tam ekrana taşıyın.
- Menülerde görünür kontrollerden kaçının: Kapsayıcı kırpma ve z-endeksi çakışmalarına neden olduğundan açılır listeler, popover'lar ve bağlam menüleri kullanmayın.
- Yinelenen girişlerden kaçının: Geçerli Google ürünlerinde giriş zaten mevcut olduğundan kartın içine başka bir giriş yerleştirmeyin.
- Dahili dikey kaydırmadan kaçının: Kartların içine kaydırılabilir kapsayıcılar yerleştirmeyin. Bu, kaydırma tuzağına neden olur ve mobil gezinmeyi zorlaştırır.
- Pop-over'lardan kaçının: İçeriği kapladıkları ve kullanıcı arayüzünü karmaşıklaştırdıkları için önemli ayrıntıları göstermek üzere ipuçları veya pop-over yer paylaşımları kullanmayın.
- Açılır menülerden kaçının: İşlemleri açılır seçicilerin içine gömmeyin. Birincil işlemleri açık düğmeler olarak gösterin.
- Dönen öğelerde kaydırma taşmasını gizlemekten kaçının: Kullanıcıların kaydırarak daha fazla içeriğe ulaşabileceklerini bilmeleri için bitişik kartın görünür olduğundan emin olun.
- Özel hata bileşenlerinden kaçının: Özel hata durumları kullanmayın. Ana makine kullanıcı arayüzü, tüm deneyim boyunca tutarlı bir şekilde standart bir hata bileşeni sağlar.
- Modalları kullanmaktan kaçının: MCP uygulamaları modalları desteklemez. Daha fazla alana ihtiyacınız varsa tam ekran moduna geçme seçeneği sunun.
Tam ekran
Satır içi karta sığmayan zengin, çok adımlı görevler veya veri ağırlıklı iş akışları için tam ekran modunu kullanın.
Tam ekran ne zaman kullanılır?
- Emlak ilanları, menüler veya etkileşimli haritalar gibi yoğun içeriklere göz atma
- Satır içi kartın dışında özel alan gerektiren tuval veya diyagram düzenleme gibi karmaşık iş akışları.
- Zengin kontrol panellerini, veri görselleştirmelerini ve odaklanmış dikkat gerektiren ayrıntılı analiz araçlarını görüntüleme gibi veri ve analizler.
Tam ekran için düzen ve etkileşimler
- Başlık: Uygulama ilişkilendirmesi ve işlemler içeren, sistem tarafından sağlanan bir başlık çubuğu gösterin.
- Güvenli alan ekleri: İçeriklerin çakışmasını önlemek için başlık çubuğunun altında boşluk bırakın.
- Kapat ve aç: Tam ekranda açmak için bir düğme ve tam ekran görünümünün başlığında bir kapat düğmesi gösterin.
Tam ekran için kaçınılması gerekenler
- Yerel uygulamanızı kopyalamaktan kaçının: Odaklanmış, çok adımlı görevlerde etkileşimi artırmak için tam ekranı kullanın.
- Yinelenen girişlerden kaçının: Geçerli Google ürünlerinde giriş zaten bulunduğundan iş ortakları, görünümün içine başka bir giriş yerleştirmemelidir.
- Kayan panellerden kaçının: Kayan modüller veya kayan sürüklenebilir denetleyici araç çubukları kullanmayın. Bunlar arayüzü karmaşıklaştırır ve ana yüzey yer paylaşımlarıyla çakışır.
- Güvenli alanların çakışmasını önleyin: Etkileşimli öğeleri, ana yüzey araç çubuğundan ve durum çubukları ile ana sayfa çubuğu gibi sistem göstergelerinden uzak tutun.
Etkileşim kuralları
Kullanıcıların bağlı bir uygulamadaki içeriği nasıl değiştirdiği, işlemlerin ana görüşmeyle nasıl senkronize edildiği ve karmaşık iş akışlarının ne zaman harici bir uygulamaya veya web sitesine aktarılacağı.
Uygulama kullanıcı arayüzü ile görüşme arasındaki iş bölümü
Bağlı uygulamanızı ve etkileşimli istemlerinizi birbirini tamamlayan katmanlar olarak tasarlayın:
- Doğrudan işlem için bağlı uygulama kullanıcı arayüzünü kullanma: Haritada gezinme, yapılandırılmış seçenekleri karşılaştırma, çok alanlı form kontrolleri ve yazılı istemler yazmanın sıkıcı veya belirsiz olacağı görsel seçimler gibi mekansal gezinme için kullanıcı arayüzünü kullanın.
- Açık uçlu amaçlar için ana sohbeti kullanın: Doğal dilde ek sorular, çok adımlı sentez ve geniş kapsamlı keşif sorguları için sohbeti kullanın.
İlerleme durumu açıklaması
- Kademeli açıklama: Kullanıcının ihtiyacını karşılayan en kompakt görüntüleme moduyla (satır içi kart veya bant) başlayın, isteğe bağlı olarak ikincil ayrıntıları gösterin (Daha fazla göster) ve yalnızca ayrıntılı inceleme gerektiğinde tam ekrana geçin.
- Gizli menüler yerine görünür kontroller: Birincil işlemleri, yalnızca fareyle üzerine gelindiğinde görünen araç çubuklarına, sağ tıklama bağlam menülerine veya mobil görüntü alanlarında çalışmayan uzun basma hareketlerine gömmek yerine açık düğmeler veya açma/kapatma düğmeleri olarak gösterin.
Harici aktarımlar ve bağlantı oluşturma
Bazı özellikler, yerleştirilmiş bir iframe'in kapsamını aşar veya yerel OS ve donanım özellikleri gerektirir. Uygulamanıza veya sitenize ne zaman bağlantı vermelisiniz?
- Yerel OS veya donanıma bağlı özellikler (ör. canlı navigasyon, kamera veya sensörle yakalama ya da sürekli arka planda ses ve konum takibi).
- Yasal düzenlemelere tabi veya güvenliğe duyarlı akışlar (ör. son ödeme aşaması veya kimlik doğrulama)
- Tam ekranın ötesinde derin çalışma alanları (ör. tam özellikli yazma paketleri veya karmaşık kurumsal kontrol panelleri).
Devir sürecini tasarlama
- Harici bağlantı olduğunu açıkça gösterin: Harici aktarma düğmelerini her zaman açık bir başlatma göstergesi (ör.
open_in_newsimgesi) ve hedefe özel bir etiketle (ör. "Google Haritalar'da aç") birlikte kullanın. - Bağlamı korunmuş derin bağlantı: Görüşmede belirlenen tüm parametreleri, barındırıcının harici bağlantı API'si (
openLink) aracılığıyla derin bağlantı URL'sine iletin. Böylece kullanıcılar, uygulama değiştirdikten sonra seçimlerini tekrar girmek zorunda kalmaz.
Kaçınılması gerekenler
- Otomatik yönlendirmelerden kaçının: Kullanıcıları hiçbir zaman otomatik olarak ana makine yüzeyinden başka bir yere yönlendirmeyin. Ana makine yüzeyinden ayrılmak için her zaman kullanıcının açıkça tıklaması gerekir.
- "Tanıtım" veya yalnızca bağlantı içeren kartlardan kaçının: Tek amacı, kullanıcıları web sitenize yönlendiren statik bir banner veya düğme oluşturmak olan bağlı bir uygulama oluşturmayın.
- Önceden bildirilmeyen bağlam değişikliklerinden kaçının: Harici bir bağlantıyı, harici bir uygulama veya tarayıcı sekmesi açtığını belirtmeden asla kart içi işlemle aynı şekilde biçimlendirmeyin.
Görsel yönergeler
Geçerli Google ürünleri, bilişsel yükü azaltmak için hafif, nötr kullanıcı arayüzü öğelerine ve yumuşatılmış kontrasta öncelik verir.
Görsel ilkeler
Bağlı Uygulamalar'da görsel yoğunluğu ve estetiği yönetmek için temel tasarım ilkelerini uygular:
- Daha hafif ve minimal kullanıcı arayüzü: Temiz bir görsel yoğunluk sağlamak için çizgileri ve kapsayıcı öğeleri azaltın.
- Nötr renk dengesi: Nötr gri tonlara öncelik verin ve vurgu renklerini birincil CTA'lar için kullanın.
- Yükseklik: Yumuşak yüzey dolguları uygulayın ve gölgeleri yalnızca tam ekran modu ve bant gezinme kontrolleriyle sınırlayın.
- Stil devralma: Uygulamaların geçerli tüm Google ürünlerinde yerel hissi vermesi için renkleri, tipografiyi ve köşe yarıçaplarını uygulayın.
Renk
Geçerli Google ürünleri, renkleri iki işlevsel grupta düzenler: Yapısal düzen için sistem renkleri ve birincil marka anları için vurgu renkleri. Bu semantik rollere güvenmek, ürünler arasında net bir görsel hiyerarşi ve otomatik tema uyarlaması sağlar.
Sistem rengi rolleri
Yapısal renkleri, bağlı uygulamalarda tutarlı kullanıcı arayüzü rollerine eşleyin:
- Arka plan yüzeyleri: Kart kapsayıcıları ve iç içe yerleştirilmiş gruplar için ana makine tarafından sağlanan nötr yüzey renklerini kullanın. Kapsayıcı arka planlarını özel düz dolgular, renk geçişleri veya desenlerle geçersiz kılmaktan kaçının.
- Metin ve içerik hiyerarşisi: Başlıklar ve önemli değerler için birincil içerik renklerini, gövde metni ve destekleyici etiketler için ikincil yumuşak tonları, operasyonel meta veriler için ise anlamlı durum renklerini (olumlu, uyarı, kritik) kullanın.
- Kenarlıklar ve ayırıcılar: Yapısal kenarlıklar ve ayırıcılar için hafif sistem ana hat renkleri kullanarak içeriği ağır görsel ağırlık eklemeden ayırın.
- Birincil vurgu: Birincil harekete geçirici mesaj düğmeleri için sistem vurgusunu veya iş ortağınızın marka rengini kullanın.
İş ortağı marka uygulama alanları
Bağlı uygulamalarda iş ortağı markasının renk yerleşimini yönlendirme:
- Önerilen: Marka renklerini birincil harekete geçirici düğmelere, logolara ve önemli anlara seçerek uygulayın.
- Önerilmez: Marka renklerini kart arka planlarına, gövde metnine, başlıklara, yapısal kenarlıklara veya ikincil etkileşimli kontrollere uygulamaktan kaçının.
Tema ve açık/koyu mod
Bağlı uygulamalar, açık ve koyu temaların yanı sıra dinamik yüzey paletleriyle de uyumlu olmalıdır:
- Statik onaltılık değerler yerine semantik jetonlar kullanın: Yüzeyleri, metinleri ve kenarlıkları ana yüzeyin semantik renk jetonlarına bağlayın. Böylece arayüzünüz açık ve koyu modlar arasında otomatik olarak uyum sağlar.
- Marka vurgularını her iki temaya da uyarlayın: Markanızın vurgu renginin her iki temada da erişilebilir kontrastı koruduğundan emin olun. Varsayılan marka renginiz koyu yüzeylerde çok koyu veya aşırı canlı görünüyorsa koyu modda biraz daha açık veya daha az doygun bir varyant kullanın.
- Temaya hazır medya ve logolar kullanın: Simgeleri, logoları ve çizimleri şeffaf arka planlarla dışa aktarın. Böylece koyu modda beyaz sınırlayıcı kutular görünmez.
Simgeler
Bağlı Uygulamalar, geçerli Google ürünlerinde görsel uyumu ve taranabilirliği korumak için net, ana hatları belirgin simgeler kullanır.
Simge stili ve boyutu
Bağlı Uygulamalar'da kılavuz simgesi geometrisi, rengi ve boyut eşikleri:
- Ana hatları belirgin, yuvarlak geometri: Tek tip çizgi kalınlıklarına ve yuvarlak uçlara sahip tek renkli ana hatları belirgin simgeler (ör. Google Material Symbols Outlined) veya ana makine arayüzünün görsel ağırlığıyla eşleşen uyumlu bir iş ortağı simge seti kullanın.
- Nötr renklendirme: İşlevsel kullanıcı arayüzü simgelerini marka renkleri yerine birincil veya ikincil içerik renklerini kullanarak renklendirin. Böylece simgeler, birincil CTA'larla rekabet etmeden okuma hiyerarşisini destekler.
- Boyut sınırları: Görüntü alanlarında okunabilirliği ve orantıyı korumak için simgeleri 16 piksel (satır içi kompakt meta veriler için) ile 32 piksel (belirgin kart veya özellik başlıkları için) arasında tutun.
Erişilebilirlik
Geçerli Google ürünleri, WCAG 2.1 AA ve Materyal Tasarım 3 standartlarına uygun erişilebilirlik şartlarını uygular.
Erişilebilirliğin temel unsurları
- Renk kontrastı: Açık ve koyu temalarda metin ile arka plan arasında minimum 4,5:1 WCAG AA kontrast oranı uygulayın.
- Minimum metin boyutu: 13 punto yazı boyutunu zorunlu kılar.
- Dokunma hedefleri: Kontroller için mobil cihazlarda en az 48x48 piksel, masaüstünde ise en az 24x24 piksel etkileşimli hedef alanı zorunlu kılın.
- Klavye odağı: Etkileşimli kart bileşenlerinde görünür bir odak göstergesi halkası ve mantıksal bir sekme geçiş sırası kullanın.
- Dinamik medya alternatif metni: İş ortakları tarafından sağlanan tüm resimler, küçük resimler, harita raptiyeleri ve veri görselleştirmeleri için açıklayıcı alternatif metinler sağlayın.
- Canlı durum duyuruları (
aria-live): "Daha fazla göster" satırlarını genişletme, öğeleri filtreleme veya satır içi bir işlemi tamamlama gibi dinamik kart içi durum değişikliklerini duyurmak içinaria-live="polite"bölgelerini kullanın. - Azaltılmış hareket (
prefers-reduced-motion): İskelet parıltı efektlerini ve bant slayt geçişlerini statik veya anlık durum değişiklikleriyle değiştirerek kullanıcınınprefers-reduced-motionmedya sorgusuna uyun. - İçerik taşması ve kesilmesi: Düzenin bozulmasını önlemek ve okunabilirliği korumak için uzun metin bloklarını 3-5 satırla sınırlayın ve erişilebilir bir "Devamını oku" işlemi ekleyin.