REST Resource: spaces.messages

Resource: Pesan

Pesan dalam ruang Google Chat.

Representasi JSON
{
  "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)
    }
  ]
}
Kolom
name

string

Nama resource pesan.

Format: spaces/{space}/messages/{message}

Dengan {space} adalah ID ruang tempat pesan diposting dan {message} adalah ID yang ditetapkan sistem untuk pesan tersebut. Misalnya, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Jika Anda menyetel ID kustom saat membuat pesan, Anda dapat menggunakan ID ini untuk menentukan pesan dalam permintaan dengan mengganti {message} dengan nilai dari kolom clientAssignedMessageId. Misalnya, spaces/AAAAAAAAAAA/messages/client-custom-name. Untuk mengetahui detailnya, baca Menamai pesan.

sender

object (User)

Hanya output. Pengguna yang membuat pesan. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output akan mengisi name dan type pengguna.

createTime

string (Timestamp format)

Opsional. Tidak dapat diubah. Untuk ruang yang dibuat di Chat, waktu saat pesan dibuat. Kolom ini hanya merupakan output, kecuali saat digunakan dalam ruang mode impor.

Untuk ruang mode impor, tetapkan kolom ini ke stempel waktu historis saat pesan dibuat di sumber untuk mempertahankan waktu pembuatan asli.

lastUpdateTime

string (Timestamp format)

Hanya output. Waktu saat pesan terakhir diedit oleh pengguna. Jika pesan belum pernah diedit, kolom ini akan kosong.

deleteTime

string (Timestamp format)

Hanya output. Waktu saat pesan dihapus di Google Chat. Jika pesan tidak pernah dihapus, kolom ini akan kosong.

text

string

Isi teks biasa pada pesan. Link pertama ke gambar, video, atau halaman web menghasilkan chip pratinjau. Anda juga dapat @menyebut pengguna Google Chat, atau semua orang dalam ruang.

Untuk mempelajari cara membuat pesan teks, lihat Mengirim pesan teks.

formattedText

string

Hanya output. Berisi pesan text dengan markup yang ditambahkan untuk mengomunikasikan pemformatan. Kolom ini mungkin tidak merekam semua pemformatan yang terlihat di UI, tetapi mencakup hal berikut:

  • Sintaks markup untuk tebal, miring, dicoret, spasi tunggal, blok spasi tunggal, dan daftar berbutir.

  • Sebutan pengguna menggunakan format <users/{user}>.

  • Hyperlink kustom menggunakan format <{url}|{rendered_text}> dengan string pertama adalah URL dan yang kedua adalah teks yang dirender—misalnya, <http://example.com|custom text>.

  • Emoji kustom menggunakan format :{emoji_name}:—misalnya, :smile:. Hal ini tidak berlaku untuk emoji Unicode, seperti U+1F600 untuk emoji wajah tersenyum.

Untuk informasi selengkapnya, baca Melihat pemformatan teks yang dikirim dalam pesan

cards[]
(deprecated)

object (Card)

Tidak digunakan lagi: Sebagai gantinya, gunakan cardsV2.

Kartu yang kaya, berformat, dan interaktif yang dapat Anda gunakan untuk menampilkan elemen UI seperti: teks berformat, tombol, dan gambar yang dapat diklik. Kartu biasanya ditampilkan di bawah isi teks biasa pada pesan. cards dan cardsV2 dapat memiliki ukuran maksimum 32 KB.

cardsV2[]

object (CardWithId)

Array kartu.

Hanya aplikasi Chat yang dapat membuat kartu. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, pesan tidak boleh berisi kartu.

Untuk mempelajari kartu dan cara membuatnya, lihat Mengirim pesan kartu.

Desain dan pratinjau kartu dengan Pembuat Kartu.

Buka Pembuat Kartu

annotations[]

object (Annotation)

Hanya output. Anotasi yang terkait dengan text dalam pesan ini.

thread

object (Thread)

Rangkaian tempat pesan berada. Sebagai contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.

space

object (Space)

Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output akan mengisi ruang name.

fallbackText

string

Deskripsi teks biasa pada kartu pesan, yang digunakan saat kartu yang sebenarnya tidak dapat ditampilkan—misalnya, notifikasi seluler.

actionResponse

object (ActionResponse)

Hanya input. Parameter yang dapat digunakan aplikasi Chat untuk mengonfigurasi cara responsnya diposting.

argumentText

string

Hanya output. Isi teks biasa pesan dengan semua sebutan aplikasi Chat dihilangkan.

slashCommand

object (SlashCommand)

Hanya output. Informasi perintah garis miring, jika ada.

attachment[]

object (Attachment)

Lampiran yang diupload pengguna.

matchedUrl

object (MatchedUrl)

Hanya output. URL di spaces.messages.text yang cocok dengan pola pratinjau link. Untuk informasi lebih lanjut, lihat Pratinjau link.

threadReply

boolean

Hanya output. Jika true, pesan adalah respons dalam rangkaian balasan. Jika false, pesan akan terlihat di percakapan tingkat teratas ruang sebagai pesan pertama dari rangkaian pesan atau pesan tanpa balasan berangkai.

Jika ruang tidak mendukung balas dalam rangkaian pesan, kolom ini selalu false.

clientAssignedMessageId

string

Opsional. ID kustom untuk pesan. Anda dapat menggunakan kolom untuk mengidentifikasi pesan, atau untuk mendapatkan, menghapus, atau memperbarui pesan. Untuk menetapkan ID kustom, tentukan kolom messageId saat Anda membuat pesan. Untuk mengetahui detailnya, baca Menamai pesan.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Hanya output. Daftar ringkasan reaksi emoji pada pesan.

privateMessageViewer

object (User)

Tidak dapat diubah. Input untuk membuat pesan, jika tidak, hanya output. Pengguna yang dapat melihat pesan. Jika disetel, pesan akan bersifat pribadi dan hanya dapat dilihat oleh pengguna dan aplikasi Chat tertentu. Pratinjau link dan lampiran tidak didukung untuk pesan pribadi.

Hanya aplikasi Chat yang dapat mengirim pesan pribadi. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna untuk mengirim pesan, pesan tidak boleh bersifat pribadi dan harus menghapus kolom ini.

Untuk mengetahui detailnya, lihat Mengirim pesan pribadi ke pengguna Google Chat.

deletionMetadata

object (DeletionMetadata)

Hanya output. Informasi tentang pesan yang dihapus. Pesan akan dihapus saat deleteTime ditetapkan.

quotedMessageMetadata

object (QuotedMessageMetadata)

Hanya output. Informasi tentang pesan yang dikutip oleh pengguna Google Chat dalam ruang. Pengguna Google Chat dapat mengutip pesan untuk membalasnya.

attachedGifs[]

object (AttachedGif)

Hanya output. Gambar GIF yang dilampirkan ke pesan.

accessoryWidgets[]

object (AccessoryWidget)

Satu atau beberapa widget interaktif yang muncul di bagian bawah pesan. Anda dapat menambahkan widget aksesori ke pesan yang berisi teks, kartu, atau teks dan kartu. Tidak didukung untuk pesan yang berisi dialog. Untuk mengetahui detailnya, lihat Menambahkan widget interaktif di bagian bawah pesan.

Membuat pesan dengan widget aksesori memerlukan autentikasi aplikasi.

CardWithId

Kartu dalam pesan Google Chat.

Hanya aplikasi Chat yang dapat membuat kartu. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, pesan tidak boleh berisi kartu.

Desain dan pratinjau kartu dengan Pembuat Kartu.

Buka Pembuat Kartu

Representasi JSON
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Kolom
cardId

string

Wajib diisi jika pesan berisi beberapa kartu. ID unik untuk kartu dalam pesan.

card

object (Card)

Kartu. Ukuran maksimum adalah 32 KB.

Annotation

Hanya output. Anotasi yang terkait dengan isi teks biasa pesan. Untuk menambahkan pemformatan dasar ke pesan teks, lihat Memformat pesan teks.

Contoh isi pesan teks biasa:

Hello @FooBot how are you!"

Metadata anotasi yang sesuai:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
Representasi JSON
{
  "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.
}
Kolom
type

enum (AnnotationType)

Jenis anotasi ini.

length

integer

Panjang substring dalam isi pesan teks biasa yang sesuai dengan anotasi ini.

startIndex

integer

Mulai indeks (berbasis 0, inklusif) dalam isi pesan teks biasa yang terkait dengan anotasi ini.

Kolom union metadata. Metadata tambahan tentang anotasi. metadata hanya ada berupa salah satu diantara berikut:
userMention

object (UserMentionMetadata)

Metadata yang disebutkan oleh pengguna.

slashCommand

object (SlashCommandMetadata)

Metadata untuk perintah garis miring.

AnnotationType

Jenis anotasi.

Enum
ANNOTATION_TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
USER_MENTION Seorang pengguna disebutkan.
SLASH_COMMAND Perintah garis miring dipanggil.

UserMentionMetadata

Metadata anotasi untuk sebutan pengguna (@).

Representasi JSON
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Kolom
user

object (User)

Yang disebutkan pengguna.

type

enum (Type)

Jenis sebutan pengguna.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Tambahkan pengguna ke ruang.
MENTION Menyebut pengguna di ruang.

SlashCommandMetadata

Metadata anotasi untuk perintah garis miring (/).

Representasi JSON
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Kolom
bot

object (User)

Aplikasi Chat yang perintahnya dipanggil.

type

enum (Type)

Jenis perintah garis miring.

commandName

string

Nama perintah garis miring yang dipanggil.

commandId

string (int64 format)

ID perintah dari perintah garis miring yang dipanggil.

triggersDialog

boolean

Menunjukkan apakah perintah garis miring ditujukan untuk dialog.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Tambahkan aplikasi Chat ke ruang.
INVOKE Panggil perintah garis miring di ruang.

RichLinkMetadata

Link kaya ke referensi.

Representasi JSON
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

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

string

URI link ini.

Kolom union data. Data untuk resource tertaut. data hanya ada berupa salah satu diantara berikut:

RichLinkType

Jenis link multimedia. Jenis lainnya mungkin akan ditambahkan di masa mendatang.

Enum
DRIVE_FILE Jenis link multimedia Google Drive.

DriveLinkData

Data untuk link Google Drive.

Representasi JSON
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Kolom
driveDataRef

object (DriveDataRef)

DriveDataRef yang mereferensikan file Google Drive.

mimeType

string

Jenis mime resource Google Drive yang ditautkan.

Rangkaian pesan

Rangkaian pesan di ruang Google Chat. Sebagai contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.

Jika menentukan rangkaian pesan saat membuat pesan, Anda dapat menetapkan kolom messageReplyOption untuk menentukan apa yang terjadi jika tidak ditemukan rangkaian pesan yang cocok.

Representasi JSON
{
  "name": string,
  "threadKey": string
}
Kolom
name

string

Hanya output. Nama resource thread.

Contoh: spaces/{space}/threads/{thread}

threadKey

string

Opsional. Input untuk membuat atau memperbarui thread. Jika tidak, hanya output. ID untuk rangkaian pesan. Mendukung hingga 4.000 karakter.

ID ini unik untuk aplikasi Chat yang menetapkannya. Misalnya, jika beberapa aplikasi Chat membuat pesan menggunakan kunci rangkaian pesan yang sama, pesan akan diposting di rangkaian pesan yang berbeda. Untuk membalas dalam rangkaian pesan yang dibuat oleh orang atau aplikasi Chat lain, tentukan kolom rangkaian pesan name sebagai gantinya.

ActionResponse

Parameter yang dapat digunakan aplikasi Chat untuk mengonfigurasi cara responsnya diposting.

Representasi JSON
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Kolom
type

enum (ResponseType)

Hanya input. Jenis respons aplikasi Chat.

url

string

Hanya input. URL untuk autentikasi atau konfigurasi pengguna. (Hanya untuk jenis respons REQUEST_CONFIG.)

dialogAction

object (DialogAction)

Hanya input. Respons terhadap peristiwa interaksi terkait dialog. Harus disertai dengan ResponseType.Dialog.

updatedWidget

object (UpdatedWidget)

Hanya input. Respons widget yang diupdate.

ResponseType

Jenis respons aplikasi Chat.

Enum
TYPE_UNSPECIFIED Jenis default yang ditangani sebagai NEW_MESSAGE.
NEW_MESSAGE Posting sebagai pesan baru dalam topik.
UPDATE_MESSAGE Perbarui pesan aplikasi Chat. Hal ini hanya diizinkan pada peristiwa CARD_CLICKED dengan jenis pengirim pesan adalah BOT.
UPDATE_USER_MESSAGE_CARDS Memperbarui kartu pada pesan pengguna. Tindakan ini hanya diizinkan sebagai respons terhadap peristiwa MESSAGE dengan URL yang cocok, atau peristiwa CARD_CLICKED dengan jenis pengirim pesan adalah HUMAN. Teks diabaikan.
REQUEST_CONFIG Mintalah autentikasi atau konfigurasi tambahan kepada pengguna secara pribadi.
DIALOG Menampilkan dialog.
UPDATE_WIDGET Kueri opsi pelengkapan otomatis teks widget.

DialogAction

Berisi dialog dan kode status permintaan.

Representasi JSON
{
  "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.
}
Kolom
actionStatus

object (ActionStatus)

Hanya input. Status permintaan untuk memanggil atau mengirim dialog. Menampilkan status dan pesan kepada pengguna, jika perlu. Misalnya, jika terjadi error atau berhasil.

Kolom union action.

action hanya dapat berupa salah satu dari yang berikut:

dialog

object (Dialog)

Hanya input. Dialog untuk permintaan.

Dialog

Bungkus di sekitar isi kartu dialog.

Representasi JSON
{
  "body": {
    object (Card)
  }
}
Kolom
body

object (Card)

Hanya input. Isi dialog, yang dirender dalam modal. Aplikasi Google Chat tidak mendukung entitas kartu berikut: DateTimePicker, OnChangeAction.

ActionStatus

Merepresentasikan status permintaan untuk memanggil atau mengirim dialog.

Representasi JSON
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Kolom
statusCode

enum (Code)

Kode status.

userFacingMessage

string

Pesan yang akan dikirim kepada pengguna tentang status permintaan mereka. Jika tidak disetel, pesan umum berdasarkan statusCode akan dikirim.

Code

Kode error kanonis pada gRPC API.

Terkadang beberapa kode error dapat terjadi. Layanan seharusnya menampilkan kode error paling spesifik yang berlaku. Misalnya, lebih memilih menampilkan OUT_OF_RANGE daripada FAILED_PRECONDITION jika kedua kode berlaku. Demikian pula, untuk lebih memilih menampilkan NOT_FOUND atau ALREADY_EXISTS daripada FAILED_PRECONDITION.

Enum
OK

Bukan error; ditampilkan jika berhasil.

Pemetaan HTTP: 200 OK

CANCELLED

Operasi dibatalkan, biasanya oleh pemanggil.

Pemetaan HTTP: 499 Client Closed Request

UNKNOWN

Error tidak diketahui. Misalnya, error ini dapat ditampilkan jika nilai Status yang diterima dari ruang alamat lain yang berada di ruang error yang tidak diketahui di ruang alamat ini. Selain itu, error yang dilaporkan oleh API yang tidak menampilkan informasi error yang mencukupi dapat dianggap sebagai error ini.

Pemetaan HTTP: Error Server Internal 500

INVALID_ARGUMENT

Klien menetapkan argumen yang tidak valid. Perhatikan bahwa ini berbeda dengan FAILED_PRECONDITION. INVALID_ARGUMENT menyatakan argumen yang bermasalah, terlepas dari keadaannya di dalam sistem (misalnya, nama file yang salah format).

Pemetaan HTTP: 400 Permintaan Tidak Valid

DEADLINE_EXCEEDED

Batas waktu berakhir sebelum operasi selesai. Untuk operasi yang mengubah keadaan sistem, error ini mungkin ditampilkan, bahkan jika, operasi tersebut telah selesai. Sebagai contoh, respons berhasil dari suatu server dapat tertunda selama waktu yang cukup lama hingga tenggat waktu berakhir.

Pemetaan HTTP: 504 Gateway Timeout

NOT_FOUND

Beberapa entity yang diminta (misalnya, file atau direktori) tidak ditemukan.

Catatan bagi developer server: apabila suatu permintaan ditolak pada seluruh kelas pengguna, seperti peluncuran bertahap, atau daftar yang diberi akses, NOT_FOUND dapat digunakan. Jika permintaan ditolak pada beberapa pengguna di dalam suatu kelas pengguna, seperti pada kontrol akses basis pengguna, maka, PERMISSION_DENIED harus digunakan.

Pemetaan HTTP: 404 Not Found

ALREADY_EXISTS

Entitas yang coba dibuat oleh klien (misalnya, file atau direktori) sudah ada.

Pemetaan HTTP: 409 Conflict

PERMISSION_DENIED

Pemanggil tidak memiliki izin untuk menjalankan operasi yang ditentukan. PERMISSION_DENIED tidak boleh digunakan untuk penolakan yang disebabkan oleh kehabisan beberapa resource (gunakan RESOURCE_EXHAUSTED untuk error tersebut). PERMISSION_DENIED tidak boleh digunakan apabila pemanggil tidak dapat diidentifikasi (gunakan UNAUTHENTICATED untuk error tersebut). Kode error ini tidak menyatakan bahwa suatu permintaan valid atau entitas yang diminta ada atau memenuhi prakondisi lainnya.

Pemetaan HTTP: 403 Forbidden

UNAUTHENTICATED

Permintaan tidak memiliki kredensial autentikasi operasi yang valid.

Pemetaan HTTP: 401 Tidak Sah

RESOURCE_EXHAUSTED

Beberapa resource telah habis, kemungkinan adalah kuota per pengguna, atau kemungkinan seluruh sistem file kehabisan ruang.

Pemetaan HTTP: 429 Too Many Requests

FAILED_PRECONDITION

Operasi tersebut ditolak karena sistem tidak dalam keadaan dibutuhkan untuk menjalankan operasi. Misalnya, direktori yang akan dihapus tidak kosong, operasi rmdir diterapkan pada non-direktori, dll.

Pelaksana layanan dapat menggunakan panduan berikut untuk menentukan manakah yang paling sesuai di antara FAILED_PRECONDITION, ABORTED, dan UNAVAILABLE: (a) Gunakan UNAVAILABLE apabila klien dapat mencoba kembali panggilan yang gagal sesegera mungkin. (b) Gunakan ABORTED jika klien harus mencoba lagi di tingkat yang lebih tinggi. Misalnya, saat pengujian dan set yang ditentukan klien gagal, yang menunjukkan bahwa klien harus memulai ulang urutan baca-ubah-tulis. (c) Gunakan FAILED_PRECONDITION jika klien tidak diizinkan untuk mencoba kembali hingga status sistem diperbaiki secara eksplisit. Misalnya, jika "rmdir" gagal karena direktori tidak kosong, FAILED_PRECONDITION harus ditampilkan karena klien tidak boleh mencoba lagi kecuali jika file dihapus dari direktori.

Pemetaan HTTP: 400 Permintaan Tidak Valid

ABORTED

Operasi dibatalkan, umumnya karena masalah konkurensi seperti kegagalan pemeriksaan pengurut atau pembatalan transaksi.

Lihat panduan di atas untuk menentukan manakah yang sesuai antara FAILED_PRECONDITION, ABORTED, dan UNAVAILABLE.

Pemetaan HTTP: 409 Conflict

OUT_OF_RANGE

Upaya operasi dilakukan melampaui rentang yang valid. Mis., mencari tahu atau membaca melampaui akhir file.

Tidak seperti INVALID_ARGUMENT, error ini menunjukkan masalah yang dapat diperbaiki jika status sistem berubah. Misalnya, sistem file 32-bit akan menghasilkan INVALID_ARGUMENT jika diminta untuk membaca pada offset yang tidak berada dalam rentang [0,2^32-1], tetapi akan menghasilkan OUT_OF_RANGE jika diminta untuk membaca dari offset melewati ukuran file saat ini.

Terdapat sedikit tumpang-tindih antara FAILED_PRECONDITION dengan OUT_OF_RANGE. Sebaiknya gunakan OUT_OF_RANGE (error yang lebih spesifik) jika memang sesuai, sehingga pemanggil yang melakukan iterasi melalui ruang dapat dengan mudah mencari error OUT_OF_RANGE untuk dideteksi ketika selesai.

Pemetaan HTTP: 400 Permintaan Tidak Valid

UNIMPLEMENTED

Operasi tidak diterapkan atau tidak didukung/diaktifkan dalam layanan ini.

Pemetaan HTTP: 501 Not Implemented

INTERNAL

Error internal. Artinya beberapa invarian yang diperlukan oleh sistem pokok telah rusak. Kode error ini disediakan untuk error yang bersifat serius.

Pemetaan HTTP: Error Server Internal 500

UNAVAILABLE

Saat ini layanan tidak tersedia. Kemungkinan besar ini hanya kondisi sementara, yang dapat diperbaiki dengan mencoba kembali menggunakan backoff. Perlu diketahui bahwa mencoba kembali operasi non-idempoten tidak selalu aman.

Lihat panduan di atas untuk menentukan manakah yang sesuai antara FAILED_PRECONDITION, ABORTED, dan UNAVAILABLE.

Pemetaan HTTP: 503 Layanan Tidak Tersedia

DATA_LOSS

Data hilang atau rusak yang tidak dapat dipulihkan.

Pemetaan HTTP: Error Server Internal 500

UpdatedWidget

Respons widget yang diupdate. Digunakan untuk memberikan opsi pelengkapan otomatis untuk widget.

Representasi JSON
{
  "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.
}
Kolom
widget

string

ID widget yang diperbarui. ID ini harus cocok dengan ID untuk widget yang memicu permintaan update.

Kolom union updated_widget.

updated_widget hanya dapat berupa salah satu dari yang berikut:

suggestions

object (SelectionItems)

Daftar hasil pelengkapan otomatis widget

SelectionItems

Daftar hasil pelengkapan otomatis widget.

Representasi JSON
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Kolom
items[]

object (SelectionItem)

Array objek SelectionItem.

SlashCommand

Perintah garis miring di Google Chat.

Representasi JSON
{
  "commandId": string
}
Kolom
commandId

string (int64 format)

ID perintah garis miring yang dipanggil.

MatchedUrl

URL yang cocok dalam pesan Chat. Aplikasi Chat dapat melihat pratinjau URL yang cocok. Untuk informasi lebih lanjut, lihat Pratinjau link.

Representasi JSON
{
  "url": string
}
Kolom
url

string

Hanya output. URL yang cocok.

EmojiReactionSummary

Jumlah orang yang memberi reaksi pada pesan dengan emoji tertentu.

Representasi JSON
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Kolom
emoji

object (Emoji)

Emoji yang terkait dengan reaksi.

reactionCount

integer

Jumlah total reaksi yang menggunakan emoji terkait.

DeletionMetadata

Informasi tentang pesan yang dihapus. Pesan akan dihapus saat deleteTime ditetapkan.

Representasi JSON
{
  "deletionType": enum (DeletionType)
}
Kolom
deletionType

enum (DeletionType)

Menunjukkan siapa yang menghapus pesan.

DeletionType

Siapa yang menghapus pesan dan bagaimana pesan dihapus.

Enum
DELETION_TYPE_UNSPECIFIED Nilai ini tidak digunakan.
CREATOR Pengguna menghapus pesannya sendiri.
SPACE_OWNER Pemilik ruang menghapus pesan.
ADMIN Admin Google Workspace menghapus pesan.
APP_MESSAGE_EXPIRY Aplikasi Chat menghapus pesannya sendiri saat masa berlakunya habis.
CREATOR_VIA_APP Aplikasi Chat menghapus pesan atas nama pengguna.
SPACE_OWNER_VIA_APP Aplikasi Chat menghapus pesan atas nama pemilik ruang.

QuotedMessageMetadata

Informasi tentang pesan kutipan.

Representasi JSON
{
  "name": string,
  "lastUpdateTime": string
}
Kolom
name

string

Hanya output. Nama resource pesan yang dikutip.

Format: spaces/{space}/messages/{message}

lastUpdateTime

string (Timestamp format)

Hanya output. Stempel waktu saat pesan yang dikutip dibuat atau saat pesan yang dikutip terakhir diperbarui.

AttachedGif

Gambar GIF yang ditentukan oleh URL.

Representasi JSON
{
  "uri": string
}
Kolom
uri

string

Hanya output. URL yang menghosting gambar GIF.

AccessoryWidget

Satu atau beberapa widget interaktif yang muncul di bagian bawah pesan. Untuk mengetahui detailnya, lihat Menambahkan widget interaktif di bagian bawah pesan.

Representasi JSON
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Kolom

Kolom union action.

action hanya dapat berupa salah satu dari yang berikut:

buttonList

object (ButtonList)

Daftar tombol.

Metode

create

Membuat pesan di ruang Google Chat.

delete

Menghapus pesan.

get

Menampilkan detail tentang pesan.

list

Mencantumkan pesan di ruang tempat pemanggil menjadi anggota, termasuk pesan dari anggota dan ruang yang diblokir.

patch

Memperbarui pesan.

update

Memperbarui pesan.