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ı. İletinin kaynak adı.

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

Burada {space}, mesajın yayınlandığı alanın kimliği, {message} ise mesaj için sisteme atanmış bir kimliktir. Örneğin, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

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

object (User)

Yalnızca çıkış. Mesajı oluşturan kullanıcı. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa çıkışta user name ve type alanları doldurulur.
createTime

string (Timestamp format)

İsteğe bağlıdır. Değişmez. Chat'te oluşturulan alanlarda, mesajın oluşturulduğu zaman. Bu alan, içe aktarma modu alanlarında kullanılması dışında yalnızca çıkış olarak kullanılır.

İçe aktarma modu alanlarında, orijinal oluşturma zamanını korumak için bu alanı, iletinin kaynakta oluşturulduğu geçmiş zaman damgası olarak ayarlayın.
lastUpdateTime

string (Timestamp format)

Yalnızca çıkış. Mesajın bir kullanıcı tarafından en son düzenlendiği zaman. Mesaj hiç düzenlenmediyse bu alan boştur.
deleteTime

string (Timestamp format)

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

string

İsteğe bağlıdır. İletinin düz metin gövdesi. Resim, video veya web sayfasına yönelik ilk bağlantı önizleme çipi oluşturur. Ayrıca Google Chat kullanıcısından veya alandaki herkesten@bahsedebilirsiniz.

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 iletmek için eklenen işaretlemelerle birlikte text mesajını içerir. Bu alan, kullanıcı arayüzünde görünen tüm biçimlendirmeyi 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 biçimlendirme söz dizimi.

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

  • İlk dize URL, ikinci dize ise oluşturulan metin olacak şekilde <{url}|{rendered_text}> biçiminde özel köprüler (ör. <http://example.com|custom text>).

  • :{emojiName}: biçiminde özel emoji (ör. :smile:) Bu durum, Unicode emojileri (ör. 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 politikasını kullanın.

Biçimlendirilmiş metinler, düğmeler ve tıklanabilir resimler gibi kullanıcı arayüzü öğelerini göstermek için kullanabileceğiniz zengin, biçimlendirilmiş ve etkileşimli kartlar. Kartlar genellikle iletinin düz metin gövdesinin altında gösterilir. cards ve cardsV2 en fazla 32 KB olabilir.
cardsV2[]

object (CardWithId)

İsteğe bağlıdır. Kartlar dizisi.

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

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

Kart Oluşturucu ile kart tasarlama ve önizleme

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. Kullanım örneği 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ı yapıyorsa çıkışta yalnızca alan name doldurulur.
fallbackText

string

İsteğe bağlıdır. İletinin kartlarının düz metin açıklaması. Gerçek kartlar görüntülenemediğinde (ör. mobil bildirimler) kullanılır.
actionResponse

object (ActionResponse)

Yalnızca giriş. 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ı bahsetmelerinin çıkarıldığı, iletinin düz metin gövdesi.
slashCommand

object (SlashCommand)

Yalnızca çıkış. Eğik çizgi komutu bilgileri (varsa)
attachment[]

object (Attachment)

İsteğe bağlıdır. 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 Bağlantıları önizleme başlıklı makaleyi inceleyin.
threadReply

boolean

Yalnızca çıkış. true olduğunda, ileti bir yanıt dizisindeki yanıttır. false olduğunda ileti, alandaki üst düzey görüşmede bir mesaj dizisinin ilk iletisi veya mesaj dizisi yanıtı içermeyen bir ileti olarak görünür.

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

string

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

object (EmojiReactionSummary)

Yalnızca çıkış. Mesajdaki emoji tepkilerinin özet listesi.
privateMessageViewer

object (User)

İsteğe bağlıdır. Değişmez. Mesaj oluşturmak için giriş, aksi takdirde yalnızca çıkış. Mesajı görüntüleyebilen kullanıcı. Bu alan ayarlandığında mesaj özel olur ve yalnızca belirtilen kullanıcı ile Chat uygulaması tarafından görülebilir. Bu alanı isteğinize eklemek için Chat API'yi uygulama kimlik doğrulaması kullanarak çağırmalı ve aşağıdakileri atlamalısınız:

Ayrıntılı bilgi için Özel mesaj gönderme başlıklı makaleyi inceleyin.
deletionMetadata

object (DeletionMetadata)

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

object (QuotedMessageMetadata)

Yalnızca çıkış. Google Chat kullanıcısı tarafından bir alanda alıntılanan mesajla ilgili bilgiler. Google Chat kullanıcıları, yanıtlamak için bir mesajı alıntılayabilir.
attachedGifs[]

object (AttachedGif)

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

object (AccessoryWidget)

İsteğe bağlıdır. İletinin en altında görünen bir veya daha fazla etkileşimli widget. Metin, kart veya hem metin hem de kart içeren mesajlara aksesuar widget'ları ekleyebilirsiniz. Diyalog içeren iletilerde desteklenmez. Ayrıntılar için İletinin en altı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 kart.

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

Kart Oluşturucu ile kart tasarlama ve önizleme

Kart Oluşturucu'yu açma

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

string

İleti birden fazla kart içeriyorsa zorunludur. İletideki bir kartın benzersiz tanımlayıcısı.
card

object (Card)

Kart. Maksimum boyut 32 KB'tır.

Not

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

Örnek düz metin ileti gövdesi:

Hello @FooBot how are you!"

İlgili ek açıklamalar 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)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // 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çıklamanın karşılık geldiği düz metin ileti gövdesindeki alt dizenin uzunluğu.
startIndex

integer

Bu açıklamanın karşılık geldiği düz metin ileti gövdesindeki başlangıç dizini (0 tabanlı, dahil).
Birleştirme alanı metadata. Ek açıklama hakkında ek meta veriler. metadata yalnızca aşağıdakilerden biri olabilir:
userMention

object (UserMentionMetadata)

Kullanıcı bahsetme meta verileri.
slashCommand

object (SlashCommandMetadata)

Eğik çizgi komutunun meta verileri.
customEmojiMetadata

object (CustomEmojiMetadata)

Özel emojinin 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 bahsedildiğinde
SLASH_COMMAND Bir eğik çizgi komutu çağrıldığında
CUSTOM_EMOJI Özel emoji ek açıklaması.

UserMentionMetadata

Kullanıcı bahsetmeleri (@) 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ı bahsetme 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)

Komutu çağrılan 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 iletişim kutusu için olup olmadığını gösterir.

Tür

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

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 yalnızca aşağıdakilerden biri olabilir:

RichLinkType

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

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

DriveLinkData

Google Drive bağlantılarının verileri.

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

object (DriveDataRef)

Google Drive dosyasına referans veren bir 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 mesaj dizisi.

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

string

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

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

CustomEmojiMetadata

Özel emoji'ler için açıklama meta verileri.

JSON gösterimi 
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
Alanlar
customEmoji

object (CustomEmoji)

Özel emoji

İplik

Google Chat alanındaki bir ileti dizisi. Kullanım örneği için Mesaj dizisi başlatma veya yanıtlama başlıklı makaleyi inceleyin.

İ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ı. İş parçacığının kaynak adı.

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

string

İsteğe bağlıdır. İş parçacığı 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 özeldir. Örneğin, birden fazla sohbet uygulaması aynı ileti dizisi anahtarını kullanarak ileti oluşturursa iletiler farklı ileti dizilerinde yayınlanır. Bir kişi veya başka bir Chat uygulaması tarafından oluşturulan mesaj dizilerinde yanıt vermek için bunun yerine mesaj dizisi name alanını belirtin.

ActionResponse

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 kimlik doğrulaması yapacağı veya yapılandıracağı URL. (Yalnızca REQUEST_CONFIG yanıt türleri için geçerlidir.)
dialogAction

object (DialogAction)

Yalnızca giriş. İletişim kutusu 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ınlayın.
UPDATE_MESSAGE Chat uygulamasının mesajını güncelleyin. Bu yalnızca, mesaj gönderen türünün BOT olduğu bir CARD_CLICKED etkinliğinde izin verilir.
UPDATE_USER_MESSAGE_CARDS Kullanıcının iletisindeki kartları güncelleyin. Bu yalnızca eşleşen 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 ek kimlik doğrulama veya yapılandırma yapmasını özel olarak isteme
DIALOG İletişim kutusu gösterir.
UPDATE_WIDGET Widget metni 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ş. Diyalog çağırma veya gönderme isteğinin durumu. Gerekirse kullanıcılara bir durum ve mesaj gösterir. Örneğin, hata veya başarı durumunda.
Birleştirme alanı action. Gerçekleştirilecek işlem. action yalnızca aşağıdakilerden biri olabilir:
dialog

object (Dialog)

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

Dialog

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

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

object (Card)

Yalnızca giriş. İletişim kutusunun gövdesi, modal olarak oluşturulur. Google Chat uygulamaları şu kart öğelerini desteklemez: DateTimePicker, OnChangeAction.

ActionStatus

Bir diyalogu çağırma veya gönderme isteğinin durumunu gösterir.

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 temel alınarak genel bir ileti gönderilir.

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 kodunu tercih edin. Benzer şekilde, FAILED_PRECONDITION yerine NOT_FOUND veya ALREADY_EXISTS tercih edin.

Sıralamalar
OK

Hata değildir, başarıyla 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 ait olduğunda bu hata döndürülebilir. Ayrıca, yeterli hata bilgisi döndürmeyen API'lerin oluşturduğu 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'dan 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ş bir dosya adı) gösterir.

HTTP Eşleme: 400 Hatalı İstek
DEADLINE_EXCEEDED

İşlem tamamlanmadan son tarih geçti. 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 kullanma tarihinin geçmesine yetecek kadar uzun süre gecikmiş olabilir.

HTTP Eşleme: 504 Gateway Timeout
NOT_FOUND

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

Sunucu geliştiricilerine not: Bir istek, kademeli özellik kullanıma sunma veya belgelenmemiş izin verilenler listesi gibi tüm kullanıcı sınıfı için reddedilirse NOT_FOUND kullanılabilir. Kullanıcı tabanlı erişim kontrolü gibi bir kullanıcı sınıfındaki bazı kullanıcıların isteği reddedilirse PERMISSION_DENIED kullanılmalıdır.

HTTP Eşlemesi: 404 Not Found
ALREADY_EXISTS

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

HTTP eşleme: 409 Çakışma
PERMISSION_DENIED

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

HTTP Eşlemesi: 403 Yasaklandı
UNAUTHENTICATED

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

HTTP Eşlemesi: 401 Yetkisiz
RESOURCE_EXHAUSTED

Kullanıcı başına kota veya dosya sisteminin tamamında yer kalmaması gibi bir kaynak tükenmiş olabilir.

HTTP Eşleme: 429 Çok Fazla İstek Var
FAILED_PRECONDITION

Sistem, işlemin yürütülmesi için gerekli durumda olmadığından işlem reddedildi. Örneğin, silinecek dizin boş değilse, dizin olmayan bir öğeye rmdir işlemi uygulanıyorsa 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 olan aramayı yeniden deneyebiliyorsa UNAVAILABLE kullanın. (b) İstemcinin daha yüksek bir düzeyde yeniden denemesi gerekiyorsa ABORTED kullanın. Örneğin, istemci tarafından belirtilen bir test ve ayarlama işlemi başarısız olduğunda istemcinin bir okuma-değiştirme-yazma dizisini yeniden başlatması gerektiğini belirtir. (c) Sistem durumu açıkça düzeltilene kadar istemcinin yeniden denememesi gerekiyorsa FAILED_PRECONDITION kullanın. Örneğin, bir "rmdir" işlemi dizin boş olmadığı için başarısız olursa istemci, dosyalar dizinden silinmediği sürece yeniden denememelidir. Bu nedenle 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 eşzamanlılık sorunu nedeniyle iptal edildi.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar vermek için yukarıdaki kuralları inceleyin.

HTTP eşleme: 409 Çakışma
OUT_OF_RANGE

İşlem, geçerli aralığın dışında denenmiş. Örneğin, dosya sonunun ötesinde arama yapma veya okuma

INVALID_ARGUMENT hatasının aksine bu hata, sistem durumu değiştiğinde düzeltilebilecek bir sorunu gösterir. Örneğin, [0,2^32-1] aralığında olmayan bir ofsetten okuması istendiğinde 32 bitlik bir dosya sistemi INVALID_ARGUMENT oluşturur ancak mevcut dosya boyutunu aşan bir ofsetten okuması istendiğinde OUT_OF_RANGE oluşturur.

FAILED_PRECONDITION ile OUT_OF_RANGE arasında önemli bir örtüşme var. Bir alan üzerinde yineleme yapan arayanların, işleri bittiğinde bunu tespit etmek için OUT_OF_RANGE hatasını kolayca arayabilmesi amacıyla geçerli olduğunda OUT_OF_RANGE (daha spesifik olan hata) kullanılmasını öneririz.

HTTP Eşleme: 400 Hatalı İstek
UNIMPLEMENTED

İşlem uygulanmamıştır veya bu hizmette desteklenmiyor/etkinleştirilmemiştir.

HTTP Eşleme: 501 Uygulanmadı
INTERNAL

Dahili hatalar. Bu, temel sistemin beklediği bazı değişmezlerin 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 çekilme ile yeniden denenerek düzeltilebilir. İdempotent olmayan işlemleri yeniden denemenin her zaman güvenli olmadığını unutmayın.

FAILED_PRECONDITION, ABORTED ve UNAVAILABLE arasında karar vermek için yukarıdaki kuralları inceleyin.

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ı için çoklu seçim menüsünde 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 yalnızca aşağıdakilerden 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)

SelectionItem nesneleri dizisi.

SlashCommand

Google Chat'teki eğik çizgiyle başlayan komutlar hakkında meta veriler.

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

string (int64 format)

Eğik çizgi komutunun kimliği.

MatchedUrl

Chat mesajında eşleşen bir URL. Sohbet 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 mesaja belirli bir emoji ile 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 emoji.
reactionCount

integer

Yalnızca çıkış. İlişkili emoji kullanılarak verilen toplam tepki sayısı.

DeletionMetadata

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

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

enum (DeletionType)

Mesajı kimin sildiğini gösterir.

DeletionType

İletiyi kimin ve nasıl sildiği Gelecekte daha fazla değer eklenebilir. Mesajların ne zaman silinebileceği hakkında ayrıntılı bilgi için Google Chat'te mesaj düzenleme veya silme başlıklı makaleyi inceleyin.

Sıralamalar
DELETION_TYPE_UNSPECIFIED Bu değer kullanılmıyor.
CREATOR Kullanıcı kendi mesajını silmiştir.
SPACE_OWNER Bir alan yöneticisi mesajı sildi.
ADMIN Bir Google Workspace yöneticisi mesajı sildi. Yöneticiler, alan üyeleri veya Chat uygulaması tarafından gönderilen mesajlar da dahil olmak üzere alandaki tüm mesajları silebilir.
APP_MESSAGE_EXPIRY Bir Chat uygulaması, süresi dolduğunda kendi mesajını sildi.
CREATOR_VIA_APP Bir Chat uygulaması, mesajı içerik üretici adına (kullanıcı kimlik doğrulamasını kullanarak) sildi.
SPACE_OWNER_VIA_APP Bir Chat uygulaması, alan yöneticisi adına (kullanıcı kimlik doğrulaması kullanarak) mesajı sildi.
SPACE_MEMBER Mesaj, alanın bir üyesi tarafından silindi. Kullanıcılar, uygulamalar tarafından gönderilen mesajları silebilir.

QuotedMessageMetadata

Alıntılanan iletiyle ilgili bilgiler.

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

string

Yalnızca çıkış. Alıntılanan iletinin 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

İletinin en altında görünen bir veya daha fazla etkileşimli widget. Ayrıntılar için İletinin en altına etkileşimli widget'lar 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
Birleştirme 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

 Mesajları siler.

get

 Bir iletiyle 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.