- Kaynak: Mesaj
- Kart
- CardHeader
- Resim Stili
- Bölüm
- WidgetMarkup
- TextParagraph
- Resim
- Tıklama
- FormAction
- ActionParameter
- OpenLink
- AnahtarDeğeri
- Simge
- Düğme
- TextButton
- ImageButton
- Kart İşlemi
- Kimlikle Kart
- Kart
- CardHeader
- Resim Türü
- Bölüm
- Widget
- TextParagraph
- Resim
- Tıklama
- İşlem
- ActionParameter
- LoadIndicator
- Etkileşim
- OpenLink
- Farklı
- Yakında
- DecoratedText
- Simge
- Düğme
- Renk
- SwitchControl
- Denetim Türü
- Düğme Listesi
- TextInput
- Tür
- Öneriler
- ÖneriÖğesi
- Seçim Girişi
- Seçim Türü
- SelectionItem
- PlatformDataSource
- OrtakVeriKaynağı
- AnabilgisayarAppDataSourceMarkup
- SohbetMüşteriVeri Kaynağıİşaretlemesi
- SpaceDataSource
- DateTimeSelecter
- TarihSaat Seçici
- Bölen
- Izgara
- GridItem
- ImageBileşen
- ImageKırpma Stili
- ImageKırpma Türü
- BorderStyle
- KenarlıkTürü
- GridItemLayout
- Sütunlar
- Sütun
- YatayBoyutStili
- Yatay Hizalama
- DikeyHizalama
- Widget'lar
- Bölme Stili
- Kart İşlemi
- CardFixedFooter
- Görüntü Stili
- Ek açıklama
- Notlar Türü
- UsermentMetadata
- Tür
- SlashCommandMetadata
- Tür
- İleti dizisi
- ActionResponse
- Yanıt Türü
- DialogAction
- İletişim kutusu
- İşlem Durumu
- Code
- SlashCommand
- Eşleşen URL
- EmojiReactionSummary
- Silme Meta Verileri
- Silme Türü
- quotedMessageMetadata
- EkliGif
- Yöntemler
Kaynak: Mesaj
Google Chat alanında mesaj.
JSON gösterimi |
---|
{ "name": string, "sender": { object ( |
Alanlar | |
---|---|
name |
Örnek: |
sender |
Yalnızca çıkış. Mesajı oluşturan kullanıcı. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkış, |
createTime |
Chat'te oluşturulan alanlarda mesajın oluşturulduğu saat. Bu alan, içe aktarılan alanlarda kullanıldığı durumlar dışında yalnızca çıkış işlevi görür. İçe aktarılan alanlarda, orijinal oluşturma zamanını korumak için bu alanı mesajın kaynakta oluşturulduğu geçmiş zaman damgasına ayarlayın. |
lastUpdateTime |
Yalnızca çıkış. Mesajın bir kullanıcı tarafından en son düzenlendiği saat. Mesaj hiç düzenlenmediyse bu alan boş bırakılır. |
deleteTime |
Yalnızca çıkış. Mesajın Google Chat'te silindiği saat. Mesaj hiçbir zaman silinmezse bu alan boş bırakılır. |
text |
İletinin düz metin gövdesi. Bir resim, video veya web sayfasına verilen ilk bağlantı bir önizleme çipi oluşturur. Ayrıca, bir Google Chat kullanıcısından veya alandaki herkesten de@bahsedebilirsiniz. Kısa mesaj oluşturma hakkında bilgi edinmek için Kısa mesaj gönderme başlıklı makaleyi inceleyin. |
formattedText |
Yalnızca çıkış. İletişim biçimlendirmesi için işaretlemelerin eklendiği
Daha fazla bilgi için İletide gönderilen metin biçimlendirmesini görüntüleme başlıklı makaleye bakın. |
cards[] |
Kullanımdan kaldırıldı: Bunun yerine Biçimlendirilmiş metinler, düğmeler ve tıklanabilir resimler gibi kullanıcı arayüzü öğelerini görüntülemek için kullanabileceğiniz zengin, biçimlendirilmiş ve etkileşimli kartlar. Kartlar normalde iletinin düz metin gövdesinin altında görüntülenir. |
cardsV2[] |
Bir kart dizisi. Yalnızca Chat uygulamaları kart oluşturabilir. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa mesajlarda kart bulunamaz. Kartlar ve nasıl oluşturulacağı hakkında bilgi edinmek için Kartlarla dinamik, etkileşimli ve tutarlı kullanıcı arayüzleri tasarlama başlıklı makaleye bakın. |
annotations[] |
Yalnızca çıkış. Bu mesajdaki |
thread |
Mesajın ait olduğu mesaj dizisi. Örneğin, kullanımı Bir mesaj dizisi başlatma veya yanıtlama başlıklı makalede bulabilirsiniz. |
space |
Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkış, |
fallbackText |
Asıl kartlar görüntülenemediğinde (ör. mobil bildirimler) kullanılan, mesaj kartlarının düz metin açıklaması. |
actionResponse |
Yalnızca giriş. Bir Chat uygulamasının, yanıtının nasıl yayınlanacağını yapılandırmak için kullanabileceği parametreler. |
argumentText |
Yalnızca çıkış. Mesajın düz metin gövdesinde Chat uygulamasındaki tüm bahisler çıkarılmış. |
slashCommand |
Yalnızca çıkış. Varsa eğik çizgi komutu bilgileri. |
attachment[] |
Kullanıcı tarafından yüklenen ek. |
matchedUrl |
Yalnızca çıkış. |
threadReply |
Yalnızca çıkış. Alan, mesaj dizilerinde yanıt vermeyi desteklemiyorsa bu alan her zaman |
clientAssignedMessageId |
Oluşturma sırasında atanan Chat mesajı için özel bir ad. |
emojiReactionSummaries[] |
Yalnızca çıkış. Mesajdaki emoji tepki özetlerinin listesi. |
deletionMetadata |
Yalnızca çıkış. Silinen bir mesajla ilgili bilgiler. |
quotedMessageMetadata |
Yalnızca çıkış. Bir alandaki Google Chat kullanıcısı tarafından alıntılanan bir mesaj hakkında bilgi. Google Chat kullanıcıları bir mesajı yanıtlamak için alıntı yapabilir. |
attachedGifs[] |
Yalnızca çıkış. İletiye eklenen GIF resimler. |
Kimlikli Kart
Google Chat mesajındaki bir kart.
Yalnızca Chat uygulamaları kart oluşturabilir. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa mesaj, kart içeremez.
JSON gösterimi |
---|
{
"cardId": string,
"card": {
object ( |
Alanlar | |
---|---|
cardId |
İleti birden fazla kart içeriyorsa gereklidir. Bir mesajdaki kartın benzersiz tanımlayıcısı. |
card |
Kart. Maksimum boyut 32 KB'tır. |
Notasyon
Yalnızca çıkış. İletinin düz metin gövdesiyle ilişkili ek açıklamalar. Kısa mesaja temel biçimlendirme eklemek için Kısa mesajları biçimlendirme bölümüne bakın.
Örnek düz metin mesaj gövdesi:
Hello @FooBot how are you!"
İlgili ek açıklama meta verileri:
"annotations":[{
"type":"USER_MENTION",
"startIndex":6,
"length":7,
"userMention": {
"user": {
"name":"users/{user}",
"displayName":"FooBot",
"avatarUrl":"https://goo.gl/aeDtrS",
"type":"BOT"
},
"type":"MENTION"
}
}]
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Bu ek açıklamanın türü. |
length |
Bu ek açıklamanın karşılık geldiği düz metin mesaj gövdesindeki alt dizenin uzunluğu. |
startIndex |
Bu ek açıklamanın karşılık geldiği düz metin mesaj gövdesindeki başlangıç dizini (0 tabanlı, dahil). |
Birlik alanı metadata . Ek açıklamayla ilgili ek meta veriler. metadata şunlardan yalnızca biri olabilir: |
|
userMention |
Kullanıcı bahsi geçen meta veriler. |
slashCommand |
Eğik çizgi komutu için meta veriler. |
AnnotationType
Ek açıklamanın türü.
Sıralamalar | |
---|---|
ANNOTATION_TYPE_UNSPECIFIED |
Sıralama için varsayılan değer. Kullanmayın. |
USER_MENTION |
Bir kullanıcıdan bahsediliyor. |
SLASH_COMMAND |
Eğik çizgi komutu çağrılır. |
KullanıcıBahsi Meta Veri
Kullanıcı bahisleri (@) için ek açıklama meta verileri.
JSON gösterimi |
---|
{ "user": { object ( |
Alanlar | |
---|---|
user |
Kullanıcı bahsetti. |
type |
Kullanıcının bahsedilen türü. |
Tür
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Sıralama için varsayılan değer. Kullanmayın. |
ADD |
Kullanıcıyı alana ekleyin. |
MENTION |
Alandaki kullanıcıdan bahsedilmelidir. |
SlashCommandMetadata
Eğik çizgi komutları (/) için ek açıklama meta verileri.
JSON gösterimi |
---|
{ "bot": { object ( |
Alanlar | |
---|---|
bot |
Komutu çağrılan Chat uygulaması. |
type |
Eğik çizgi komutunun türü. |
commandName |
Çağrılan eğik çizgi komutunun adı. |
commandId |
Çağrılan eğik çizgi komutunun komut kimliği. |
triggersDialog |
Eğik çizgi komutunun bir iletişim kutusu için olup olmadığını belirtir. |
Tür
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Sıralama için varsayılan değer. Kullanmayın. |
ADD |
Chat uygulamasını alana ekleyin. |
INVOKE |
Alanda eğik çizgi komutu çağırın. |
İleti dizisi
Google Chat alanındaki bir mesaj dizisi. Örneğin, kullanımı Bir mesaj dizisi başlatma veya yanıtlama başlıklı makalede bulabilirsiniz.
Bir ileti oluştururken ileti dizisi belirtirseniz eşleşen bir ileti dizisi bulunamazsa ne olacağını belirlemek için messageReplyOption
alanını ayarlayabilirsiniz.
JSON gösterimi |
---|
{ "name": string, "threadKey": string } |
Alanlar | |
---|---|
name |
Yalnızca çıkış. İleti dizisinin kaynak adı. Örnek: |
threadKey |
İsteğe bağlı. İleti dizisi oluşturmak veya güncellemek için giriş. Aksi takdirde, yalnızca çıkış için geçerlidir. İleti dizisinin kimliği. 4.000 karaktere kadar destekler. Bu kimlik, kendisini ayarlayan Chat uygulamasına özgüdür. Örneğin, birden fazla Chat uygulaması aynı mesaj dizisi anahtarını kullanarak bir mesaj oluşturursa mesajlar farklı mesaj dizilerinde yayınlanır. Bir kişi veya başka bir Chat uygulaması tarafından oluşturulan mesaj dizisinde yanıt vermek için bunun yerine mesaj dizisi |
İşlem Yanıtı
Bir Chat uygulamasının, yanıtının nasıl yayınlanacağını yapılandırmak için kullanabileceği parametreler.
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Yalnızca giriş. Chat uygulaması yanıtının türü. |
url |
Yalnızca giriş. Kullanıcıların kimliğinin doğrulanacağı veya yapılandırılacağı URL. (Yalnızca |
dialogAction |
Yalnızca giriş. İletişim kutusu ile ilgili bir etkinliğe verilen yanıt. |
Yanıt Türü
Chat uygulaması yanıtının türü.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
NEW_MESSAGE olarak işlenen varsayılan tür. |
NEW_MESSAGE |
Konuda yeni bir mesaj olarak yayınla. |
UPDATE_MESSAGE |
Chat uygulamasının mesajını güncelleyin. Buna yalnızca iletiyi gönderen türü BOT olan CARD_CLICKED etkinliklerinde izin verilir. |
UPDATE_USER_MESSAGE_CARDS |
Kullanıcının mesajındaki kartları güncelleyin. Buna yalnızca, eşleşen URL'ye sahip bir MESSAGE etkinliğine veya iletiyi gönderen türünün HUMAN olduğu bir CARD_CLICKED etkinliğine yanıt olarak izin verilir. Metin yoksayılır. |
REQUEST_CONFIG |
Kullanıcıdan gizli olarak ek kimlik doğrulama veya yapılandırma isteyin. |
DIALOG |
Bir iletişim kutusu sunar. |
İletişim Kutusu İşlemi
İletişim kutusu ve istek durum kodu içerir.
JSON gösterimi |
---|
{ "actionStatus": { object ( |
Alanlar | |
---|---|
actionStatus |
Yalnızca giriş. Bir iletişim kutusunu çağırma veya gönderme isteğinin durumu. Gerekirse kullanıcılara bir durum ve mesaj gösterir. Örneğin, hata veya başarılı olduğunda. |
Birlik alanı
|
|
dialog |
Yalnızca giriş. İstekle ilgili iletişim kutusu. |
Dialog
İletişim kutusunun kart gövdesini çevreleyen sarmalayıcı.
JSON gösterimi |
---|
{
"body": {
object ( |
Alanlar | |
---|---|
body |
Yalnızca giriş. İletişim kutusunun kalıcı biçimde oluşturulan gövdesi. Google Chat uygulamaları şu kart varlıklarını desteklemez: |
İşlem Durumu
Bir iletişim kutusunu çağırma veya gönderme isteğinin durumunu temsil eder.
JSON gösterimi |
---|
{
"statusCode": enum ( |
Alanlar | |
---|---|
statusCode |
Durum kodu. |
userFacingMessage |
Kullanıcılara isteklerinin durumu hakkında gönderilecek ileti. Politika ayarlanmadan bırakılırsa |
Kod
gRPC API'leri için standart hata kodları.
Bazen birden fazla hata kodu geçerli olabilir. Hizmetler, geçerli olan en spesifik hata kodunu döndürmelidir. Örneğin, her iki kod da geçerliyse FAILED_PRECONDITION
yerine OUT_OF_RANGE
tercih edin. Benzer şekilde, FAILED_PRECONDITION
yerine NOT_FOUND
veya ALREADY_EXISTS
tercih edilir.
Sıralamalar | |
---|---|
OK |
Hata değil, başarılı olduğunda döndürüldü. HTTP Eşleme: 200 Tamam |
CANCELLED |
İşlem, genellikle arayan tarafından iptal edildi. HTTP Eşleme: 499 İstemcisi İsteği Kapattı |
UNKNOWN |
Bilinmeyen hata. Örneğin, başka bir adres alanından alınan HTTP Eşleme: 500 Dahili Sunucu Hatası |
INVALID_ARGUMENT |
İstemci, geçersiz bir bağımsız değişken belirtti. Bunun HTTP Eşlemesi: 400 Hatalı İstek |
DEADLINE_EXCEEDED |
İşlem tamamlanamadan son tarih sona erdi. Sistemin durumunu değiştiren işlemlerde, işlem başarıyla tamamlanmış olsa bile bu hata döndürülebilir. Örneğin, bir sunucudan gelen başarılı bir yanıt, son tarihin sona ereceği kadar uzun bir süre gecikebilirdi. HTTP Eşlemesi: 504 Ağ Geçidi Zaman Aşımı |
NOT_FOUND |
İstenen bazı varlıklar (ör. dosya veya dizin) bulunamadı. Sunucu geliştiricileri için not: İstek, kademeli özellik sunumu veya belgelenmemiş izin verilenler listesi gibi bir kullanıcı sınıfının tamamı için reddedilirse HTTP Eşlemesi: 404 Bulunamadı |
ALREADY_EXISTS |
Bir istemcinin oluşturmaya çalıştığı varlık (ör. dosya veya dizin) zaten var. HTTP Eşlemesi: 409 Çakışması |
PERMISSION_DENIED |
Arayanın belirtilen işlemi yürütme izni yok. HTTP Eşlemesi: 403 Yasak |
UNAUTHENTICATED |
İstekte işlemle ilgili geçerli kimlik doğrulama bilgileri bulunmuyor. HTTP Eşleme: 401 Yetkilendirilmedi |
RESOURCE_EXHAUSTED |
Bir kaynak tükendi (kullanıcı başına kota doldu veya dosya sisteminin tamamında yer kalmadı). HTTP Eşlemesi: 429 Çok Fazla İstek Var |
FAILED_PRECONDITION |
Sistem, işlemin yürütülmesi için gereken durumda olmadığından işlem reddedildi. Örneğin, silinecek dizin boş değilse, dizin olmayan bir dizine rmdir işlemi uygulanıyor vb. Hizmet uygulayıcıları HTTP Eşlemesi: 400 Hatalı İstek |
ABORTED |
İşlem, genellikle sıralayıcı kontrolü hatası veya işlemin iptal edilmesi gibi bir eşzamanlılık sorunu nedeniyle iptal edilmiştir.
HTTP Eşlemesi: 409 Çakışması |
OUT_OF_RANGE |
İşlem, geçerli aralıktan sonraya doğru denendi. Örneğin, dosya sonunu arama veya okuma.
HTTP Eşlemesi: 400 Hatalı İstek |
UNIMPLEMENTED |
İşlem uygulanmadı veya bu hizmette desteklenmiyor/etkinleştirilmemiş. HTTP Eşleme: 501 Uygulanmadı |
INTERNAL |
Dahili hatalar. Bu, temel sistemin beklediği bazı sabitlerin bozulduğu anlamına gelir. Bu hata kodu ciddi hatalar için ayrılmıştır. HTTP Eşleme: 500 Dahili Sunucu Hatası |
UNAVAILABLE |
Hizmet şu anda kullanılamıyor. Bu büyük olasılıkla geçici bir durumdur ve geri alma işlemiyle yeniden denenerek düzeltilebilir. Etkin olmayan işlemleri yeniden denemenin her zaman güvenli olmadığını unutmayın.
HTTP Eşleme: 503 Hizmeti Kullanılamıyor |
DATA_LOSS |
Kurtarılamaz veri kaybı veya bozulması. HTTP Eşleme: 500 Dahili Sunucu Hatası |
Eğik çizgi komutu
Google Chat'te eğik çizgi komutu.
JSON gösterimi |
---|
{ "commandId": string } |
Alanlar | |
---|---|
commandId |
Çağrılan eğik çizgi komutunun kimliği. |
Eşleşen URL
Chat mesajında eşleşen bir URL. Chat uygulamaları, eşleşen URL'leri önizleyebilir. Daha fazla bilgi için Bağlantıları önizleme başlıklı makaleyi inceleyin.
JSON gösterimi |
---|
{ "url": string } |
Alanlar | |
---|---|
url |
Yalnızca çıkış. Eşleşen URL. |
EmojiReactionSummary
Bir mesaja belirli bir emojiyle tepki veren kullanıcı sayısı.
JSON gösterimi |
---|
{
"emoji": {
object ( |
Alanlar | |
---|---|
emoji |
Tepkilerle ilişkilendirilen emoji. |
reactionCount |
İlişkili emojinin kullanıldığı toplam tepki sayısı. |
Meta Verileri Silme
Silinen bir mesajla ilgili bilgiler. deleteTime
ayarlandığında bir mesaj silinir.
JSON gösterimi |
---|
{
"deletionType": enum ( |
Alanlar | |
---|---|
deletionType |
İletiyi kimin sildiğini belirtir. |
Silme Türü
Mesajı kimlerin sildiği ve nasıl silindiği.
Sıralamalar | |
---|---|
DELETION_TYPE_UNSPECIFIED |
Bu değer kullanılmıyor. |
CREATOR |
Kullanıcı kendi mesajını sildi. |
SPACE_OWNER |
Alan sahibi mesajı sildi. |
ADMIN |
Bir Google Workspace yöneticisi mesajı sildi. |
APP_MESSAGE_EXPIRY |
Bir Chat uygulaması, süresi dolduğunda kendi mesajını sildi. |
CREATOR_VIA_APP |
Bir Chat uygulaması, mesajı kullanıcı adına sildi. |
SPACE_OWNER_VIA_APP |
Bir Chat uygulaması, alan sahibi adına mesajı sildi. |
AlıntıMesajMeta Verisi
Alıntı yapılan mesaj hakkında bilgiler.
JSON gösterimi |
---|
{ "name": string, "lastUpdateTime": string } |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Alıntı yapılan mesajın kaynak adı. Biçim: |
lastUpdateTime |
Yalnızca çıkış. Alıntı yapılan mesajın oluşturulduğu veya alıntılanan mesajın en son güncellendiği zaman damgası. |
EkliGif
Bir URL ile belirtilen GIF resmi.
JSON gösterimi |
---|
{ "uri": string } |
Alanlar | |
---|---|
uri |
Yalnızca çıkış. GIF resmini barındıran URL. |
Yöntemler |
|
---|---|
|
Google Chat alanında mesaj oluşturur. |
|
Mesajı siler. |
|
Bir iletiyle ilgili ayrıntıları döndürür. |
|
Engellenen üyeler ve alanlardan gelen mesajlar da dahil olmak üzere arayanın üyesi olduğu alandaki mesajları listeler. |
|
Bir mesajı günceller. |
|
Bir mesajı günceller. |