Resim

Image widget'ı, HTTPS URL'sinde barındırılan bir .png veya .jpg resmi gösterir. Görüntülenen resmin genişliği, görüntülenen kartın tüm genişliğini kaplar ve yüksekliği resmin en boy oranını koruyacak şekilde ayarlanır.

Image widget'ı, kullanıcılar resmi tıkladığında gerçekleşen tıklama işlemlerini destekler. Örnek onclick işlemlerine şunlar dahildir:

• OpenLink ile bir köprü açın (ör. Google Chat geliştirici belgelerine ait köprü) https://developers.google.com/chat.
• API çağırma gibi özel bir işlev çalıştıran işlem çalıştırın.

Aşağıda, Image widget'ından oluşan bir kart gösterilmektedir. Google Chat geliştirici belgeleri açılış sayfası resmi görüntülenir. Kullanıcılar resmi tıkladığında Google Chat geliştirici dokümanları yeni bir sekmede açılır.

JSON gösterimi ve alanları

JSON gösterimi
{ "imageUrl": string, "onClick": { object (OnClick) }, "altText": string }

Alanlar
imageUrl	string Resmi barındıran HTTPS URL'si. Örneğin: https://developers.google.com/chat/images/quickstart-app-avatar.png
onClick	object (OnClick) Kullanıcı resmi tıkladığında, tıklama bu işlemi tetikler.
altText	string Bu resmin erişilebilirlik için kullanılan alternatif metni.

OnClick

Kullanıcılar karttaki düğme gibi etkileşimli bir öğeyi tıkladığında nasıl yanıt verileceğini gösterir.

JSON gösterimi
{ // Union field data can be only one of the following: "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) } // End of list of possible types for union field data. }

Alanlar
Birlik alanı data. data, aşağıdakilerden yalnızca biri olabilir:
action	object (Action) Belirtilirse bu onClick tarafından bir işlem tetiklenir.
openLink	object (OpenLink) Belirtilirse bu onClick, bir açık bağlantı işlemini tetikler.
openDynamicLinkAction	object (Action) Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde bu işlemi tetikler. Bağlantıyı almak için sunucuyla iletişimde olması gerektiğinden bu yukarıdaki openLink yönteminden farklıdır. Bu nedenle, açık bağlantı işlemi yanıtı geri gelmeden önce web istemcisinin yapması gereken bazı hazırlık çalışmaları gerekir. Google Workspace Eklentileri tarafından desteklenir ancak Google Chat uygulamaları tarafından desteklenmez.
card	object (Card) Belirtilmişse yeni bir kart, tıklandıktan sonra kart yığınına aktarılır. Google Workspace Eklentileri tarafından desteklenir ancak Google Chat uygulamaları tarafından desteklenmez.

İşlem

Form gönderildiğinde davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası'nı çağırabilirsiniz. İşlem tetiklenirse form değerleri sunucuya gönderilir.

JSON gösterimi
{ "function": string, "parameters": [ { object (ActionParameter) } ], "loadIndicator": enum (LoadIndicator), "persistValues": boolean, "interaction": enum (Interaction) }

Alanlar
function	string İçeren öğe tıklandığında veya otomatik olarak etkinleştirildiğinde çağrılacak özel bir işlev. Örneğin kullanımı Etkileşimli kartlar oluşturma başlıklı makalede bulabilirsiniz.
parameters[]	object (ActionParameter) İşlem parametrelerinin listesi.
loadIndicator	enum (LoadIndicator) Harekete geçirici mesajda bulunurken görüntülenen yükleme göstergesini belirtir.
persistValues	boolean İşlemden sonra form değerlerinin korunup korunmayacağını belirtir. false, varsayılan değerdir. true ise form değerleri işlem tetiklendikten sonra kalır. İşlem işlenirken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator özelliğini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini de UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId etiketinin aynısını kullanmanız gerekir. false ise işlem tetiklendiğinde form değerleri temizlenir. İşlem işlenirken kullanıcının değişiklik yapmasını engellemek için LoadIndicator özelliğini SPINNER olarak ayarlayın.
interaction	enum (Interaction) İsteğe bağlı. İletişim kutusu açarken gereklidir. Bir kullanıcıyla etkileşime (ör. bir kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılması gereken işlem. Belirtilmemişse uygulama, normal şekilde bir action yürüterek (ör. bir bağlantıyı açma veya bir işlevi çalıştırma) yanıt verir. Bir interaction belirtildiğinde, uygulama özel etkileşimli yollarla yanıt verebilir. Örneğin, interaction OPEN_DIALOG olarak ayarlandığında uygulama bir iletişim kutusu açabilir. Belirtildiğinde, bir yükleme göstergesi gösterilmez. Chat uygulamaları tarafından desteklenir ancak Google Workspace Eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

ActionParameter

İşlem yöntemi çağrıldığında sağlanacak dize parametrelerinin listesi. Örneğin, şu üç erteleme düğmesini kullanabilirsiniz: Şimdi ertele, bir gün ertele veya gelecek hafta ertele. action method = snooze() kullanarak dize parametreleri listesinde erteleme türünü ve erteleme süresini iletebilirsiniz.

Daha fazla bilgi için CommonEventObject sayfasına bakın.

JSON gösterimi
{ "key": string, "value": string }

Alanlar
key	string İşlem komut dosyası için parametrenin adı.
value	string Parametrenin değeri.

LoadIndicator

Harekete geçirici mesajda bulunurken görüntülenen yükleme göstergesini belirtir.

Sıralamalar
SPINNER	İçeriğin yüklenmekte olduğunu belirten bir döner simge görüntüler.
NONE	Hiçbir şey gösterilmez.

Etkileşim

İsteğe bağlı. İletişim kutusu açarken gereklidir.

Bir kullanıcıyla etkileşime (ör. bir kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılması gereken işlem.

Belirtilmemişse uygulama, normal şekilde bir action yürüterek (ör. bir bağlantıyı açma veya bir işlevi çalıştırma) yanıt verir.

Bir interaction belirtildiğinde, uygulama özel etkileşimli yollarla yanıt verebilir. Örneğin, interaction OPEN_DIALOG olarak ayarlandığında uygulama bir iletişim kutusu açabilir.

Belirtildiğinde, bir yükleme göstergesi gösterilmez.

Chat uygulamaları tarafından desteklenir ancak Google Workspace Eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Sıralamalar
INTERACTION_UNSPECIFIED	Varsayılan değer. action, normal şekilde çalışır.
OPEN_DIALOG	Chat uygulamalarının kullanıcılarla etkileşimde bulunmak için kullandığı pencereli, kart tabanlı bir arayüz olan iletişim kutusunu açar. Kart mesajlarındaki düğme tıklamalarına yanıt olarak yalnızca Chat uygulamaları tarafından desteklenir. Google Workspace Eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

OpenLink

Bir köprü açan onClick etkinliğini temsil eder.

JSON gösterimi
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

Alanlar
url	string Açılacak URL.
openAs	enum (OpenAs) Bağlantılar nasıl açılır? Chat uygulamaları tarafından desteklenmez.
onClose	enum (OnClose) Müşterinin bir bağlantıyı açtıktan sonra unuttuğu mu yoksa pencere kapanana kadar bağlantıyı mı gözlemlediği. Chat uygulamaları tarafından desteklenmez.

Sınırlar ve dikkat edilmesi gereken noktalar

• Yalnızca .png ve .jpg resimleri desteklenir.
• Ana makine URL'si HTTPS olmalıdır.
• Yüksek performans sağlayan kartlardan emin olmak için önerilen maksimum resim boyutu 2 MB'tır.

Sorun giderme

Bir Google Chat uygulaması veya kart hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu" veya "İsteğiniz işleme alınamıyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, bir kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde bir hata mesajı gösterilmese de, Chat uygulamaları için hata günlük kaydı etkinken hataları düzeltmenize yardımcı olmak üzere açıklayıcı hata mesajları ve günlük verileri kullanılabilir. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım almak için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.