REST Resource: spaces.messages

Kaynak: Mesaj

Google Chat alanındaki bir mesaj.

JSON gösterimi 
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
Alanlar
name

string

Tanımlayıcı. Mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}

Burada {space} iletinin yayınlandığı alanın kimliğidir. {message} ise ileti için sistem tarafından atanan kimliktir. Örneğin, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Mesaj oluştururken özel bir kimlik ayarlarsanız {message} değerini clientAssignedMessageId alanındaki değerle değiştirerek bir istekteki mesajı belirtmek için bu kimliği kullanabilirsiniz. Örneğin, spaces/AAAAAAAAAAA/messages/client-custom-name. Ayrıntılar için Mesajı adlandırma başlıklı makaleyi inceleyin.
sender

object (User)

Yalnızca çıkış. İletiyi oluşturan kullanıcı. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkışta kullanıcı name ve type alanları doldurulur.
createTime

string (Timestamp format)

İsteğe bağlı. Değişmez. Chat'te oluşturulan alanlar için mesajın oluşturulduğu saat. Bu alan, içe aktarma modundaki alanlarda kullanılmadığı durumlar dışında yalnızca çıkış olarak oluşturulur.

İçe aktarma modu alanları için bu alanı, orijinal oluşturulma zamanını korumak amacıyla ileti kaynağında oluşturulduğu tarihsel zaman damgasına ayarlayın.
lastUpdateTime

string (Timestamp format)

Yalnızca çıkış. Mesajın bir kullanıcı tarafından son düzenlendiği zaman. Mesaj hiç düzenlenmemişse bu alan boş bırakılır.
deleteTime

string (Timestamp format)

Yalnızca çıkış. İletinin Google Chat'te silindiği zaman. Mesaj hiç silinmezse bu alan boş olur.
text

string

İsteğe bağlı. İletinin düz metin gövdesi. Bir resme, videoya veya web sayfasına ait ilk bağlantı, önizleme çipi oluşturur. Ayrıca bir Google Chat kullanıcısını @bahsetme veya alandaki herkesi etiketleyebilirsiniz.

Kısa mesaj oluşturma hakkında bilgi edinmek için Mesaj gönderme başlıklı makaleyi inceleyin.
formattedText

string

Yalnızca çıkış. Biçimlendirmeyi belirtmek için eklenen işaretlemelerle text mesajını içerir. Bu alan, kullanıcı arayüzünde görünen tüm biçimlendirmeleri yakalamayabilir ancak aşağıdakileri içerir:

  • Kalın, italik, üstü çizili, tek aralıklı, tek aralıklı blok ve madde işaretli liste için işaretleme söz dizimi.

  • <users/{user}> biçimini kullanan kullanıcı bahsetmeleri.

  • İlk dizenin URL, ikincinin ise oluşturulan metin olduğu <{url}|{rendered_text}> biçimini kullanan özel köprüler (ör. <http://example.com|custom text>).

  • :{emojiName}: biçimini kullanan özel emoji (ör. :smile:). Bu durum, Unicode emojileri (ör. gülümseyen yüz emojisi için U+1F600) için geçerli değildir.

Daha fazla bilgi için İletide gönderilen metin biçimlendirmesini görüntüleme başlıklı makaleyi inceleyin.
cards[]
(deprecated)

object (Card)

Desteği sonlandırıldı: Bunun yerine cardsV2 kullanın.

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 ileti düz metin gövdesinin altında gösterilir. cards ve cardsV2 öğelerinin boyutu en fazla 32 KB olabilir.
cardsV2[]

object (CardWithId)

İsteğe bağlı. Kart dizisi.

Yalnızca Chat uygulamaları kart oluşturabilir. Sohbet uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa mesajlar kart içeremez.

Kart içeren bir mesaj oluşturmayı öğrenmek için Mesaj gönderme başlıklı makaleyi inceleyin.

Kart Oluşturucu ile kart tasarlayın ve önizleyin.

Kart Oluşturucu'yu açma
annotations[]

object (Annotation)

Yalnızca çıkış. Bu iletideki text ile ilişkili ek açıklamalar.
thread

object (Thread)

İletinin ait olduğu ileti dizisi. Örnek kullanım için Mesaj dizisi başlatma veya yanıtlama başlıklı makaleyi inceleyin.
space

object (Space)

Yalnızca çıkış. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkış yalnızca name alanını doldurur.
fallbackText

string

İsteğe bağlı. Mesaj kartlarının düz metin açıklamasıdır. Gerçek kartlar gösterilemediğinde (örneğin, mobil bildirimler) kullanılır.
actionResponse

object (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

string

Yalnızca çıkış. Tüm Chat uygulamasından bahsetmelerin kaldırıldığı, mesajın düz metin gövdesi.
slashCommand

object (SlashCommand)

Yalnızca çıkış. Varsa eğik çizgi komutu bilgileri.
attachment[]

object (Attachment)

İsteğe bağlı. Kullanıcı tarafından yüklenen ek.
matchedUrl

object (MatchedUrl)

Yalnızca çıkış. spaces.messages.text içinde, bağlantı önizleme kalıbıyla eşleşen bir URL. Daha fazla bilgi için Önizleme bağlantıları konusuna bakın.
threadReply

boolean

Yalnızca çıkış. true olduğunda mesaj, bir yanıt mesaj dizisindeki yanıttır. false olduğunda mesaj, alanın üst düzey görüşmesinde bir mesaj dizisinin ilk mesajı veya mesaj dizisi yanıtı olmayan bir mesaj olarak görünür.

Alan, mesaj dizilerinde yanıt vermeyi desteklemiyorsa bu alan her zaman false olur.
clientAssignedMessageId

string

İsteğe bağlı. İleti için özel bir kimlik. Bir iletiyi tanımlamak veya almak, silmek ya da güncellemek için bu alanı kullanabilirsiniz. Özel kimlik ayarlamak için mesajı oluştururken messageId alanını belirtin. Ayrıntılar için Mesajı adlandırma başlıklı makaleyi inceleyin.
emojiReactionSummaries[]

object (EmojiReactionSummary)

Yalnızca çıkış. Mesajdaki emoji tepki özetlerinin listesi.
privateMessageViewer

object (User)

İsteğe bağlı. Sabit. Mesaj oluşturmak için giriş, aksi takdirde yalnızca çıkış içindir. Mesajın görüntüleyebileceği kullanıcı. Ayarlandığında mesaj gizlidir ve yalnızca belirtilen kullanıcı ve Chat uygulaması tarafından görülebilir. Bu alanı isteğinize dahil etmek için uygulama kimlik doğrulamasını kullanarak Chat API'yi çağırmanız ve aşağıdakileri atlamanız gerekir:

Ayrıntılı bilgi için Mesajları gizli olarak gönderme başlıklı makaleyi inceleyin.
deletionMetadata

object (DeletionMetadata)

Yalnızca çıkış. Silinen bir mesajla ilgili bilgiler. deleteTime ayarlandığında mesaj silinir.
quotedMessageMetadata

object (QuotedMessageMetadata)

Yalnızca çıkış. Alandaki bir Google Chat kullanıcısı tarafından alıntılanan mesajla ilgili bilgiler. Google Chat kullanıcıları bir mesajı alıntılayarak yanıtlayabilir.
attachedGifs[]

object (AttachedGif)

Yalnızca çıkış. İletiye eklenen GIF resimler.
accessoryWidgets[]

object (AccessoryWidget)

İsteğe bağlı. Bir mesajın en altında görünen bir veya daha fazla etkileşimli widget. Metin, kart veya hem metin hem de kart içeren iletilere aksesuar widget'ları ekleyebilirsiniz. İletişim kutusu içeren iletiler için desteklenmez. Ayrıntılı bilgi için İletinin alt kısmına etkileşimli widget'lar ekleme başlıklı makaleyi inceleyin.

Aksesuar widget'ları içeren bir mesaj oluşturmak için uygulama kimlik doğrulaması gerekir.

CardWithId

Google Chat mesajındaki bir kart.

Yalnızca Chat uygulamaları kart oluşturabilir. Sohbet uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa mesaj kart içeremez.

Kart Oluşturucu ile kart tasarlayın ve önizleyin.

Kart Oluşturucu'yu açma

JSON gösterimi 
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Alanlar
cardId

string

Mesaj birden fazla kart içeriyorsa gereklidir. Bir mesajdaki kartın benzersiz tanımlayıcısıdır.
card

object (Card)

Kart. Maksimum boyut 32 KB'tır.

Ek Açıklama

Yalnızca çıkış. İletinin düz metin gövdesiyle ilişkili ek açıklamalar. Bir kısa mesaja temel biçimlendirme eklemek için Kısa mesajları biçimlendirme başlıklı makaleyi inceleyin.

Düz metin ileti gövdesi örneği:

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 (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  }
  // End of list of possible types for union field metadata.
}
Alanlar
type

enum (AnnotationType)

Bu ek açıklamanın türü.
length

integer

Bu ek açıklamaya karşılık gelen düz metin ileti gövdesindeki alt dizenin uzunluğu.
startIndex

integer

Bu ek açıklamanın karşılık geldiği düz metin mesaj gövdesinde başlangıç dizini (0 tabanlı, dahili).
Birlik alanı metadata. Ek açıklamayla ilgili ek meta veriler. metadata yalnızca aşağıdakilerden biri olabilir:
userMention

object (UserMentionMetadata)

Kullanıcının bahsedildiği meta veriler.
slashCommand

object (SlashCommandMetadata)

Eğik çizgi komutunun meta verileri.

AnnotationType

Ek açıklamanın türü.

Sıralamalar
ANNOTATION_TYPE_UNSPECIFIED Enum 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.

UserMentionMetadata

Kullanıcılardan bahsedilen (@) notlar için ek açıklama meta verileri.

JSON gösterimi 
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Alanlar
user

object (User)

Bahsedilen kullanıcı.
type

enum (Type)

Kullanıcının türü.

Tür

Sıralamalar
TYPE_UNSPECIFIED Enum için varsayılan değer. Kullanmayın.
ADD Kullanıcıyı alana ekleyin.
MENTION Alanda kullanıcıdan bahsetme.

SlashCommandMetadata

Eğik çizgi komutları (/) için ek açıklama meta verileri.

JSON gösterimi 
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Alanlar
bot

object (User)

Komutunun çağrıldığı Chat uygulaması.
type

enum (Type)

Eğik çizgi komutunun türü.
commandName

string

Çağrılan eğik çizgi komutunun adı.
commandId

string (int64 format)

Çağrılan eğik çizgi komutunun komut kimliği.
triggersDialog

boolean

Eğik çizgi komutunun bir iletişim kutusu için olup olmadığını belirtir.

Tür

Sıralamalar
TYPE_UNSPECIFIED Enum için varsayılan değer. Kullanmayın.
ADD Alana Chat uygulamasını ekleyin.
INVOKE Alanda eğik çizgi komutu çağırın.

RichLinkMetadata

Bir kaynağın zengin bağlantısı.

JSON gösterimi 
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  }
  // End of list of possible types for union field data.
}
Alanlar
uri

string

Bu bağlantının URI'si.
Birleştirme alanı data. Bağlı kaynağın verileri. data şunlardan yalnızca biri olabilir:

RichLinkType

Zengin bağlantı türü. Gelecekte daha fazla tür eklenebilir.

Sıralamalar
DRIVE_FILE Google Drive zengin bağlantısı türü.
CHAT_SPACE Chat alanı zengin bağlantısı türü. Örneğin, alan akıllı çipi.

DriveLinkData

Google Drive bağlantılarıyla ilgili veriler.

JSON gösterimi 
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Alanlar
driveDataRef

object (DriveDataRef)

Bir Google Drive dosyasına referans veren DriveDataRef.
mimeType

string

Bağlı Google Drive kaynağının MIME türü.

ChatSpaceLinkData

Chat alanı bağlantılarıyla ilgili veriler.

JSON gösterimi 
{
  "space": string,
  "thread": string,
  "message": string
}
Alanlar
space

string

Bağlı Chat alanı kaynağının alanı.

Biçim: spaces/{space}
thread

string

Bağlı Chat alanı kaynağının ileti dizisi.

Biçim: spaces/{space}/threads/{thread}
message

string

Bağlı Chat alanı kaynağının mesajı.

Biçim: spaces/{space}/messages/{message}

İleti dizisi

Google Chat alanındaki bir ileti dizisi. Kullanım örnekleri için İleti dizisi başlatma veya yanıtlama başlıklı makaleye bakın.

İleti oluştururken bir 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

string

Tanımlayıcı. İleti dizisinin kaynak adı.

Örnek: spaces/{space}/threads/{thread}
threadKey

string

İsteğe bağlı. Mesaj dizisi oluşturmak veya güncellemek için giriş. Aksi takdirde yalnızca çıkış. İleti dizisinin kimliği. En fazla 4.000 karakter desteklenir.

Bu kimlik, onu 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 kullanıcı veya başka bir Chat uygulaması tarafından oluşturulan bir mesaj dizisini yanıtlamak için bunun yerine mesaj dizisi name alanını belirtin.

ActionResponse

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 (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Alanlar
type

enum (ResponseType)

Yalnızca giriş. Chat uygulaması yanıtının türü.
url

string

Yalnızca giriş. Kullanıcıların kimliğini doğrulaması veya yapılandırması için URL. (Yalnızca REQUEST_CONFIG yanıt türleri için.)
dialogAction

object (DialogAction)

Yalnızca giriş. İletişim ile ilgili bir etkileşim etkinliğine verilen yanıt. ResponseType.Dialog ile birlikte gönderilmelidir.
updatedWidget

object (UpdatedWidget)

Yalnızca giriş. Güncellenen widget'ın yanıtı.

ResponseType

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 ileti olarak yayınla.
UPDATE_MESSAGE Chat uygulamasının mesajını güncelleyin. Buna yalnızca ileti gönderen türünün BOT olduğu bir CARD_CLICKED etkinliğinde izin verilir.
UPDATE_USER_MESSAGE_CARDS Kullanıcının mesajındaki kartları güncelleyin. Buna yalnızca eşleşen bir URL'ye sahip bir MESSAGE etkinliğine veya mesaj 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ğrulaması veya yapılandırma yapmasını isteyin.
DIALOG Bir iletişim kutusu gösterir.
UPDATE_WIDGET Widget metin otomatik tamamlama seçenekleri sorgusu.

DialogAction

İletişim kutusu ve istek durum kodu içerir.

JSON gösterimi 
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Alanlar
actionStatus

object (ActionStatus)

Yalnızca giriş. İletişim kutusu başlatma veya gönderme isteğinin durumu. Gerekirse kullanıcılara bir durum ve mesaj gösterir. Örneğin, hata veya başarı durumunda.
Birlik alanı action. Yapılacak işlem. action yalnızca aşağıdakilerden biri olabilir:
dialog

object (Dialog)

Yalnızca giriş. İstekle ilgili iletişim kutusu.

Dialog

İletişimin kart gövdesini saran sarmalayıcı.

JSON gösterimi 
{
  "body": {
    object (Card)
  }
}
Alanlar
body

object (Card)

Yalnızca giriş. Modüler olarak oluşturulan iletişim kutusunun gövdesi. Google Chat uygulamaları şu kart varlıklarını desteklemez: DateTimePicker, OnChangeAction.

ActionStatus

Bir iletişim kutusunu çağırma veya gönderme isteğinin durumunu temsil eder.

JSON gösterimi 
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Alanlar
statusCode

enum (Code)

Durum kodu.
userFacingMessage

string

Kullanıcılara isteklerinin durumu hakkında gönderilecek mesaj. Ayarlanmamışsa statusCode değerine dayalı genel bir mesaj gönderilir.

Kod

gRPC API'leri için standart hata kodları.

Bazen birden fazla hata kodu geçerli olabilir. Hizmetler, geçerli olan en belirgin hata kodunu döndürmelidir. Örneğin, her iki kod da geçerliyse OUT_OF_RANGE yerine FAILED_PRECONDITION'ü tercih edin. Benzer şekilde, FAILED_PRECONDITION yerine NOT_FOUND veya ALREADY_EXISTS'u tercih edin.

Sıralamalar
OK

Hata değildir, başarılı olduğunda döndürülür.

HTTP eşleme: 200 OK
CANCELLED

İşlem genellikle arayan tarafından iptal edildi.

HTTP eşleme: 499 İstemci İsteği Kapattı
UNKNOWN

Bilinmeyen hata. Örneğin, başka bir adres alanından alınan bir Status değeri bu adres alanında bilinmeyen bir hata alanına aitse bu hata döndürülebilir. Ayrıca API'ler tarafından ortaya çıkan ve yeterli hata bilgisi döndürmeyen hatalar da bu hataya dönüştürülebilir.

HTTP eşleme: 500 Dahili Sunucu Hatası
INVALID_ARGUMENT

İstemci, geçersiz bir bağımsız değişken belirtti. Bunun FAILED_PRECONDITION'ten farklı olduğunu unutmayın. INVALID_ARGUMENT, sistemin durumundan bağımsız olarak sorunlu olan bağımsız değişkenleri (ör. hatalı biçimlendirilmiş dosya adı) gösterir.

HTTP eşleme: 400 Hatalı İstek
DEADLINE_EXCEEDED

İşlem tamamlanmadan son tarih doldu. Sistemin durumunu değiştiren işlemler için, işlem başarıyla tamamlanmış olsa bile bu hata döndürülebilir. Örneğin, bir sunucudan gelen başarılı yanıt, son tarihin dolmasına yetecek kadar gecikmiş olabilir.

HTTP Eşleme: 504 Ağ Geçidi Zaman Aşımı
NOT_FOUND

İstenen bazı öğeler (ör. dosya veya dizin) bulunamadı.

Sunucu geliştiricileri için not: Bir istek, kullanıcı sınıfının tamamı için reddedilirse (ör. kademeli özellik kullanıma sunma veya belgelenmemiş izin verilenler listesi) NOT_FOUND kullanılabilir. Kullanıcı sınıfındaki bazı kullanıcılar için bir istek reddedilirse (ör. kullanıcı tabanlı erişim denetimi) PERMISSION_DENIED kullanılmalıdır.

HTTP Eşleme: 404 Bulunamadı
ALREADY_EXISTS

İstemcinin oluşturmaya çalıştığı varlık (ör. dosya veya dizin) zaten mevcut.

HTTP Eşleme: 409 Çakışması
PERMISSION_DENIED

Arayan kullanıcının belirtilen işlemi gerçekleştirme izni yok. PERMISSION_DENIED, bazı kaynakların tükenmesinden kaynaklanan retlerde kullanılmamalıdır (bu hatalar için RESOURCE_EXHAUSTED etiketini kullanın). Arayan tanımlanamıyorsa PERMISSION_DENIED kullanılmamalıdır (bu tür hatalar için bunun yerine UNAUTHENTICATED kullanın). Bu hata kodu, isteğin geçerli olduğu veya istenen öğenin var olduğu ya da diğer ön koşulları karşıladığı anlamına gelmez.

HTTP Eşleme: 403 Yasaklandı
UNAUTHENTICATED

İstekte işlemle ilgili geçerli kimlik doğrulama bilgileri bulunmuyor.

HTTP eşleme: 401 Yetkisiz
RESOURCE_EXHAUSTED

Kullanıcı başına kota gibi bazı kaynaklar tükendi veya dosya sisteminin tamamında boş alan kalmamış olabilir.

HTTP eşleme: 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, rmdir işlemi dizin olmayan bir yere uygulanırsa vb.

Hizmet uygulayıcıları, FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar vermek için aşağıdaki yönergeleri kullanabilir: (a) İstemci yalnızca başarısız aramayı yeniden deneyebiliyorsa UNAVAILABLE kullanın. (b) İstemcinin daha yüksek bir seviyede yeniden denemesi gerekiyorsa ABORTED kullanın. Örneğin, istemci tarafından belirtilen bir test ve ayarlama başarısız olduğunda, istemcinin bir okuma-değiştirme-yazma sırasını yeniden başlatması gerektiğini gösterir. (c) Sistem durumu açıkça düzeltilene kadar istemcinin yeniden denememesi gerekiyorsa FAILED_PRECONDITION değerini kullanın. Örneğin, dizin boş olmadığı için bir "rmdir" başarısız olursa, dosyalar dizinden silinmediği sürece istemcinin yeniden denememesi gerektiği için FAILED_PRECONDITION döndürülmelidir.

HTTP eşleme: 400 Hatalı İstek
ABORTED

İşlem, genellikle sıralayıcı kontrolü hatası veya işlem iptali gibi bir eşzamanlılık sorunu nedeniyle iptal edildi.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar vermek için yukarıdaki kurallara bakın.

HTTP Eşleme: 409 Çakışması
OUT_OF_RANGE

İşlem, geçerli aralık dışında gerçekleştirilmeye çalışıldı. Ör. dosya sonunu arama veya okuma.

INVALID_ARGUMENT hatasının aksine bu hata, sistem durumu değişirse düzeltilebilecek bir sorunu gösterir. Örneğin, 32 bitlik bir dosya sistemi [0,2^32-1] aralığında olmayan bir ofsetle okumanız istenirse INVALID_ARGUMENT oluşturur, ancak geçerli dosya boyutunu aşan bir ofsetten okuma yapılması istenirse OUT_OF_RANGE oluşturur.

FAILED_PRECONDITION ile OUT_OF_RANGE arasında oldukça fazla çakışma var. Uygun olduğunda OUT_OF_RANGE (daha spesifik hata) kullanmanızı öneririz. Böylece, bir alanda iterasyon yapan çağrıyı yapanlar, işlemin tamamlandığını algılamak için kolayca OUT_OF_RANGE hatası arayabilir.

HTTP eşleme: 400 Hatalı İstek
UNIMPLEMENTED

İşlem bu hizmette uygulanmıyor veya desteklenmiyor/etkinleştirilmiyor.

HTTP Eşleme: 501 Uygulanmadı
INTERNAL

Dahili hatalar. Bu, temel sistem tarafından beklenen bazı değişmez özelliklerin 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 durum büyük olasılıkla geçicidir ve geri çekilmeyle yeniden deneyerek düzeltilebilir. İhtiyati olmayan işlemleri yeniden denemenin her zaman güvenli olmadığını unutmayın.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasından karar vermek için yukarıdaki yönergelere bakın.

HTTP Eşleme: 503 Hizmet Kullanılamıyor
DATA_LOSS

Kurtarılamaz veri kaybı veya bozulması.

HTTP eşleme: 500 Dahili Sunucu Hatası

UpdatedWidget

selectionInput widget'larında, çoklu seçim menüsü için otomatik tamamlama önerilerini döndürür.

JSON gösterimi 
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
Alanlar
widget

string

Güncellenen widget'ın kimliği. Kimlik, güncelleme isteğini tetikleyen widget'ın kimliğiyle eşleşmelidir.
Birleştirme alanı updated_widget. Widget, kullanıcı işlemine yanıt olarak güncellendi. updated_widget şunlardan yalnızca biri olabilir:
suggestions

object (SelectionItems)

Widget otomatik tamamlama sonuçlarının listesi

SelectionItems

Widget otomatik tamamlama sonuçlarının listesi.

JSON gösterimi 
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Alanlar
items[]

object (SelectionItem)

Seçim Öğesi nesnelerinden oluşan bir dizi.

SlashCommand

Google Chat'te eğik çizgi komutu.

JSON gösterimi 
{
  "commandId": string
}
Alanlar
commandId

string (int64 format)

Çağrılan eğik çizgi komutunun kimliği.

MatchedUrl

Bir Chat mesajındaki eşleşen 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

string

Yalnızca çıkış. Eşleşen URL.

EmojiReactionSummary

Bir iletiye belirli bir emojiyle tepki veren kullanıcıların sayısı.

JSON gösterimi 
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Alanlar
emoji

object (Emoji)

Yalnızca çıkış. Tepkilerle ilişkili emojiler.
reactionCount

integer

Yalnızca çıkış. İlişkili emojilerin kullanıldığı toplam tepki sayısıdır.

DeletionMetadata

Silinen bir mesajla ilgili bilgiler. deleteTime ayarlandığında mesaj silinir.

JSON gösterimi 
{
  "deletionType": enum (DeletionType)
}
Alanlar
deletionType

enum (DeletionType)

Mesajı kimin sildiğini belirtir.

DeletionType

Mesajın kim tarafından ve nasıl silindiği. Gelecekte daha fazla değer eklenebilir.

Sıralamalar
DELETION_TYPE_UNSPECIFIED Bu değer kullanılmamaktadır.
CREATOR Kullanıcı kendi mesajını silmiştir.
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ı, mesajı alan sahibi adına sildi.

QuotedMessageMetadata

Alıntılanan bir ileti hakkında bilgi.

JSON gösterimi 
{
  "name": string,
  "lastUpdateTime": string
}
Alanlar
name

string

Yalnızca çıkış. Alıntılanan mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}
lastUpdateTime

string (Timestamp format)

Yalnızca çıkış. Alıntılanan mesajın oluşturulduğu veya en son güncellendiği zaman damgası.

AttachedGif

URL ile belirtilen bir GIF resmi.

JSON gösterimi 
{
  "uri": string
}
Alanlar
uri

string

Yalnızca çıkış. GIF resmini barındıran URL.

AccessoryWidget

Bir mesajın en altında görünen bir veya daha fazla etkileşimli widget. Ayrıntılar için Mesajın alt kısmına etkileşimli widget ekleme başlıklı makaleyi inceleyin.

JSON gösterimi 
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Alanlar
Birlik alanı action. İşlemin türü. action yalnızca aşağıdakilerden biri olabilir:
buttonList

object (ButtonList)

Düğme listesi.

Yöntemler

create

 Google Chat alanında mesaj oluşturur.

delete

 Bir iletiyi siler.

get

 Bir mesajla ilgili ayrıntıları döndürür.

list

 Arayanın üyesi olduğu bir alandaki mesajları (engellenen üyelerden ve alanlardan gelen mesajlar dahil) listeler.

patch

 Bir mesajı günceller.

update

 Bir mesajı günceller.