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}, mesajın yayınlandığı alanın kimliği, {message} ise mesaja 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 modu alanlarında kullanıldığında hariç olmak üzere yalnızca çıkış içindir.

İç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ış. Mesajın Google Chat'te silindiği saat. 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ı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 belirtmek için eklenen işaretlemelerle 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, monospace, monospace blok ve madde işaretli liste için işaretleme söz dizimi.

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

  • İ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)

İsteğe bağlı. Kart 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çma

annotations[]

object (Annotation)

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

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ı. Gerçek kartlar görüntülenemediğinde (ör. mobil bildirimler) kullanılan, mesajın kartlarının düz metin açıklaması.

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)

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

matchedUrl

object (MatchedUrl)

Yalnızca çıkış. spaces.messages.text ürününde 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 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.

Alanda mesaj dizilerinde yanıt verme özelliği desteklenmiyorsa bu alan her zaman false olur.

clientAssignedMessageId

string

İsteğe bağlı. İ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ış. İletideki emoji tepki özetlerinin listesi.

privateMessageViewer

object (User)

İsteğe bağlı. Değişmez. Mesaj oluşturmak için giriş, aksi takdirde yalnızca çıkış. 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 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)

İ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 mesajlara aksesuar widget'ları ekleyebilirsiniz. İletişim kutusu içeren iletiler için desteklenmez. Ayrıntılar için Mesajın alt kısmına etkileşimli widget 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

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

Birlik alanı metadata. Ek açıklamayla ilgili ek meta veriler. metadata yalnızca aşağıdakilerden biri olabilir:
userMention

object (UserMentionMetadata)

Kullanıcıdan bahsetmeyle ilgili meta veriler.

slashCommand

object (SlashCommandMetadata)

Eğik çizgi komutunun meta verileri.

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

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

Birlik 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

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 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ürü için.)

dialogAction

object (DialogAction)

Yalnızca giriş. Bir iletişim kutusuyla ilgili 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 işleme yalnızca ileti gönderen türünün BOT olduğu CARD_CLICKED etkinliklerinde 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 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

İ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ş. İstek için 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ş. 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ğı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önderilecek mesaj. Ayarlanmazsa statusCode tabanlı 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ğildir, başarılı olduğunda döndürülür.

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, yeterli hata bilgisi döndürmeyen API'ler tarafından oluşturulan 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 ile arasında 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

Son tarih işlem tamamlanmadan sona erdi. 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: Ö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, bir kaynağın tükenmesinden kaynaklanan retler için kullanılmamalıdır (bu hatalar için bunun yerine RESOURCE_EXHAUSTED 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ğu veya istenen öğenin var olduğu ya da diğer ön koşulları karşıladığı anlamına gelmez.

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ğilse, rmdir işlemi dizin olmayan bir yere uygulanırsa 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 yüksek bir seviyede yeniden denemesi gerekiyorsa ABORTED 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 değerini kullanın. Örneğin, bir "rmdir" işlemi dizin boş olmadığı için başarısız olursa istemci, dizinden dosyalar silinmediği sürece yeniden deneme yapmaması gerektiğinden FAILED_PRECONDITION döndürülmelidir.

HTTP eşleme: 400 Hatalı İstek

ABORTED

İşlem, genellikle sıralayıcı kontrolü hatası veya işlem iptal edilmesi 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 Haritalama: 409 Çakışma

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 biraz örtüşme 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çici bir durumdur ve geri alma işlemiyle tekrar denenerek düzeltilebilir. Tutarlılık kontrolü olmayan işlemlerin her zaman yeniden denenmesinin 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 amacıyla 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.

Birlik 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 çizgiyle başlayan komut.

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

reactionCount

integer

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

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ı kimin sildiği 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 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ı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
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

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.