REST Resource: spaces.messages

Kaynak: Mesaj

Google Chat alanında 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

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ış. Mesajı oluşturan kullanıcı. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa kullanıcı name ve type alanlarını doldurur.

createTime

string (Timestamp format)

İsteğe bağlı. Sabit. 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 modundaki 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

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ış. Mesajın Google Chat'te silindiği saat. Mesaj hiçbir zaman silinmezse bu alan boş bırakılır.

text

string

İletinin düz metin gövdesi. Bir resme, videoya veya web sayfasına giden ilk bağlantı bir önizleme çipi oluşturur. Ayrıca, bir 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 işaretleme söz dizimi.

  • <users/{user}> biçimi kullanılarak kullanıcıdan bahsediliyor.

  • İlk dizenin URL ve ikincisi 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, sırıtan yüz emojisi için U+1F600 gibi Unicode emojileri 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 iletinin düz metin gövdesinin altında görüntülenir. cards ve cardsV2 öğelerinin boyutu en fazla 32 KB olabilir.

cardsV2[]

object (CardWithId)

Kartlar dizisi.

Yalnızca Chat uygulamaları kart oluşturabilir. Chat uygulamanızın kullanıcı olarak kimliği doğrulanıyorsa mesajlar kart içeremez.

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

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

Kart Oluşturucu'yu açın

annotations[]

object (Annotation)

Yalnızca çıkış. Bu iletide text ile ilişkili notlar.

thread

object (Thread)

İletinin ait olduğu ileti dizisi. Kullanım örnekleri için İleti dizisi başlatma veya yanıtlama başlıklı makaleye bakın.

space

object (Space)

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

fallbackText

string

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ış. Chat uygulamasında bahsedilen tüm kısımların çıkarıldığı, düz metin mesajının gövdesi.

slashCommand

object (SlashCommand)

Yalnızca çıkış. Varsa Slash komutu bilgileri.

attachment[]

object (Attachment)

Kullanıcı tarafından yüklenen ek.

matchedUrl

object (MatchedUrl)

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

threadReply

boolean

Yalnızca çıkış. true olduğunda ileti, yanıt ileti dizisinde bir yanıttır. false itibarıyla mesaj, alanın üst düzey görüşmesinde, mesaj dizisinin ilk mesajı veya mesaj dizisi halinde yanıt içermeyen 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ı. Mesaj için özel bir kimlik. Alanı, bir mesajı tanımlamak ya da bir mesajı almak, silmek veya güncellemek için kullanabilirsiniz. Özel bir 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ış. İletideki emoji tepki özetlerinin listesi.

privateMessageViewer

object (User)

Sabit. Mesaj oluşturmak için giriş, aksi takdirde yalnızca çıkış içindir. Mesajı görüntüleyebilen kullanıcı. Ayarlandığında mesaj gizli olur ve yalnızca belirtilen kullanıcı ile 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ılar için Özel olarak mesaj gönderme başlıklı makaleyi inceleyin.

deletionMetadata

object (DeletionMetadata)

Yalnızca çıkış. Silinen bir iletiyle ilgili bilgiler. deleteTime ayarlandığında bir 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)

Bir iletinin alt kısmı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ıyla mesaj oluşturmak için uygulama kimlik doğrulaması gerekir.

CardWithId

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.

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

Kart Oluşturucu'yu açın

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

string

Mesajda birden fazla kart varsa 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.

Ö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 (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 gelen düz metin ileti gövdesinde başlangıç dizini (0 tabanlı, dahil).

Birleştirme alanı metadata. Ek açıklamayla ilgili ek meta veriler. metadata şunlardan yalnızca biri olabilir:
userMention

object (UserMentionMetadata)

Kullanıcıdan bahsetmeyle ilgili meta veriler.

slashCommand

object (SlashCommandMetadata)

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.

UserMentionMetadata

Kullanıcı bahisleri 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 bahsettiği 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 Alanda kullanıcıdan bahsedin.

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

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ı türü.
CHAT_SPACE Chat alanı zengin bağlantı 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 mesaj 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 messageReplyOption alanını, eşleşen bir ileti dizisi bulunamadığında ne olacağını belirlemek için ayarlayabilirsiniz.

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

string

İleti dizisinin kaynak adı.

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

threadKey

string

İsteğe bağlı. İleti dizisi oluşturma veya güncelleme girişi. Aksi takdirde yalnızca çıkış kullanılır. İleti dizisinin kimliği. 4.000 karaktere kadar destekler.

Bu kimlik, onu ayarlayan Chat uygulamasına özgüdür. Örneğin, birden fazla Chat uygulaması aynı mesaj dizisi anahtarını kullanarak 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 dizisinde yanıt vermek 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ürü için.)

dialogAction

object (DialogAction)

Yalnızca giriş. Bir iletişim kutusuyla ilgili etkileşim etkinliğine verilen yanıt. ResponseType.Dialog eşlik etmelidir.

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. Bu eyleme yalnızca iletiyi gönderen türünün BOT olduğu CARD_CLICKED etkinliklerinde izin verilir.
UPDATE_USER_MESSAGE_CARDS Bir kullanıcının mesajındaki kartları güncelleyin. Bu eyleme yalnızca eşleşen URL'ye sahip bir MESSAGE etkinliğine veya ileti 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 isteğini gizli olarak isteyin.
DIALOG İletişim kutusu gösterir.
UPDATE_WIDGET Widget metin otomatik tamamlama seçenekleri sorgusu.

DialogAction

Bir iletiş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ş. Bir iletişim kutusunu çağırmak veya göndermek için isteğin durumu. Gerekirse kullanıcılara bir durum ve mesaj görüntüler. Örneğin, hata veya başarı durumunda.

Birleştirme alanı action. Gerçekleştirilecek işlem. action şunlardan yalnızca biri olabilir:
dialog

object (Dialog)

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

Dialog

İletişim kutusunun kart gövdesinin etrafında sarmalayıcı.

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

object (Card)

Yalnızca giriş. İletişim kutusunun, kalıcı olarak oluşturulan gövdesi. Google Chat uygulamaları şu kart varlıklarını desteklemez: DateTimePicker, OnChangeAction.

ActionStatus

Bir iletişim kutusunu çağırmak veya göndermek için isteğin 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önderilen mesaj. Politika ayarlanmazsa statusCode temel alınarak 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 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ı bir sonuç elde edildi.

HTTP Eşleme: 200 Tamam

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 Status değeri, bu adres alanında bilinmeyen bir hata alanına ait olduğunda 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 değerinden farklı olduğunu unutmayın. INVALID_ARGUMENT, sistemin durumundan bağımsız olarak sorunlu olan bağımsız değişkenleri gösterir (ör. hatalı biçimlendirilmiş dosya adı).

HTTP Eşleme: 400 Hatalı İstek

DEADLINE_EXCEEDED

Son tarih işlem tamamlanmadan 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 dolmasına yetecek kadar gecikmiş olabilir.

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

NOT_FOUND

İstenen bazı varlıklar (ör. dosya veya dizin) bulunamadı.

Sunucu geliştiricilere not: Özelliklerin kademeli olarak kullanıma sunulması veya belgelenmemiş izin verilenler listesi gibi bir istek tüm kullanıcı sınıfı için reddedilirse NOT_FOUND kullanılabilir. Bir kullanıcı sınıfındaki bazı kullanıcılar için istek reddedilirse (kullanıcı tabanlı erişim denetimi gibi) 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ın belirtilen işlemi yürütme 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 kişi tanımlanamıyorsa PERMISSION_DENIED kullanılmamalıdır (bu hatalar için bunun yerine UNAUTHENTICATED kullanın). Bu hata kodu, isteğin geçerli olduğunu, istenen varlığın var olduğunu veya başka ön koşulları karşıladığını ima etmez.

HTTP Eşleme: 403 Yasak

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, yürütülmesi için gereken durumda olmadığından işlem reddedildi. Örneğin, silinecek dizin boş değil, dizin olmayan bir dizine bir rmdir işlemi uygulanır vb.

Hizmeti 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 çağrıyı yeniden deneyebiliyorsa UNAVAILABLE kullanın. (b) İstemcinin daha üst düzeyde yeniden denemesi gerekiyorsa ABORTED öğesini kullanın. Örneğin, istemci tarafından belirtilen bir test ve set işlemi başarısız olduğunda istemcinin oku değiştir ve yazma sırasını 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" başarısız olur. Bunun nedeni, dizin boş olmamasıdır. Dosyalar dizinden silinmediği sürece istemcinin işlemi 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ından karar vermek için yukarıdaki yönergelere bakın.

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

OUT_OF_RANGE

İşlem, geçerli aralığın dışına çıkmaya çalışıldı. Ör. dosya sonunu arama veya okuma.

INVALID_ARGUMENT işlevinin 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 biraz örtüşme var. Bir alanda yineleme yapan arayanların, işlerini bitirdiklerini algılamak için kolayca OUT_OF_RANGE hatası arayabilmeleri amacıyla, geçerli olduğunda OUT_OF_RANGE (daha spesifik hata) kullanmanızı öneririz.

HTTP Eşleme: 400 Hatalı İstek

UNIMPLEMENTED

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

HTTP Eşleme: 501 Uygulanmadı

INTERNAL

Dahili hatalar. Bu da temel sistemin beklediği bazı sabit değerlerin 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çici bir durumdur ve geri alma işlemiyle tekrar denenerek 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

Güncellenen widget'ın yanıtı. Bir widget için otomatik tamamlama seçenekleri sağlamak üzere kullanılı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'la 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 Önizleme bağlantıları konusuna bakın.

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

string

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

EmojiReactionSummary

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

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

object (Emoji)

Tepkilerle ilişkili emoji.

reactionCount

integer

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

DeletionMetadata

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

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

enum (DeletionType)

İletiyi kimin sildiğini belirtir.

DeletionType

Mesajı kimin 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.

QuotedMessageMetadata

Alıntılanan bir mesajla ilgili bilgiler.

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 alıntılanan mesajın 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 iletinin alt kısmında görünen bir veya daha fazla etkileşimli widget. Ayrıntılı bilgi için İletinin alt kısmı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 şunlardan yalnızca biri olabilir:
buttonList

object (ButtonList)

Düğme listesi.

Yöntemler

create

Google Chat alanında mesaj oluşturur.

delete

Bir iletiyi siler.

get

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

list

Engellenen üyeler ve alanlardan gelen mesajlar da dahil olmak üzere, arayanın üyesi olduğu bir alandaki mesajları listeler.

patch

Bir mesajı günceller.

update

Bir mesajı günceller.