Google Workspace eklentileri, genişlettikleri ana uygulamanın stili ve düzeniyle tutarlı olmalıdır. Kullanıcı arayüzünü, tanıdık kontroller ve davranışlar kullanarak doğal bir şekilde genişletmelidir. Burada sunulan yönergeler, metin, resim, kontrol ve markalama ile ilgili yüksek kaliteli bir kullanıcı deneyimi sunan yöntemleri açıklar.
Eklentiniz, eklentinin çalışmasının ayrılmaz bir parçası olan ayrı web sayfaları (ör. eklentinin ayarlar sayfası) açıyorsa bu web sayfalarının da bu stil yönergelerine uyduğundan emin olun.
Metin ve görseller
Bu bölümde, eklentinizde metin ve resimleri nasıl doğru şekilde kullanacağınız açıklanmaktadır.
Eklenti adı
Eklentinizin adını, proje manifestinde ve eklentinizi yayınlamak için yapılandırırken ayarlamanız gerekir. Ad, Google Workspace Marketplace girişi ve menüler gibi birçok yerde görünür. Ad seçerken:
- Başlık düzeni kullanın.
- Markanızda yer almadığı sürece noktalama işaretleri (özellikle parantez) kullanmaktan kaçının.
- Kısa tutun. En iyisi 15 karakter veya daha azdır. Uzun adlar, Google Workspace Marketplace listelemesinde ve diğer yerlerde otomatik olarak kısaltılabilir.
- Eklenti adınız "Google", "Gmail" veya diğer Google ürün adlarını içermemelidir.
- Eklenti adınız "eklenti" kelimesini içermemelidir.
- Sürüm bilgilerini çıkarın.
Yazım stili
Çok fazla yazmanıza gerek yoktur. Çoğu işlem, simge, düzen ve kısa etiketler aracılığıyla net bir şekilde açıklanmalıdır. Eklentinizin bir kısmının kısa etiketlerle açıklanamayacak kadar ayrıntılı bir açıklamaya ihtiyacı olduğunu düşünüyorsanız eklentinizi açıklayan ve bu sayfaya bağlantı veren ayrı bir web sayfası oluşturmanız önerilir.
Kullanıcı arayüzü metni yazarken:
- Cümle büyük harflerini kullanın (özellikle düğmeler, etiketler ve kart işlemleri için).
- Jargon veya kısaltma içermeyen kısa ve basit metinler tercih edin.
Evrensel ve kart işlemleri
Eklentinizde evrensel işlemler veya kart işlemleri kullanıyorsanız bu işlemler, tanımladığınız kartlarda menü öğeleri olarak görünür. Bu işlemler için bu menülerde kullanılan metni seçebilirsiniz. Kullanılacak metni seçerken:
- Eklentinizin adını tekrarlayan menü metinlerinden kaçının.
- Her menü öğesini "Çalıştır", "Yapılandır" veya "Oluştur" gibi bir işlem kelimesiyle başlatın.
- İşlemin görüntülediği kullanıcı arayüzü bileşenini değil, görevi açıklayın.
- İşleminiz bir iş akışını başlatıyorsa ve ne yaptığını açıklayan tek bir fiil yoksa işlemi "Başlat" olarak adlandırın.
- Kullanıcıyı büyük bir listede kaydırmaya zorlamamak için menü öğelerinin sayısını düşük tutun. Uygulamanız gereken başka işlemler varsa her biri farklı işlemler içeren birden fazla kart kullanabilirsiniz.
Hata mesajları
Bir sorun oluştuğunda basit bir dil kullanmak önemlidir. Sorunu kullanıcının bakış açısından açıklayın ve nasıl düzeltileceğini önerin.
- Kullanıcının, kodunuzun oluşturduğu istisnaları görmesine izin vermeyin. Bunun yerine, istisnaları yakalamak için
try...catchifadelerini kullanın ve ardından kullanıcı dostu bir hata mesajı gösterin. - Eklentinizi yayınlamadan önce, kullanıcı arayüzünde hata ayıklama bilgilerinin gösterilmediğinden emin olun.
Yardım içeriği
Yardım bilgilerini gösteren veya eklentinin işleyişini kullanıcıya açıklayan kartlar tasarlayabilirsiniz. Eklentiniz için yardım içeriği oluşturuyorsanız şunları unutmayın:
- Mümkünse talimatları madde işaretli veya numaralı listede gösterin. Kullanıcıları, adlandırılmış kullanıcı arayüzü öğelerine net referanslar vererek sonuca kadar yönlendirin.
- Talimatlarınızda, belirli bir şekilde e-tablo oluşturma gibi tüm gereksinimlerin net bir şekilde açıklandığından emin olun.
- Destek web sayfaları gibi harici yardım içeriklerine bağlantı verebilirsiniz.
Resimler
Eklentinizde kullanılan resimler, yerleşik simge türlerinden biri veya URL ile belirtilen herkese açık bir resim olmalıdır. Barındırılan resimleri kullanırken, eklentinizi kullanabilecek herkesin bu resimlere erişebildiğinden emin olun.
Denetimler
Bu bölümde, etkileşimli widget'lar için kullanıcı deneyimi yönergeleri sağlanmaktadır.
Düğmeler
Diğer widget'lar yerine kullanıcı arayüzünüzün ana işlemlerini kontrol etmek için düğmeler kullanın.
- Çoğu metin düğmesi etiketi bir fiille başlamalıdır.
- Düğme satırları çoğu durumda üç veya daha az düğmeyle sınırlı olmalıdır.
DecoratedText
DecoratedText widget'ları, metin içeriğini simge, düğme veya anahtarlarla sunmanıza olanak tanır.
- Metin içeriği için normal cümle düzenini kullanın.
- DecoratedText widget'ının metni, mevcut alana sığamazsa kısaltılır. Bu nedenle, metin içeriğini her zaman olabildiğince kısa tutmaya çalışın.
Seçim girişleri
Eklentilerinizde çeşitli seçim giriş widget'ları kullanabilirsiniz: açılır seçim kutuları, onay kutuları ve radyo düğmeleri.
- Kullanıcıların birden fazla seçenek veya hiç seçenek seçemediği durumlarda onay kutularını kullanın. Tam olarak bir seçenek seçilmesi gerektiğinde radyo düğmelerini (veya bir seçim menüsünü) kullanın. Kullanıcı arayüzünde yer kazanmaya çalışırken kısa bir alternatif listesi sağlarken açılır menüleri kullanın.
- Her seçeneğe atanan metin için büyük harfleri kullanın.
- Kullanıcılar seçim yaparken genellikle hata yaptığından, geri alınması zor olan önemli işlemleri tetiklemek için seçim değişikliklerini kullanmaktan kaçının. Bunun yerine, mevcut seçim değerlerini okuyup işlemi tetikleyen bir düğme ekleyebilirsiniz.
- Açılır listelerde seçenekleri alfabetik olarak veya tüm kullanıcıların anlayabileceği mantıklı bir plana göre sıralayın (ör. haftanın günlerini pazar veya pazartesiden başlayarak sırayla sunma).
- Belirli bir seçim giriş widget'ındaki seçenek sayısını makul bir sayıyla sınırlayın. Çok fazla seçenek varsa kullanıcılar widget'ı kullanmayı zor bulabilir. Bu gibi durumlarda, seçeneği farklı kategorilere ve birden fazla widget'a ayırabilirsiniz.
Metin girişleri
Metin girişleri, kullanıcıların dize verileri girebileceği bir yer sağlar.
- Kullanıcının belirli bir olası giriş grubundan birini yazmasını sağlamak için metin girişi kullanmayın. Bunun yerine açılır liste seçeneğini kullanın.
- Kullanıcının doğru biçim ve içerikle metin girmesine yardımcı olmak için ipuçları ve öneriler kullanın.
- Girilecek metin birkaç kelimeden fazlaysa çok satırlı metin girişleri kullanın.
Marka bilinci oluşturma
Bu bölümde, eklenti arayüzünüze marka öğeleri eklemeyle ilgili kullanıcı deneyimi yönergeleri sağlanmaktadır.
Eklentilerinizde
Eklenti kullanıcı arayüzünüze marka öğeleri eklemek istiyorsanız kısa ve basit bir şekilde ekleyin. Bu, kullanıcıların eklenti işlevinize odaklanmasına yardımcı olur.
- Eklentinizin tüm yönleri markalaşma kurallarına uygun olmalıdır.
- "Google", "Gmail" veya diğer Google ürün adlarını kullanmayın.
- Değiştirilmiş olsalar bile Google ürün simgelerini eklemeyin.
- Marka metninize "eklenti" kelimesini eklemeyin.
- Marka metni birkaç kelimeden uzun olmamalıdır.
Google Workspace Marketplace'te
Eklentinizi yayınlanacak şekilde yapılandırırken Google Workspace Marketplace girişini oluşturmak için bir dizi grafik ve metin öğesi sağlarsınız.
Mağaza girişinizin ve bu öğelerin tüm yönleri markalaşma yönergelerine uygun olmalıdır.