REST Resource: spaces.messages

Resource: Message

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

ID. 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. 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 diautentikasi 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 output, kecuali jika digunakan di 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 kali 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

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

Untuk mempelajari cara membuat pesan teks, lihat Mengirim pesan.

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 mencakup hal berikut:

  • Sintaksis markup untuk tebal, miring, coret, monospace, blok monospace, 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, lihat Melihat pemformatan teks yang dikirim dalam pesan

cards[]
(deprecated)

object (Card)

Tidak digunakan lagi: Gunakan cardsV2 sebagai gantinya.

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)

Opsional. Array kartu.

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

Untuk mempelajari cara membuat pesan yang berisi kartu, lihat Mengirim pesan.

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 contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.

space

object (Space)

Hanya output. Jika aplikasi Chat Anda diautentikasi sebagai pengguna, output hanya akan mengisi ruang name.

fallbackText

string

Opsional. Deskripsi teks biasa tentang kartu pesan, yang digunakan saat kartu 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 pesan teks biasa dengan semua sebutan aplikasi Chat dihapus.

slashCommand

object (SlashCommand)

Hanya output. Informasi perintah garis miring, jika berlaku.

attachment[]

object (Attachment)

Opsional. Lampiran yang diupload pengguna.

matchedUrl

object (MatchedUrl)

Hanya output. URL di spaces.messages.text yang cocok dengan pola pratinjau link. Untuk informasi selengkapnya, lihat Link pratinjau.

threadReply

boolean

Hanya output. Jika true, pesan tersebut adalah respons dalam 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 khusus 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 pada pesan.

privateMessageViewer

object (User)

Opsional. Tidak dapat diubah. Input untuk membuat pesan, jika tidak, hanya output. Pengguna yang dapat melihat pesan. Jika ditetapkan, pesan bersifat pribadi dan hanya dapat dilihat oleh pengguna yang ditentukan dan aplikasi Chat. Untuk menyertakan kolom ini dalam permintaan, Anda harus memanggil Chat API menggunakan autentikasi aplikasi dan menghapus hal berikut:

Untuk mengetahui detailnya, lihat Mengirim pesan secara pribadi.

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 di ruang. Pengguna Google Chat dapat mengutip pesan untuk membalasnya.

attachedGifs[]

object (AttachedGif)

Hanya output. Gambar GIF yang dilampirkan ke pesan.

accessoryWidgets[]

object (AccessoryWidget)

Opsional. 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 di pesan Google Chat.

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

Buat desain dan lihat pratinjau kartu dengan Pembuat Kartu.

Membuka 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 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 yang disebutkan.

type

enum (Type)

Jenis sebutan pengguna.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Menambahkan pengguna ke ruang.
MENTION Menyebut pengguna dalam 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 Menambahkan aplikasi Chat ke ruang.
INVOKE Memanggil perintah garis miring di ruang.

RichLinkMetadata

Link lengkap ke resource.

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

ChatSpaceLinkData

Data untuk link ruang Chat.

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

string

Ruang resource ruang Chat tertaut.

Format: spaces/{space}

thread

string

Rangkaian pesan resource ruang Chat tertaut.

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 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 ada rangkaian pesan yang cocok.

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

string

ID. Nama resource thread.

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

threadKey

string

Opsional. Input untuk membuat atau memperbarui rangkaian pesan. Jika tidak, hanya output. ID untuk thread. 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 di 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)

Hanya input. Jenis respons aplikasi Chat.

url

string

Hanya input. URL untuk pengguna mengautentikasi atau mengonfigurasi. (Hanya untuk jenis respons REQUEST_CONFIG.)

dialogAction

object (DialogAction)

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

updatedWidget

object (UpdatedWidget)

Hanya input. Respons widget yang diperbarui.

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 BOT.
UPDATE_USER_MESSAGE_CARDS Memperbarui 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 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)

Input saja. Status untuk permintaan guna 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)

Hanya input. Dialog untuk permintaan.

Dialog

Wrapper 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 entity kartu berikut: DateTimePicker, OnChangeAction.

ActionStatus

Merepresentasikan status untuk permintaan guna memanggil atau mengirimkan 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 ditetapkan, 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 tingkat yang lebih tinggi. Misalnya, saat kegagalan test-and-set, 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 akan ditampilkan karena klien tidak diizinkan untuk mencoba kembali 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

Untuk widget selectionInput, menampilkan saran pelengkapan otomatis untuk menu multi-pilih.

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 diupdate sebagai respons atas 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 mengetahui informasi selengkapnya, lihat Melihat pratinjau link.

Representasi JSON
{
  "url": string
}
Kolom
url

string

Hanya output. URL yang cocok.

EmojiReactionSummary

Jumlah orang yang bereaksi terhadap pesan dengan emoji tertentu.

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

object (Emoji)

Hanya output. Emoji yang terkait dengan reaksi.

reactionCount

integer

Hanya output. 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 tersebut dihapus. Nilai lainnya mungkin akan ditambahkan di masa mendatang.

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 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 di ruang tempat pemanggil menjadi anggota, termasuk pesan dari anggota dan ruang yang diblokir.

patch

Memperbarui pesan.

update

Memperbarui pesan.