REST Resource: spaces.messages

Resource: Pesan

Pesan di 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 menetapkan 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, lihat Memberi nama pesan.

sender

object (User)

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

createTime

string (Timestamp format)

Opsional. Tidak dapat diubah. Untuk ruang yang dibuat di Chat, waktu saat pesan dibuat. Kolom ini hanya output, kecuali jika 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 kosong.

deleteTime

string (Timestamp format)

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

text

string

Isi teks biasa 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 SMS.

formattedText

string

Hanya output. Berisi pesan text dengan markup yang ditambahkan untuk menyampaikan pemformatan. Kolom ini mungkin tidak menangkap semua format yang terlihat di UI, tetapi menyertakan hal berikut:

  • Sintaksis markup untuk cetak 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 string kedua adalah teks yang dirender—misalnya, <http://example.com|custom text>.

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

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

cards[]
(deprecated)

object (Card)

Tidak digunakan lagi: Sebagai gantinya, gunakan cardsV2.

Kartu lengkap, 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. Ukuran maksimum cards dan cardsV2 dapat sebesar 32 KB.

cardsV2[]

object (CardWithId)

Array kartu.

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

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

Desain dan pratinjau kartu dengan Card Builder.

Membuka Card Builder

annotations[]

object (Annotation)

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

thread

object (Thread)

Rangkaian pesan tempat pesan berada. Untuk mengetahui contoh penggunaannya, 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 tentang kartu pesan, yang digunakan saat kartu sebenarnya tidak dapat ditampilkan—misalnya, notifikasi seluler.

actionResponse

object (ActionResponse)

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

argumentText

string

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

slashCommand

object (SlashCommand)

Hanya output. Informasi perintah garis miring, jika berlaku.

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 selengkapnya, lihat Pratinjau link.

threadReply

boolean

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

Jika ruang tidak mendukung balasan 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, lihat Memberi nama pesan.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Hanya output. Daftar ringkasan reaksi emoji di pesan.

privateMessageViewer

object (User)

Tidak dapat diubah. Input untuk membuat pesan, atau hanya output. Pengguna yang dapat melihat pesan. Jika disetel, pesan akan bersifat pribadi dan hanya terlihat oleh pengguna tertentu dan aplikasi Chat. 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 menghilangkan kolom ini.

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

deletionMetadata

object (DeletionMetadata)

Hanya output. Informasi tentang pesan yang dihapus. Pesan 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.

Pembuatan pesan dengan widget aksesori memerlukan autentikasi aplikasi.

CardWithId

Kartu di pesan Google Chat.

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

Desain dan pratinjau kartu dengan Card Builder.

Membuka Card Builder

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

string

Wajib 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 pada 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

Indeks awal (berbasis 0, inklusif) dalam isi pesan teks biasa yang sesuai dengan anotasi ini.

Kolom union metadata. Metadata tambahan tentang anotasi. metadata hanya dapat berupa salah satu dari berikut:
userMention

object (UserMentionMetadata)

Metadata sebutan pengguna.

slashCommand

object (SlashCommandMetadata)

Metadata untuk perintah garis miring.

AnnotationType

Jenis anotasi.

Enum
ANNOTATION_TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
USER_MENTION 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)

Pengguna menyebutkan.

type

enum (Type)

Jenis sebutan pengguna.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Tambahkan pengguna ke ruang.
MENTION Sebutkan 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 lengkap ke referensi.

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

string

URI link ini.

Kolom union data. Data untuk resource tertaut. data hanya dapat berupa salah satu dari berikut:

RichLinkType

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

Enum
DRIVE_FILE Jenis link kaya Google Drive.
CHAT_SPACE Jenis link kaya ruang Chat. Misalnya, smart chip ruang.

DriveLinkData

Data untuk penautan 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.

ChatSpaceLinkData

Data untuk link ruang Chat.

Representasi JSON
{
  "space": string,
  "thread": string,
  "message": string
}
Kolom
space

string

Ruang resource ruang Chat yang ditautkan.

Format: spaces/{space}

thread

string

Thread dari resource ruang Chat yang ditautkan.

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

message

string

Pesan resource ruang Chat yang ditautkan.

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

Rangkaian pesan

Rangkaian pesan di ruang Google Chat. Untuk mengetahui contoh penggunaannya, 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

Nama resource thread.

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

threadKey

string

Opsional. Input untuk membuat atau mengupdate thread. Jika tidak, hanya output. ID untuk thread. Mendukung hingga 4000 karakter.

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

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)

Input saja. Jenis respons aplikasi Chat.

url

string

Input saja. URL untuk pengguna untuk diautentikasi atau dikonfigurasi. (Hanya untuk REQUEST_CONFIG jenis respons.)

dialogAction

object (DialogAction)

Input saja. Respons terhadap peristiwa interaksi yang terkait dengan dialog. Harus disertai dengan ResponseType.Dialog.

updatedWidget

object (UpdatedWidget)

Input saja. Respons dari widget yang diupdate.

ResponseType

Jenis respons aplikasi Chat.

Enum
TYPE_UNSPECIFIED Jenis default yang ditangani sebagai NEW_MESSAGE.
NEW_MESSAGE Memposting sebagai pesan baru dalam topik.
UPDATE_MESSAGE Update pesan aplikasi Chat. Ini hanya diizinkan pada peristiwa CARD_CLICKED yang jenis pengirim pesannya adalah BOT.
UPDATE_USER_MESSAGE_CARDS Perbarui kartu pada pesan pengguna. Pesan ini hanya diizinkan sebagai respons terhadap peristiwa MESSAGE dengan URL yang cocok, atau peristiwa CARD_CLICKED yang jenis pengirim pesannya adalah HUMAN. Teks diabaikan.
REQUEST_CONFIG Minta pengguna untuk melakukan autentikasi atau konfigurasi tambahan 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)

Input saja. Status permintaan untuk memanggil atau mengirimkan dialog. Menampilkan status dan pesan kepada pengguna, jika perlu. Misalnya, jika terjadi error atau berhasil.

Kolom union action. Tindakan yang akan dilakukan. action hanya dapat berupa salah satu dari berikut:
dialog

object (Dialog)

Input saja. Dialog untuk permintaan.

Dialog

Wrapper di sekitar isi kartu dialog.

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

object (Card)

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

ActionStatus

Merepresentasikan status permintaan untuk memanggil atau mengirimkan dialog.

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

enum (Code)

Kode status.

userFacingMessage

string

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

Kode

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 pada level 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 dari 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 harus cocok dengan ID untuk widget yang memicu permintaan update.

Kolom union updated_widget. Widget diperbarui sebagai respons terhadap tindakan pengguna. updated_widget hanya dapat berupa salah satu dari 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 selengkapnya, 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 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 yang dikutip.

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

string

Hanya output. Nama resource dari 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. Jenis tindakan. action hanya dapat berupa salah satu dari 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 dalam ruang tempat pemanggil menjadi anggota, termasuk pesan dari anggota dan ruang yang diblokir.

patch

Memperbarui pesan.

update

Memperbarui pesan.