Package google.chat.v1

Indeks

ChatService

Memungkinkan developer membangun aplikasi dan integrasi Chat di Platform Google Chat.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

Menyelesaikan proses impor untuk ruang yang ditentukan dan membuatnya terlihat oleh pengguna. Memerlukan autentikasi aplikasi dan delegasi tingkat domain. Untuk mengetahui informasi selengkapnya, lihat Mengizinkan aplikasi Google Chat untuk mengimpor data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import

Untuk informasi selengkapnya, lihat Panduan otorisasi.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

Membuat keanggotaan manusia atau keanggotaan aplikasi untuk aplikasi panggilan. Membuat keanggotaan untuk aplikasi lain tidak didukung. Sebagai contoh, lihat Mengundang atau menambahkan pengguna atau aplikasi Google Chat ke ruang. Saat membuat langganan, jika anggota yang ditentukan menonaktifkan kebijakan terima otomatis, mereka akan diundang dan harus menerima undangan ruang sebelum bergabung. Jika tidak, membuat keanggotaan akan menambahkan anggota tersebut secara langsung ke ruang yang ditentukan. Memerlukan autentikasi pengguna.

Untuk menentukan anggota yang akan ditambahkan, setel membership.member.name untuk anggota manusia atau aplikasi, atau setel membership.group_member.name untuk anggota grup.

  • Untuk menambahkan aplikasi panggilan ke ruang atau pesan langsung antara dua pengguna, gunakan users/app. Tidak dapat menambahkan aplikasi lain ke ruang.

  • Untuk menambahkan pengguna manusia, gunakan users/{user}, dengan {user} yang dapat berupa alamat email pengguna. Untuk pengguna di organisasi Workspace yang sama, {user} juga dapat berupa id untuk pengguna dari People API, atau id untuk pengguna di Directory API. Misalnya, jika ID profil Person API People untuk user@example.com adalah 123456789, Anda dapat menambahkan pengguna ke ruang dengan menyetel membership.member.name ke users/user@example.com atau users/123456789.

  • Untuk menambahkan atau mengundang grup Google di ruang yang telah diberi nama, gunakan groups/{group}, dengan {group} adalah id untuk grup tersebut dari Cloud Identity Groups API. Misalnya, Anda dapat menggunakan Cloud Identity Groups lookup API guna mengambil ID 123456789 untuk email grup group@example.com, lalu Anda dapat menambahkan atau mengundang grup ke ruang yang telah diberi nama dengan menyetel membership.group_member.name ke groups/123456789. Email grup tidak didukung, dan grup Google hanya dapat ditambahkan sebagai anggota di ruang yang diberi nama.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Untuk informasi selengkapnya, lihat Panduan otorisasi.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

Membuat pesan di ruang Google Chat. Ukuran pesan maksimum, termasuk teks dan kartu, adalah 32.000 byte. Untuk contoh, lihat Mengirim pesan.

Memanggil metode ini memerlukan autentikasi dan mendukung jenis autentikasi berikut:

  • Untuk pesan teks, autentikasi pengguna atau autentikasi aplikasi didukung.
  • Untuk pesan kartu, hanya autentikasi aplikasi yang didukung. (Hanya aplikasi Chat yang dapat membuat pesan kartu.)
Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

Untuk informasi selengkapnya, lihat Panduan otorisasi.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

Membuat reaksi dan menambahkannya ke pesan. Hanya emoji unicode yang didukung. Sebagai contoh, lihat Menambahkan reaksi pada pesan. Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.create

Untuk informasi selengkapnya, lihat Panduan otorisasi.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

Membuat ruang yang diberi nama. Ruang yang dikelompokkan menurut topik tidak didukung. Sebagai contoh, lihat Membuat ruang.

Jika Anda menerima pesan error ALREADY_EXISTS saat membuat ruang, coba displayName lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

Menghapus keanggotaan. Sebagai contoh, lihat Menghapus pengguna atau aplikasi Google Chat dari ruang.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

Menghapus pesan. Sebagai contoh, lihat Menghapus pesan.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna. Saat menggunakan autentikasi aplikasi, permintaan hanya dapat menghapus pesan yang dibuat oleh aplikasi Chat panggilan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

Menghapus reaksi terhadap pesan. Hanya emoji unicode yang didukung. Untuk mengetahui contohnya, lihat Menghapus reaksi. Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

Menghapus ruang yang diberi nama. Selalu melakukan penghapusan beruntun, yang berarti resource turunan ruang, seperti pesan yang diposting dalam ruang dan keanggotaan dalam ruang, juga akan dihapus. Sebagai contoh, lihat Menghapus ruang. Memerlukan autentikasi pengguna dari pengguna yang memiliki izin untuk menghapus ruang.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

Untuk informasi selengkapnya, lihat Panduan otorisasi.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

Menampilkan pesan langsung yang sudah ada dengan pengguna yang ditentukan. Jika ruang pesan langsung tidak ditemukan, error 404 NOT_FOUND akan ditampilkan. Misalnya, lihat Menemukan pesan langsung.

Dengan autentikasi pengguna, menampilkan ruang pesan langsung antara pengguna yang ditentukan dan pengguna terautentikasi.

Dengan autentikasi aplikasi, menampilkan ruang pesan langsung antara pengguna yang ditentukan dan aplikasi Chat panggilan.

Memerlukan autentikasi pengguna atau autentikasi aplikasi.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

Mendapatkan metadata lampiran pesan. Data lampiran diambil menggunakan API media. Sebagai contoh, lihat Mendapatkan metadata tentang lampiran pesan. Memerlukan autentikasi aplikasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.bot

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Menampilkan detail tentang langganan. Misalnya, lihat Mendapatkan detail tentang keanggotaan pengguna atau aplikasi Google Chat.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

Menampilkan detail tentang pesan. Sebagai contoh, lihat Mendapatkan detail tentang pesan.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna.

Catatan: Pesan mungkin ditampilkan dari anggota atau ruang yang diblokir.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

Menampilkan detail tentang ruang. Sebagai contoh, lihat Mendapatkan detail tentang ruang.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

Menampilkan peristiwa dari ruang Google Chat. Payload peristiwa berisi versi terbaru resource yang berubah. Misalnya, jika Anda meminta peristiwa tentang pesan baru, tetapi pesan tersebut kemudian diperbarui, server akan menampilkan resource Message yang diperbarui dalam payload peristiwa.

Memerlukan autentikasi pengguna. Untuk mendapatkan acara, pengguna yang diautentikasi harus menjadi anggota ruang.

Sebagai contoh, lihat Mendapatkan detail acara dari ruang Google Chat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

Menampilkan detail tentang status sudah dibaca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca. Sebagai contoh, lihat Mendapatkan detail tentang status pembacaan ruang pengguna.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

Menampilkan detail tentang status sudah dibaca pengguna dalam rangkaian pesan, yang digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca. Sebagai contoh, lihat Mendapatkan detail tentang status pembacaan thread pengguna.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Mencantumkan keanggotaan dalam ruang. Sebagai contoh, lihat Mencantumkan pengguna dan aplikasi Google Chat dalam ruang. Keanggotaan listingan dengan autentikasi aplikasi mencantumkan keanggotaan dalam ruang yang dapat diakses aplikasi Chat, tetapi tidak menyertakan keanggotaan aplikasi Chat, termasuk keanggotaannya sendiri. Keanggotaan listingan dengan Autentikasi pengguna mencantumkan keanggotaan dalam ruang yang dapat diakses oleh pengguna terautentikasi.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

Mencantumkan pesan dalam ruang tempat pemanggil menjadi anggota, termasuk pesan dari anggota dan ruang yang diblokir. Sebagai contoh, lihat Membuat daftar pesan. Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse)

Mencantumkan reaksi terhadap pesan. Untuk mengetahui contohnya, lihat Membuat daftar reaksi untuk pesan. Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse)

Mencantumkan peristiwa dari ruang Google Chat. Untuk setiap peristiwa, payload berisi resource Chat versi terbaru. Misalnya, jika Anda mencantumkan peristiwa tentang anggota ruang baru, server akan menampilkan resource Membership yang berisi detail keanggotaan terbaru. Jika anggota baru dihapus selama periode yang diminta, payload peristiwa berisi resource Membership kosong.

Memerlukan autentikasi pengguna. Untuk mencantumkan peristiwa, pengguna yang diautentikasi harus menjadi anggota ruang.

Sebagai contoh, lihat Mencantumkan peristiwa dari ruang Google Chat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse)

Mencantumkan ruang tempat pemanggil menjadi anggota. Chat grup dan DM tidak dicantumkan hingga pesan pertama dikirim. Sebagai contoh, lihat Daftar ruang.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna.

Mencantumkan ruang yang terlihat oleh pemanggil atau pengguna yang diautentikasi. Chat grup dan DM tidak dicantumkan hingga pesan pertama dikirim.

Untuk menampilkan daftar semua ruang yang telah diberi nama menurut organisasi Google Workspace, gunakan metode spaces.search() menggunakan hak istimewa administrator Workspace.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Untuk informasi selengkapnya, lihat Panduan otorisasi.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse)

Menampilkan daftar ruang berdasarkan penelusuran pengguna. Memerlukan autentikasi pengguna. Pengguna harus menjadi administrator untuk organisasi Google Workspace. Dalam permintaan, tetapkan use_admin_access ke true.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space)

Membuat ruang dan menambahkan pengguna tertentu ke ruang tersebut. Pengguna yang menelepon akan otomatis ditambahkan ke ruang, dan tidak boleh ditentukan sebagai keanggotaan dalam permintaan. Sebagai contoh, lihat Menyiapkan ruang dengan anggota awal.

Untuk menentukan anggota manusia yang akan ditambahkan, tambahkan keanggotaan dengan membership.member.name yang sesuai. Untuk menambahkan pengguna manusia, gunakan users/{user}, dengan {user} yang dapat berupa alamat email pengguna. Untuk pengguna di organisasi Workspace yang sama, {user} juga dapat berupa id untuk pengguna dari People API, atau id untuk pengguna di Directory API. Misalnya, jika ID profil Person API People untuk user@example.com adalah 123456789, Anda dapat menambahkan pengguna ke ruang dengan menyetel membership.member.name ke users/user@example.com atau users/123456789.

Untuk menentukan grup Google yang akan ditambahkan, tambahkan keanggotaan dengan membership.group_member.name yang sesuai. Untuk menambahkan atau mengundang grup Google, gunakan groups/{group}, dengan {group} adalah id untuk grup tersebut dari Cloud Identity Groups API. Misalnya, Anda dapat menggunakan Cloud Identity Groups lookup API guna mengambil ID 123456789 untuk email grup group@example.com, lalu Anda dapat menambahkan grup tersebut ke ruang dengan menyetel membership.group_member.name ke groups/123456789. Email grup tidak didukung, dan grup Google hanya dapat ditambahkan sebagai anggota di ruang yang diberi nama.

Untuk ruang atau chat grup yang telah diberi nama, jika pemanggil memblokir atau diblokir oleh beberapa anggota, atau tidak memiliki izin untuk menambahkan beberapa anggota, anggota tersebut tidak akan ditambahkan ke ruang yang dibuat.

Untuk membuat pesan langsung (DM) antara pengguna yang menelepon dan pengguna manusia lainnya, tentukan dengan tepat satu keanggotaan untuk mewakili pengguna manusia. Jika satu pengguna memblokir pengguna lainnya, permintaan akan gagal dan DM tidak dibuat.

Untuk membuat DM antara pengguna yang menelepon dan aplikasi panggilan, tetapkan Space.singleUserBotDm ke true dan jangan tentukan keanggotaan apa pun. Anda hanya dapat menggunakan metode ini untuk menyiapkan DM dengan aplikasi panggilan. Untuk menambahkan aplikasi panggilan sebagai anggota ruang atau DM yang ada antara dua pengguna, lihat Mengundang atau menambahkan pengguna atau aplikasi ke ruang.

Jika DM sudah ada di antara dua pengguna, meskipun satu pengguna memblokir pengguna lainnya pada saat permintaan dibuat, DM yang sudah ada akan ditampilkan.

Ruang dengan balasan berangkai tidak didukung. Jika Anda menerima pesan error ALREADY_EXISTS saat menyiapkan ruang, coba displayName lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership)

Memperbarui langganan. Misalnya, lihat Memperbarui langganan pengguna di ruang.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message)

Memperbarui pesan. Terdapat perbedaan antara metode patch dan update. Metode patch menggunakan permintaan patch, sedangkan metode update menggunakan permintaan put. Sebaiknya gunakan metode patch. Sebagai contoh, lihat Memperbarui pesan.

Memerlukan autentikasi. Mendukung autentikasi aplikasi dan autentikasi pengguna. Saat menggunakan autentikasi aplikasi, permintaan hanya dapat memperbarui pesan yang dibuat oleh aplikasi Chat panggilan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space)

Memperbarui ruang. Sebagai contoh, lihat Memperbarui ruang.

Jika Anda memperbarui kolom displayName dan menerima pesan error ALREADY_EXISTS, coba nama tampilan lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState)

Memperbarui status dibaca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca. Misalnya, lihat Memperbarui status pembacaan ruang pengguna.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.users.readstate

Untuk informasi selengkapnya, lihat Panduan otorisasi.

AccessoryWidget

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

Kolom
Kolom union action. Jenis tindakan. action hanya dapat berupa salah satu dari berikut:
button_list

ButtonList

Daftar tombol.

ActionResponse

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

Kolom
type

ResponseType

Input saja. Jenis respons aplikasi Chat.

url

string

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

dialog_action

DialogAction

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

updated_widget

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.

SelectionItems

Daftar hasil pelengkapan otomatis widget.

Kolom
items[]

SelectionItem

Array objek SelectionItem.

UpdatedWidget

Respons dari widget yang diupdate. Digunakan untuk memberikan opsi pelengkapan otomatis untuk 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

SelectionItems

Daftar hasil pelengkapan otomatis widget

ActionStatus

Merepresentasikan status permintaan untuk memanggil atau mengirimkan dialog.

Kolom
status_code

Code

Kode status.

user_facing_message

string

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

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"
   }
}]
Kolom
type

AnnotationType

Jenis anotasi ini.

length

int32

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

start_index

int32

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:
user_mention

UserMentionMetadata

Metadata sebutan pengguna.

slash_command

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.

AttachedGif

Gambar GIF yang ditentukan oleh URL.

Kolom
uri

string

Hanya output. URL yang menghosting gambar GIF.

Lampiran

Lampiran di Google Chat.

Kolom
name

string

Nama resource lampiran, dalam bentuk spaces/{space}/messages/{message}/attachments/{attachment}.

content_name

string

Hanya output. Nama file asli untuk konten, bukan jalur lengkap.

content_type

string

Hanya output. Jenis konten (jenis MIME) dari file.

thumbnail_uri

string

Hanya output. URL thumbnail yang harus digunakan untuk melihat pratinjau lampiran kepada pengguna manusia. Aplikasi chat tidak boleh menggunakan URL ini untuk mendownload konten lampiran.

download_uri

string

Hanya output. URL download yang harus digunakan agar pengguna manusia dapat mendownload lampiran tersebut. Aplikasi chat tidak boleh menggunakan URL ini untuk mendownload konten lampiran.

source

Source

Hanya output. Sumber lampiran.

Kolom union data_ref. Referensi data ke lampiran tersebut. data_ref hanya dapat berupa salah satu dari berikut:
attachment_data_ref

AttachmentDataRef

Referensi ke data lampiran. Kolom ini digunakan bersama API media untuk mendownload data lampiran.

drive_data_ref

DriveDataRef

Hanya output. Referensi ke lampiran Google Drive. Kolom ini digunakan dengan Google Drive API.

Sumber

Sumber lampiran.

Enum
SOURCE_UNSPECIFIED Direservasi.
DRIVE_FILE File tersebut adalah file Google Drive.
UPLOADED_CONTENT File akan diupload ke Chat.

AttachmentDataRef

Referensi ke data lampiran.

Kolom
resource_name

string

Nama resource data lampiran. Kolom ini digunakan bersama API media untuk mendownload data lampiran.

attachment_upload_token

string

Token buram yang berisi referensi ke lampiran yang diupload. Diperlakukan oleh klien sebagai string buram dan digunakan untuk membuat atau memperbarui pesan Chat dengan lampiran.

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

Kolom
card_id

string

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

card

Card

Kartu. Ukuran maksimum adalah 32 KB.

ChatSpaceLinkData

Data untuk link ruang Chat.

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}

CompleteImportSpaceRequest

Pesan permintaan untuk menyelesaikan proses impor ruang.

Kolom
name

string

Wajib. Nama resource ruang mode impor.

Format: spaces/{space}

CompleteImportSpaceResponse

Pesan respons untuk menyelesaikan proses impor ruang.

Kolom
space

Space

Ruang mode impor.

ContextualAddOnMarkup

Jenis ini tidak memiliki kolom.

Markup bagi developer untuk menentukan konten AddOn kontekstual.

Kartu

Kartu adalah elemen UI yang dapat berisi widget UI seperti teks dan gambar.

Kolom
header

CardHeader

Header kartu. {i>Header<i} biasanya berisi judul dan gambar.

sections[]

Section

Bagian-bagian dipisahkan oleh pembagi garis.

card_actions[]

CardAction

Tindakan kartu ini.

name

string

Nama kartu.

CardAction

Tindakan kartu adalah tindakan yang terkait dengan kartu. Untuk kartu invoice, tindakan yang umum dilakukan adalah: menghapus invoice, mengirim invoice melalui email, atau membuka invoice di browser.

Tidak didukung oleh aplikasi Google Chat.

Kolom
action_label

string

Label yang biasa ditampilkan di item menu tindakan.

on_click

OnClick

Tindakan onclick untuk item tindakan ini.

CardHeader

Kolom
title

string

Judul harus ditetapkan. Header memiliki tinggi tetap: jika judul dan subjudul ditentukan, masing-masing membutuhkan satu baris. Jika hanya judul yang ditentukan, kode tersebut akan menggunakan kedua baris.

subtitle

string

Subjudul header kartu.

image_style

ImageStyle

Jenis gambar (misalnya, batas persegi atau batas lingkaran).

image_url

string

URL gambar di header kartu.

ImageStyle

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Batas persegi.
AVATAR Batas melingkar.

Bagian

Bagian berisi kumpulan widget yang dirender (secara vertikal) dalam urutan yang ditentukan. Di semua platform, kartu memiliki lebar tetap yang sempit, sehingga saat ini properti tata letak tidak diperlukan (misalnya, float).

Kolom
header

string

Header bagian. Teks terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

widgets[]

WidgetMarkup

Bagian harus berisi minimal satu widget.

CreateMembershipRequest

Pesan permintaan untuk membuat keanggotaan.

Kolom
parent

string

Wajib. Nama resource ruang tempat membuat keanggotaan.

Format: spasi/{space}

membership

Membership

Wajib. Hubungan keanggotaan yang akan dibuat. Kolom memberType harus berisi pengguna dengan kolom user.name dan user.type yang sudah diisi. Server akan menetapkan nama resource dan menimpa nama apa pun yang ditentukan. Saat membuat hubungan keanggotaan untuk pengguna manusia, aplikasi Chat harus menggunakan cakupan chat.memberships, menetapkan user.type ke HUMAN, dan menetapkan user.name dengan format users/{user}, dengan {user} dapat menjadi alamat email untuk pengguna. Untuk pengguna di organisasi Workspace yang sama, {user} juga dapat berupa id orang dari People API, atau id untuk pengguna di Directory API. Misalnya, jika ID profil Person API People untuk user@example.com adalah 123456789, Anda dapat menambahkan pengguna ke ruang dengan menyetel membership.member.name ke users/user@example.com atau users/123456789. Saat membuat hubungan keanggotaan untuk aplikasi itu sendiri, aplikasi Chat harus menggunakan cakupan chat.memberships.app, menetapkan user.type ke BOT, dan menetapkan user.name ke users/app.

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

Pembuatan keanggotaan aplikasi atau membuat keanggotaan untuk pengguna di luar organisasi Google Workspace administrator tidak didukung menggunakan akses admin.

CreateMessageRequest

Membuat pesan.

Kolom
parent

string

Wajib. Nama resource ruang tempat membuat pesan.

Format: spaces/{space}

message

Message

Wajib. Isi pesan.

thread_key
(deprecated)

string

Opsional. Tidak digunakan lagi: Sebagai gantinya, gunakan thread.thread_key. ID untuk thread. Mendukung hingga 4000 karakter. Untuk memulai atau menambahkan ke rangkaian pesan, buat pesan dan tentukan threadKey atau thread.name. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan.

request_id

string

Opsional. ID permintaan unik untuk pesan ini. Menentukan ID permintaan yang ada akan menampilkan pesan yang dibuat dengan ID tersebut, bukan membuat pesan baru.

message_reply_option

MessageReplyOption

Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalas rangkaian pesan. Hanya didukung di ruang yang diberi nama.

message_id

string

Opsional. ID kustom untuk pesan. Memungkinkan aplikasi Chat mendapatkan, mengupdate, atau menghapus pesan tanpa perlu menyimpan ID yang ditetapkan sistem dalam nama resource pesan (diwakili dalam kolom name pesan).

Nilai untuk kolom ini harus memenuhi persyaratan berikut:

  • Diawali dengan client-. Misalnya, client-custom-name adalah ID kustom yang valid, tetapi custom-name bukan.
  • Berisi maksimal 63 karakter dan hanya huruf kecil, angka, dan tanda hubung.
  • Unik dalam ruang. Aplikasi Chat tidak dapat menggunakan ID kustom yang sama untuk pesan yang berbeda.

Untuk mengetahui detailnya, lihat Memberi nama pesan.

MessageReplyOption

Menentukan cara membalas pesan. Negara bagian lainnya mungkin akan ditambahkan di masa mendatang.

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED Default. Memulai rangkaian pesan baru. Menggunakan opsi ini akan mengabaikan thread ID atau thread_key yang disertakan.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Membuat pesan sebagai balasan untuk rangkaian pesan yang ditentukan oleh thread ID atau thread_key. Jika gagal, pesan akan memulai rangkaian pesan baru.
REPLY_MESSAGE_OR_FAIL Membuat pesan sebagai balasan untuk rangkaian pesan yang ditentukan oleh thread ID atau thread_key. Jika thread_key baru digunakan, thread baru akan dibuat. Jika pembuatan pesan gagal, error NOT_FOUND akan ditampilkan.

CreateReactionRequest

Membuat reaksi terhadap pesan.

Kolom
parent

string

Wajib. Pesan tempat reaksi dibuat.

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

reaction

Reaction

Wajib. Reaksi yang akan dibuat.

CreateSpaceRequest

Permintaan untuk membuat ruang yang diberi nama.

Kolom
space

Space

Wajib. Kolom displayName dan spaceType harus diisi. Hanya SpaceType.SPACE yang didukung.

Jika Anda menerima pesan error ALREADY_EXISTS, coba displayName yang lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Ruang name ditetapkan di server sehingga apa pun yang ditentukan dalam kolom ini akan diabaikan.

request_id

string

Opsional. ID unik untuk permintaan ini. UUID acak direkomendasikan. Menentukan ID permintaan yang ada akan menampilkan ruang yang dibuat dengan ID tersebut, bukan membuat ruang baru. Menentukan ID permintaan yang ada dari aplikasi Chat yang sama dengan pengguna terautentikasi yang berbeda akan menampilkan error.

CustomEmoji

Mewakili emoji kustom.

Kolom
uid

string

Hanya output. Kunci unik untuk resource emoji kustom.

DeleteMembershipRequest

Permintaan untuk menghapus keanggotaan dalam ruang.

Kolom
name

string

Wajib. Nama resource dari keanggotaan yang akan dihapus. Aplikasi Chat dapat menghapus data pengguna atau keanggotaan mereka sendiri. Aplikasi Chat tidak dapat menghapus aplikasi lain keanggotaan.

Saat menghapus langganan manusia, diperlukan cakupan chat.memberships dan format spaces/{space}/members/{member}. Anda dapat menggunakan email sebagai alias untuk {member}. Misalnya, spaces/{space}/members/example@gmail.com dengan example@gmail.com adalah email pengguna Google Chat.

Saat menghapus keanggotaan aplikasi, memerlukan cakupan chat.memberships.app dan format spaces/{space}/members/app.

Format: spaces/{space}/members/{member} atau spaces/{space}/members/app.

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

Menghapus keanggotaan aplikasi dalam ruang tidak didukung menggunakan akses admin.

DeleteMessageRequest

Permintaan untuk menghapus pesan.

Kolom
name

string

Wajib. Nama resource pesan.

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

Jika sudah menetapkan ID kustom untuk pesan, Anda dapat menggunakan nilai dari kolom clientAssignedMessageId untuk {message}. Untuk mengetahui detailnya, lihat Memberi nama pesan.

force

bool

Saat true, menghapus pesan juga akan menghapus balasan berangkainya. Saat false, jika pesan memiliki balasan berangkai, penghapusan akan gagal.

Hanya berlaku saat mengautentikasi sebagai pengguna. Tidak berpengaruh saat mengautentikasi sebagai aplikasi Chat.

DeleteReactionRequest

Menghapus reaksi terhadap pesan.

Kolom
name

string

Wajib. Nama reaksi yang akan dihapus.

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

DeleteSpaceRequest

Permintaan untuk menghapus ruang.

Kolom
name

string

Wajib. Nama resource ruang yang akan dihapus.

Format: spaces/{space}

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.delete.

DeletionMetadata

Informasi tentang pesan yang dihapus. Pesan dihapus saat delete_time ditetapkan.

Kolom
deletion_type

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.

Dialog

Wrapper di sekitar isi kartu dialog.

Kolom
body

Card

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

DialogAction

Berisi dialog dan kode status permintaan.

Kolom
action_status

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

Dialog

Input saja. Dialog untuk permintaan.

DriveDataRef

Referensi ke data lampiran drive.

Kolom
drive_file_id

string

ID untuk file drive. Gunakan dengan Drive API.

DriveLinkData

Data untuk penautan Google Drive.

Kolom
drive_data_ref

DriveDataRef

DriveDataRef yang mereferensikan file Google Drive.

mime_type

string

Jenis mime resource Google Drive yang ditautkan.

Emoji

Emoji yang digunakan sebagai reaksi terhadap pesan.

Kolom
Kolom union content. Konten emoji. content hanya dapat berupa salah satu dari berikut:
unicode

string

Emoji dasar yang direpresentasikan oleh string unicode.

custom_emoji

CustomEmoji

Hanya output. Emoji kustom.

EmojiReactionSummary

Jumlah orang yang memberi reaksi pada pesan dengan emoji tertentu.

Kolom
emoji

Emoji

Emoji yang terkait dengan reaksi.

reaction_count

int32

Jumlah total reaksi yang menggunakan emoji terkait.

FindDirectMessageRequest

Permintaan untuk mendapatkan ruang pesan langsung berdasarkan resource pengguna.

Kolom
name

string

Wajib. Nama resource pengguna yang akan dilihat pesan langsungnya.

Format: users/{user}, dengan {user} adalah id untuk orang dari People API, atau id untuk pengguna di Directory API. Misalnya, jika ID profil People API adalah 123456789, Anda dapat menemukan pesan langsung dengan orang tersebut menggunakan users/123456789 sebagai name. Saat diautentikasi sebagai pengguna, Anda dapat menggunakan email tersebut sebagai alias untuk {user}. Misalnya, users/example@gmail.com dengan example@gmail.com adalah email pengguna Google Chat.

GetAttachmentRequest

Permintaan untuk mendapatkan lampiran.

Kolom
name

string

Wajib. Nama resource lampiran, dalam bentuk spaces/{space}/messages/{message}/attachments/{attachment}.

GetMembershipRequest

Meminta untuk mendapatkan langganan ruang.

Kolom
name

string

Wajib. Nama resource dari keanggotaan yang akan diambil.

Untuk mendapatkan keanggotaan aplikasi sendiri menggunakan autentikasi pengguna, Anda dapat menggunakan spaces/{space}/members/app (opsional).

Format: spaces/{space}/members/{member} atau spaces/{space}/members/app

Saat diautentikasi sebagai pengguna, Anda dapat menggunakan email pengguna tersebut sebagai alias untuk {member}. Misalnya, spaces/{space}/members/example@gmail.com dengan example@gmail.com adalah email pengguna Google Chat.

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.memberships atau chat.admin.memberships.readonly.

Mendapatkan keanggotaan aplikasi di ruang tidak didukung saat menggunakan akses admin.

GetMessageRequest

Permintaan untuk mendapatkan pesan.

Kolom
name

string

Wajib. Nama resource pesan.

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

Jika sudah menetapkan ID kustom untuk pesan, Anda dapat menggunakan nilai dari kolom clientAssignedMessageId untuk {message}. Untuk mengetahui detailnya, lihat Memberi nama pesan.

GetSpaceEventRequest

Pesan permintaan untuk mendapatkan acara ruang.

Kolom
name

string

Wajib. Nama resource acara ruang.

Format: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceReadStateRequest

Pesan permintaan untuk GetSpaceReadState API.

Kolom
name

string

Wajib. Nama resource dari status baca ruang yang akan diambil.

Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil.

Untuk merujuk ke pengguna yang menelepon, tetapkan salah satu opsi berikut:

  • Alias me. Misalnya, users/me/spaces/{space}/spaceReadState.

  • Alamat email Workspace mereka. Misalnya, users/user@example.com/spaces/{space}/spaceReadState.

  • ID pengguna mereka. Misalnya, users/123456789/spaces/{space}/spaceReadState.

Format: users/{pengguna}/spaces/{space}/spaceReadState

GetSpaceRequest

Permintaan untuk menampilkan satu spasi.

Kolom
name

string

Wajib. Nama resource ruang, dalam bentuk spaces/{space}.

Format: spaces/{space}

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.spaces atau chat.admin.spaces.readonly.

GetThreadReadStateRequest

Pesan permintaan untuk GetThreadReadStateRequest API.

Kolom
name

string

Wajib. Nama resource dari status pembacaan thread yang akan diambil.

Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil.

Untuk merujuk ke pengguna yang menelepon, tetapkan salah satu opsi berikut:

  • Alias me. Misalnya, users/me/spaces/{space}/threads/{thread}/threadReadState.

  • Alamat email Workspace mereka. Misalnya, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.

  • ID pengguna mereka. Misalnya, users/123456789/spaces/{space}/threads/{thread}/threadReadState.

Format: pengguna/{pengguna}/ruang/{ruang}/threads/{thread}/threadReadState

Grup

Grup Google di Google Chat.

Kolom
name

string

Nama resource untuk grup Google.

Merepresentasikan grup di Cloud Identity Groups API.

Format: groups/{group}

HistoryState

Status histori untuk pesan dan ruang. Menentukan durasi penyimpanan pesan dan rangkaian percakapan setelah dibuat.

Enum
HISTORY_STATE_UNSPECIFIED Nilai default. Jangan gunakan.
HISTORY_OFF Histori nonaktif. Pesan dan rangkaian pesan disimpan selama 24 jam.
HISTORY_ON Histori aktif. Aturan retensi Vault organisasi menentukan durasi penyimpanan pesan dan rangkaian pesan.

ListMembershipsRequest

Pesan permintaan untuk keanggotaan listingan.

Kolom
parent

string

Wajib. Nama resource ruang tempat daftar keanggotaan akan diambil.

Format: spasi/{space}

page_size

int32

Opsional. Jumlah maksimum langganan yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Jika tidak ditentukan, maksimal 100 langganan yang ditampilkan.

Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai akan otomatis diubah menjadi 1.000.

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Opsional. Token halaman, yang diterima dari panggilan sebelumnya untuk mencantumkan keanggotaan. Berikan parameter ini untuk mengambil halaman berikutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan.

filter

string

Opsional. Filter kueri.

Anda dapat memfilter keanggotaan berdasarkan peran (role) dan jenis anggota (member.type).

Untuk memfilter menurut peran, tetapkan role ke ROLE_MEMBER atau ROLE_MANAGER.

Untuk memfilter menurut jenis, tetapkan member.type ke HUMAN atau BOT. Pratinjau Developer: Anda juga dapat memfilter member.type menggunakan operator !=.

Untuk memfilter menurut peran dan jenis, gunakan operator AND. Untuk memfilter berdasarkan peran atau jenis, gunakan operator OR.

member.type = "HUMAN" atau member.type != "BOT" wajib ada saat use_admin_access ditetapkan ke benar (true). Filter jenis anggota lainnya akan ditolak.

Misalnya, kueri berikut valid:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Kueri berikut tidak valid:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

show_groups

bool

Opsional. Jika true, juga menampilkan langganan yang terkait dengan Google Group, selain jenis langganan lainnya. Jika filter ditetapkan, keanggotaan Google Group yang tidak cocok dengan kriteria filter tidak akan ditampilkan.

show_invited

bool

Opsional. Jika true, juga menampilkan langganan yang terkait dengan pelanggan invited, selain jenis langganan lainnya. Jika filter ditetapkan, keanggotaan invited yang tidak cocok dengan kriteria filter tidak akan ditampilkan.

Saat ini memerlukan autentikasi pengguna.

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.readonly atau chat.admin.memberships.

Mencantumkan keanggotaan aplikasi di ruang tidak didukung saat menggunakan akses admin.

ListMembershipsResponse

Respons terhadap daftar keanggotaan ruang.

Kolom
memberships[]

Membership

Daftar yang tidak diurutkan. Daftar keanggotaan di halaman yang diminta (atau pertama).

next_page_token

string

Token yang dapat Anda kirim sebagai pageToken untuk mengambil halaman hasil berikutnya. Jika kosong, tidak ada halaman berikutnya.

ListMessagesRequest

Mencantumkan pesan di ruang yang ditentukan tempat pengguna menjadi anggota.

Kolom
parent

string

Wajib. Nama resource ruang tempat daftar pesan.

Format: spaces/{space}

page_size

int32

Jumlah maksimum pesan yang ditampilkan. Layanan mungkin menampilkan lebih sedikit pesan daripada nilai ini.

Jika tidak ditentukan, maksimal 25 akan ditampilkan.

Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai akan otomatis diubah menjadi 1.000.

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Opsional, jika melanjutkan dari kueri sebelumnya.

Token halaman yang diterima dari panggilan pesan daftar sebelumnya. Berikan parameter ini untuk mengambil halaman berikutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan.

filter

string

Filter kueri.

Anda dapat memfilter pesan menurut tanggal (create_time) dan rangkaian pesan (thread.name).

Untuk memfilter pesan menurut tanggal pembuatannya, tentukan create_time dengan stempel waktu dalam format RFC-3339 dan tanda kutip ganda. Misalnya, "2023-04-21T11:30:00-04:00". Anda dapat menggunakan operator lebih besar dari > untuk mencantumkan pesan yang dibuat setelah stempel waktu, atau operator kurang dari < untuk mencantumkan pesan yang dibuat sebelum stempel waktu. Untuk memfilter pesan dalam interval waktu, gunakan operator AND di antara dua stempel waktu.

Untuk memfilter menurut thread, tentukan thread.name, yang diformat sebagai spaces/{space}/threads/{thread}. Anda hanya dapat menentukan satu thread.name per kueri.

Untuk memfilter menurut rangkaian pesan dan tanggal, gunakan operator AND di kueri Anda.

Misalnya, kueri berikut valid:

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

order_by

string

Opsional, jika melanjutkan dari kueri sebelumnya.

Cara pengurutan daftar pesan. Tentukan nilai yang akan diurutkan berdasarkan operasi pengurutan. Nilai operasi pengurutan yang valid adalah sebagai berikut:

  • ASC untuk menaik.

  • DESC untuk menurun.

Urutan default-nya adalah create_time ASC.

show_deleted

bool

Apakah akan menyertakan pesan yang dihapus. Pesan yang dihapus mencakup waktu yang dihapus dan metadata tentang penghapusannya, tetapi konten pesan tidak tersedia.

ListMessagesResponse

Pesan respons untuk pesan listingan.

Kolom
messages[]

Message

Daftar pesan.

next_page_token

string

Anda dapat mengirim token sebagai pageToken untuk mengambil halaman hasil berikutnya. Jika kosong, tidak ada halaman berikutnya.

ListReactionsRequest

Mencantumkan reaksi terhadap pesan.

Kolom
parent

string

Wajib. Pesan yang ditanggapi pengguna.

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

page_size

int32

Opsional. Jumlah maksimum reaksi yang ditampilkan. Layanan dapat menampilkan lebih sedikit reaksi daripada nilai ini. Jika tidak ditentukan, nilai defaultnya adalah 25. Nilai maksimumnya adalah 200; nilai di atas 200 akan diubah menjadi 200.

page_token

string

Opsional. (Jika melanjutkan dari kueri sebelumnya.)

Token halaman yang diterima dari panggilan reaksi daftar sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, nilai filter harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda dapat menyebabkan hasil yang tidak diharapkan.

filter

string

Opsional. Filter kueri.

Anda dapat memfilter reaksi berdasarkan emoji (emoji.unicode atau emoji.custom_emoji.uid) dan pengguna (user.name).

Agar dapat memfilter reaksi untuk beberapa emoji atau pengguna, gabungkan kolom serupa menggunakan operator OR, seperti emoji.unicode = "🙂" OR emoji.unicode = "👍" dan user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Untuk memfilter reaksi menurut emoji dan pengguna, gunakan operator AND, seperti emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Jika kueri Anda menggunakan AND dan OR, kelompokkan keduanya dengan tanda kurung.

Misalnya, kueri berikut valid:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Kueri berikut tidak valid:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListReactionsResponse

Respons terhadap permintaan reaksi daftar.

Kolom
reactions[]

Reaction

Daftar reaksi di halaman yang diminta (atau pertama).

next_page_token

string

Token lanjutan untuk mengambil halaman hasil berikutnya. Halaman terakhir dari hasil ini kosong.

ListSpaceEventsRequest

Pesan permintaan untuk mencantumkan acara ruang.

Kolom
parent

string

Wajib. Nama resource ruang Google Chat tempat peristiwa terjadi.

Format: spaces/{space}.

page_size

int32

Opsional. Jumlah maksimum peristiwa ruang yang ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Token halaman, yang diterima dari panggilan peristiwa ruang daftar sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan untuk peristiwa ruang daftar harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan.

filter

string

Wajib. Filter kueri.

Anda harus menentukan setidaknya satu jenis peristiwa (event_type) menggunakan operator has :. Untuk memfilter menurut beberapa jenis peristiwa, gunakan operator OR. Hapus jenis peristiwa batch di filter Anda. Permintaan tersebut akan otomatis menampilkan peristiwa batch terkait. Misalnya, jika Anda memfilter menurut reaksi baru (google.workspace.chat.reaction.v1.created), server juga akan menampilkan peristiwa reaksi baru secara batch (google.workspace.chat.reaction.v1.batchCreated). Untuk mengetahui daftar jenis peristiwa yang didukung, lihat dokumentasi referensi SpaceEvents.

Atau, Anda juga dapat memfilter menurut waktu mulai (start_time) dan waktu berakhir (end_time):

  • start_time: Stempel waktu eksklusif untuk memulai mencantumkan peristiwa ruang. Anda dapat mencantumkan peristiwa yang terjadi hingga 28 hari yang lalu. Jika tidak ditentukan, cantumkan peristiwa ruang dari 28 hari terakhir.
  • end_time: Stempel waktu inklusif hingga peristiwa ruang dicantumkan. Jika tidak ditentukan, mencantumkan peristiwa hingga saat permintaan dibuat.

Untuk menentukan waktu mulai atau berakhir, gunakan operator sama dengan = dan format di RFC-3339. Untuk memfilter menurut start_time dan end_time, gunakan operator AND.

Misalnya, kueri berikut valid:

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"
start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

Kueri berikut tidak valid:

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"
event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListSpaceEventsResponse

Pesan respons untuk mencantumkan peristiwa ruang.

Kolom
space_events[]

SpaceEvent

Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu).

next_page_token

string

Token lanjutan digunakan untuk mengambil lebih banyak peristiwa. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

ListSpacesRequest

Permintaan untuk mencantumkan ruang tempat pemanggil menjadi anggota.

Kolom
page_size

int32

Opsional. Jumlah spasi maksimum yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Jika tidak ditentukan, maksimal 100 spasi akan ditampilkan.

Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai akan otomatis diubah menjadi 1.000.

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Opsional. Token halaman, yang diterima dari panggilan ruang daftar sebelumnya. Berikan parameter ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, nilai filter harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda dapat menyebabkan hasil yang tidak diharapkan.

filter

string

Opsional. Filter kueri.

Anda dapat memfilter ruang berdasarkan jenis ruang (space_type).

Untuk memfilter menurut jenis ruang, Anda harus menentukan nilai enum yang valid, seperti SPACE atau GROUP_CHAT (space_type tidak boleh SPACE_TYPE_UNSPECIFIED). Untuk membuat kueri beberapa jenis ruang, gunakan operator OR.

Misalnya, kueri berikut valid:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListSpacesResponse

Respons untuk permintaan daftar ruang.

Kolom
spaces[]

Space

Daftar spasi di halaman yang diminta (atau pertama).

next_page_token

string

Anda dapat mengirim token sebagai pageToken untuk mengambil halaman hasil berikutnya. Jika kosong, tidak ada halaman berikutnya.

MatchedUrl

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

Kolom
url

string

Hanya output. URL yang cocok.

Langganan

Mewakili hubungan keanggotaan di Google Chat, seperti apakah pengguna atau aplikasi Chat diundang, menjadi bagian dari, atau tidak ada di ruang.

Kolom
name

string

Nama resource keanggotaan, yang ditetapkan oleh server.

Format: spaces/{space}/members/{member}

state

MembershipState

Hanya output. Status keanggotaan.

role

MembershipRole

Opsional. Peran pengguna dalam ruang Chat, yang menentukan tindakan yang diizinkan dalam ruang tersebut.

Kolom ini hanya dapat digunakan sebagai input di UpdateMembership.

create_time

Timestamp

Opsional. Tidak dapat diubah. Waktu pembuatan keanggotaan, seperti saat anggota bergabung atau diundang untuk bergabung ke ruang. Kolom ini hanya merupakan output, kecuali jika digunakan untuk mengimpor keanggotaan historis di ruang mode impor.

delete_time

Timestamp

Opsional. Tidak dapat diubah. Waktu penghapusan keanggotaan, seperti saat anggota keluar dari ruang. Kolom ini hanya merupakan output, kecuali jika digunakan untuk mengimpor keanggotaan historis di ruang mode impor.

Kolom union memberType. Anggota yang terkait dengan keanggotaan ini. Jenis anggota lainnya mungkin didukung pada masa mendatang. memberType hanya dapat berupa salah satu dari berikut:
member

User

Pengguna atau aplikasi Google Chat yang sesuai dengan keanggotaan. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output akan mengisi pengguna name dan type.

group_member

Group

Google Grup tempat keanggotaan sesuai.

MembershipRole

Mewakili tindakan yang diizinkan pengguna di ruang Chat. Nilai enum lainnya mungkin akan ditambahkan di masa mendatang.

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Nilai default. Untuk users: dia bukan anggota ruang, tetapi dapat diundang. Untuk Google Groups: mereka selalu diberi peran ini (nilai enum lainnya dapat digunakan di masa mendatang).
ROLE_MEMBER Anggota ruang. Pengguna memiliki izin dasar, seperti mengirim pesan ke ruang. Dalam percakapan grup 1:1 dan tanpa nama, semua orang memiliki peran ini.
ROLE_MANAGER Pengelola ruang. Pengguna memiliki semua izin dasar ditambah izin administratif yang memungkinkan mereka mengelola ruang, seperti menambahkan atau menghapus anggota. Hanya didukung dalam bahasa SpaceType.SPACE.

MembershipState

Menentukan hubungan anggota dengan ruang. Status keanggotaan lainnya mungkin didukung pada masa mendatang.

Enum
MEMBERSHIP_STATE_UNSPECIFIED Nilai default. Jangan gunakan.
JOINED Pengguna ditambahkan ke ruang dan dapat berpartisipasi dalam ruang.
INVITED Pengguna diundang untuk bergabung ke ruang, tetapi belum bergabung.
NOT_A_MEMBER Pengguna bukan anggota ruang dan tidak memiliki undangan tertunda untuk bergabung ke ruang tersebut.

MembershipBatchCreatedEventData

Payload peristiwa untuk beberapa keanggotaan baru.

Jenis acara: google.workspace.chat.membership.v1.batchCreated

Kolom
memberships[]

MembershipCreatedEventData

Daftar keanggotaan baru.

MembershipBatchDeletedEventData

Payload peristiwa untuk beberapa keanggotaan yang dihapus.

Jenis acara: google.workspace.chat.membership.v1.batchDeleted

Kolom
memberships[]

MembershipDeletedEventData

Daftar keanggotaan yang dihapus.

MembershipBatchUpdatedEventData

Payload peristiwa untuk beberapa keanggotaan yang diperbarui.

Jenis acara: google.workspace.chat.membership.v1.batchUpdated

Kolom
memberships[]

MembershipUpdatedEventData

Daftar keanggotaan yang diperbarui.

MembershipCreatedEventData

Payload peristiwa untuk keanggotaan baru.

Jenis peristiwa: google.workspace.chat.membership.v1.created.

Kolom
membership

Membership

Keanggotaan baru.

MembershipDeletedEventData

Payload peristiwa untuk keanggotaan yang dihapus.

Jenis acara: google.workspace.chat.membership.v1.deleted

Kolom
membership

Membership

Keanggotaan yang dihapus. Hanya kolom name dan state yang diisi.

MembershipUpdatedEventData

Payload peristiwa untuk keanggotaan yang diperbarui.

Jenis acara: google.workspace.chat.membership.v1.updated

Kolom
membership

Membership

Keanggotaan yang diperbarui.

Pesan

Pesan di ruang Google Chat.

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

User

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

create_time

Timestamp

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.

last_update_time

Timestamp

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

delete_time

Timestamp

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.

formatted_text

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 :{emoji_name}:—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)

Card

Tidak digunakan lagi: Sebagai gantinya, gunakan cards_v2.

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 cards_v2 dapat sebesar 32 KB.

cards_v2[]

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[]

Annotation

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

thread

Thread

Rangkaian pesan tempat pesan berada. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan.

space

Space

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

fallback_text

string

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

action_response

ActionResponse

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

argument_text

string

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

slash_command

SlashCommand

Hanya output. Informasi perintah garis miring, jika berlaku.

attachment[]

Attachment

Lampiran yang diupload pengguna.

matched_url

MatchedUrl

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

thread_reply

bool

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.

client_assigned_message_id

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.

emoji_reaction_summaries[]

EmojiReactionSummary

Hanya output. Daftar ringkasan reaksi emoji di pesan.

private_message_viewer

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.

deletion_metadata

DeletionMetadata

Hanya output. Informasi tentang pesan yang dihapus. Pesan dihapus saat delete_time ditetapkan.

quoted_message_metadata

QuotedMessageMetadata

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

attached_gifs[]

AttachedGif

Hanya output. Gambar GIF yang dilampirkan ke pesan.

accessory_widgets[]

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.

MessageBatchCreatedEventData

Payload peristiwa untuk beberapa pesan baru.

Jenis acara: google.workspace.chat.message.v1.batchCreated

Kolom
messages[]

MessageCreatedEventData

Daftar pesan baru.

MessageBatchDeletedEventData

Payload peristiwa untuk beberapa pesan yang dihapus.

Jenis acara: google.workspace.chat.message.v1.batchDeleted

Kolom
messages[]

MessageDeletedEventData

Daftar pesan yang dihapus.

MessageBatchUpdatedEventData

Payload peristiwa untuk beberapa pesan yang diperbarui.

Jenis acara: google.workspace.chat.message.v1.batchUpdated

Kolom
messages[]

MessageUpdatedEventData

Daftar pesan yang diperbarui.

MessageCreatedEventData

Payload peristiwa untuk pesan baru.

Jenis acara: google.workspace.chat.message.v1.created

Kolom
message

Message

Pesan baru.

MessageDeletedEventData

Payload peristiwa untuk pesan yang dihapus.

Jenis acara: google.workspace.chat.message.v1.deleted

Kolom
message

Message

Pesan yang dihapus. Hanya kolom name, createTime, deleteTime, dan deletionMetadata yang terisi.

MessageUpdatedEventData

Payload peristiwa untuk pesan yang diperbarui.

Jenis acara: google.workspace.chat.message.v1.updated

Kolom
message

Message

Pesan yang diperbarui.

QuotedMessageMetadata

Informasi tentang pesan yang dikutip.

Kolom
name

string

Hanya output. Nama resource dari pesan yang dikutip.

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

last_update_time

Timestamp

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

Reaksi

Reaksi terhadap pesan.

Kolom
name

string

Nama resource reaksi.

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

user

User

Hanya output. Pengguna yang membuat reaksi.

emoji

Emoji

Emoji yang digunakan dalam reaksi.

ReactionBatchCreatedEventData

Payload peristiwa untuk beberapa reaksi baru.

Jenis acara: google.workspace.chat.reaction.v1.batchCreated

Kolom
reactions[]

ReactionCreatedEventData

Daftar reaksi baru.

ReactionBatchDeletedEventData

Payload peristiwa untuk beberapa reaksi yang dihapus.

Jenis acara: google.workspace.chat.reaction.v1.batchDeleted

Kolom
reactions[]

ReactionDeletedEventData

Daftar reaksi yang dihapus.

ReactionCreatedEventData

Payload peristiwa untuk reaksi baru.

Jenis acara: google.workspace.chat.reaction.v1.created

Kolom
reaction

Reaction

Reaksi baru.

ReactionDeletedEventData

Payload peristiwa untuk reaksi yang dihapus.

Jenis: google.workspace.chat.reaction.v1.deleted

Kolom
reaction

Reaction

Reaksi yang dihapus.

RichLinkMetadata

Link lengkap ke referensi.

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.

SearchSpacesRequest

Permintaan untuk menelusuri daftar ruang berdasarkan kueri.

Kolom
use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.spaces.readonly atau chat.admin.spaces.

Saat ini metode ini hanya mendukung akses admin, sehingga hanya true yang diterima untuk kolom ini.

page_size

int32

Jumlah spasi maksimum yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Jika tidak ditentukan, maksimal 100 spasi akan ditampilkan.

Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai akan otomatis diubah menjadi 1.000.

page_token

string

Token, yang diterima dari panggilan ruang penelusuran sebelumnya. Berikan parameter ini untuk mengambil halaman berikutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan.

query

string

Wajib. Kueri penelusuran.

Anda dapat melakukan penelusuran menggunakan parameter berikut:

  • create_time
  • customer
  • display_name
  • external_user_allowed
  • last_active_time
  • space_history_state
  • space_type

create_time dan last_active_time menerima stempel waktu dalam format RFC-3339 dan operator perbandingan yang didukung adalah: =, <, >, <=, >=.

customer diperlukan dan digunakan untuk menunjukkan pelanggan mana yang akan diambil ruangnya. customers/my_customer adalah satu-satunya nilai yang didukung.

display_name hanya menerima operator HAS (:). Teks yang akan dicocokkan akan ditokenkan terlebih dahulu menjadi token dan setiap token dicocokkan dengan awalan yang tidak peka huruf besar/kecil dan secara terpisah sebagai substring di mana pun dalam display_name ruang. Misalnya, Fun Eve cocok dengan Fun event atau The evening was fun, tetapi tidak dengan notFun event atau even.

external_user_allowed menerima true atau false.

space_history_state hanya menerima nilai dari kolom historyState dari resource space.

space_type wajib ada dan satu-satunya nilai yang valid adalah SPACE.

Di berbagai kolom, hanya operator AND yang didukung. Contoh yang valid adalah space_type = "SPACE" AND display_name:"Hello" dan contoh yang tidak valid adalah space_type = "SPACE" OR display_name:"Hello".

Di antara kolom yang sama, space_type tidak mendukung operator AND atau OR. display_name, 'space_history_state', dan 'external_user_Allowed' hanya mendukung operator OR. last_active_time dan create_time mendukung operator AND dan OR. AND hanya dapat digunakan untuk mewakili interval, seperti last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00".

Contoh kueri berikut valid:

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by

string

Opsional. Cara pengurutan daftar ruang.

Atribut yang didukung untuk diurutkan adalah:

  • membership_count.joined_direct_human_user_count — Menunjukkan jumlah pengguna manusia yang telah bergabung langsung ke ruang.
  • last_active_time — Menunjukkan waktu saat item terakhir yang memenuhi syarat ditambahkan ke topik mana pun di ruang ini.
  • create_time — Menunjukkan waktu pembuatan ruang.

Nilai operasi pengurutan yang valid adalah:

  • ASC untuk menaik. Nilai default.

  • DESC untuk menurun.

Sintaksis yang didukung adalah:

  • membership_count.joined_direct_human_user_count DESC
  • membership_count.joined_direct_human_user_count ASC
  • last_active_time DESC
  • last_active_time ASC
  • create_time DESC
  • create_time ASC

SearchSpacesResponse

Respons dengan daftar ruang yang sesuai dengan permintaan ruang penelusuran.

Kolom
spaces[]

Space

Halaman dari ruang yang diminta.

next_page_token

string

Token yang dapat digunakan untuk mengambil halaman berikutnya. Jika kolom ini kosong, tidak ada halaman berikutnya.

total_size

int32

Total jumlah spasi yang cocok dengan kueri, di semua halaman. Jika hasilnya melebihi 10.000 spasi, nilai ini adalah perkiraan.

SetUpSpaceRequest

Meminta pembuatan ruang dan menambahkan pengguna tertentu ke dalamnya.

Kolom
space

Space

Wajib. Kolom Space.spaceType wajib diisi.

Untuk membuat ruang, tetapkan Space.spaceType ke SPACE, lalu setel Space.displayName. Jika Anda menerima pesan error ALREADY_EXISTS saat menyiapkan ruang, coba displayName lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Untuk membuat chat grup, tetapkan Space.spaceType ke GROUP_CHAT. Jangan setel Space.displayName.

Untuk membuat percakapan 1:1 antar-manusia, tetapkan Space.spaceType ke DIRECT_MESSAGE dan tetapkan Space.singleUserBotDm ke false. Jangan tetapkan Space.displayName atau Space.spaceDetails.

Untuk membuat percakapan 1:1 antara manusia dan aplikasi Chat yang memanggil, tetapkan Space.spaceType ke DIRECT_MESSAGE dan Space.singleUserBotDm ke true. Jangan tetapkan Space.displayName atau Space.spaceDetails.

Jika ruang DIRECT_MESSAGE sudah ada, ruang tersebut akan ditampilkan, bukan membuat ruang baru.

request_id

string

Opsional. ID unik untuk permintaan ini. UUID acak direkomendasikan. Menentukan ID permintaan yang ada akan menampilkan ruang yang dibuat dengan ID tersebut, bukan membuat ruang baru. Menentukan ID permintaan yang ada dari aplikasi Chat yang sama dengan pengguna terautentikasi yang berbeda akan menampilkan error.

memberships[]

Membership

Opsional. Pengguna atau grup Google Chat yang akan diundang untuk bergabung ke ruang. Hapus pengguna yang menelepon, karena pengguna tersebut ditambahkan secara otomatis.

Kumpulan tersebut saat ini mengizinkan hingga 20 keanggotaan (selain penelepon).

Untuk keanggotaan manusia, kolom Membership.member harus berisi user dengan name terisi (format: users/{user}) dan type ditetapkan ke User.Type.HUMAN. Anda hanya dapat menambahkan pengguna manusia saat menyiapkan ruang (menambahkan aplikasi Chat hanya didukung untuk penyiapan pesan langsung dengan aplikasi panggilan). Anda juga dapat menambahkan anggota menggunakan email pengguna sebagai alias untuk {user}. Misalnya, user.name dapat berupa users/example@gmail.com. Untuk mengundang pengguna Gmail atau pengguna dari domain Google Workspace eksternal, email pengguna harus digunakan untuk {user}.

Untuk keanggotaan grup Google, kolom Membership.group_member harus berisi group dengan name terisi (format groups/{group}). Anda hanya dapat menambahkan grup Google saat menetapkan Space.spaceType ke SPACE.

Opsional saat menetapkan Space.spaceType ke SPACE.

Wajib jika menetapkan Space.spaceType ke GROUP_CHAT, bersama dengan setidaknya dua langganan.

Wajib saat menyetel Space.spaceType ke DIRECT_MESSAGE dengan pengguna manusia, bersama dengan satu langganan.

Harus kosong saat membuat percakapan 1:1 antara manusia dan aplikasi Chat panggilan (saat menetapkan Space.spaceType ke DIRECT_MESSAGE dan Space.singleUserBotDm ke true).

SlashCommand

Perintah garis miring di Google Chat.

Kolom
command_id

int64

ID perintah garis miring yang dipanggil.

SlashCommandMetadata

Metadata anotasi untuk perintah garis miring (/).

Kolom
bot

User

Aplikasi Chat yang perintahnya dipanggil.

type

Type

Jenis perintah garis miring.

command_name

string

Nama perintah garis miring yang dipanggil.

command_id

int64

ID perintah dari perintah garis miring yang dipanggil.

triggers_dialog

bool

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.

Spasi

Ruang di Google Chat. Ruang adalah percakapan antara dua pengguna atau lebih, atau pesan 1:1 antara pengguna dan aplikasi Chat.

Kolom
name

string

Nama resource ruang.

Format: spaces/{space}

type
(deprecated)

Type

Hanya output. Tidak digunakan lagi: Sebagai gantinya, gunakan space_type. Jenis ruang.

space_type

SpaceType

Jenis ruang. Wajib saat membuat ruang atau memperbarui jenis ruang. Output hanya untuk penggunaan lain.

single_user_bot_dm

bool

Opsional. Apakah ruang adalah DM antara aplikasi Chat dan satu orang.

threaded
(deprecated)

bool

Hanya output. Tidak digunakan lagi: Sebagai gantinya, gunakan spaceThreadingState. Apakah pesan disusun dalam ruang ini.

display_name

string

Nama tampilan ruang. Wajib ada saat membuat ruang. Jika Anda menerima pesan error ALREADY_EXISTS saat membuat ruang atau memperbarui displayName, coba displayName lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Untuk pesan langsung, kolom ini mungkin kosong.

Mendukung hingga 128 karakter.

external_user_allowed

bool

Tidak dapat diubah. Apakah ruang ini mengizinkan pengguna Google Chat sebagai anggota. Input saat membuat ruang di organisasi Google Workspace. Hapus kolom ini saat membuat spasi dalam kondisi berikut:

  • Pengguna terautentikasi menggunakan akun konsumen (akun pengguna yang tidak dikelola). Secara default, ruang yang dibuat oleh akun konsumen mengizinkan setiap pengguna Google Chat.

Untuk ruang yang sudah ada, kolom ini hanya output.

space_threading_state

SpaceThreadingState

Hanya output. Status rangkaian pesan di ruang Chat.

space_details

SpaceDetails

Detail tentang ruang, termasuk deskripsi dan aturan.

space_history_state

HistoryState

Status histori pesan untuk pesan dan rangkaian pesan di ruang ini.

import_mode

bool

Opsional. Apakah ruang ini dibuat di Import Mode sebagai bagian dari migrasi data ke Google Workspace. Saat sedang diimpor, ruang tidak dapat dilihat oleh pengguna sampai proses impor selesai.

create_time

Timestamp

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

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

Hanya diisi dalam output saat spaceType adalah GROUP_CHAT atau SPACE.

last_active_time

Timestamp

Hanya output. Stempel waktu pesan terakhir dalam ruang.

admin_installed

bool

Hanya output. Untuk ruang pesan langsung (DM) dengan aplikasi Chat, baik ruang tersebut dibuat oleh administrator Google Workspace. Administrator dapat menginstal dan menyiapkan pesan langsung dengan aplikasi Chat atas nama pengguna di organisasi mereka.

Untuk mendukung penginstalan oleh admin, aplikasi Chat Anda harus memiliki fitur pesan langsung.

membership_count

MembershipCount

Hanya output. Jumlah keanggotaan gabungan yang dikelompokkan menurut jenis anggota. Diisi saat space_type adalah SPACE, DIRECT_MESSAGE, atau GROUP_CHAT.

access_settings

AccessSettings

Opsional. Menentukan setelan akses ruang. Hanya diisi saat space_type adalah SPACE.

space_uri

string

Hanya output. URI bagi pengguna untuk mengakses ruang.

Kolom union space_permission_settings. Menampilkan setelan izin ruang. Hanya diisi saat space_type adalah SPACE. space_permission_settings hanya dapat berupa salah satu dari yang berikut:
predefined_permission_settings

PredefinedPermissionSettings

Opsional. Input saja. Setelan izin ruang. Input untuk membuat ruang, ruang kolaborasi akan dibuat jika kolom ini tidak disetel. Setelah Anda membuat ruang, setelan akan diisi di kolom PermissionSettings.

permission_settings

PermissionSettings

Opsional. Setelan izin yang tepat yang dapat disetel untuk memperbarui ruang. Input untuk memperbarui ruang. Jika tidak, hanya output. Untuk membuat ruang, gunakan predefined_permission_settings.

AccessSettings

Merepresentasikan setelan akses ruang.

Kolom
access_state

AccessState

Hanya output. Menunjukkan status akses ruang.

audience

string

Opsional. Nama resource target audiens yang dapat menemukan ruang, bergabung ke ruang, dan melihat pratinjau pesan dalam ruang. Jika tidak disetel, hanya pengguna atau Google Grup yang telah diundang atau ditambahkan secara terpisah ke ruang yang dapat mengaksesnya. Untuk mengetahui detailnya, lihat Membuat ruang yang dapat ditemukan oleh target audiens.

Format: audiences/{audience}

Untuk menggunakan target audiens default untuk organisasi Google Workspace, tetapkan ke audiences/default.

AccessState

Menampilkan status akses ruang.

Enum
ACCESS_STATE_UNSPECIFIED Status akses tidak diketahui atau tidak didukung dalam API ini.
PRIVATE Hanya pengguna atau Google Grup yang telah ditambahkan atau diundang secara terpisah oleh pengguna lain atau administrator Google Workspace yang dapat menemukan dan mengakses ruang tersebut.
DISCOVERABLE Pengelola ruang telah memberi target audiens akses ke ruang. Pengguna atau Google Grup yang telah ditambahkan atau diundang secara terpisah ke ruang juga dapat menemukan dan mengakses ruang. Untuk mempelajari lebih lanjut, lihat Membuat ruang yang dapat ditemukan oleh pengguna tertentu.

MembershipCount

Mewakili jumlah keanggotaan ruang, yang dikelompokkan ke dalam kategori.

Kolom
joined_direct_human_user_count

int32

Jumlah pengguna manusia yang telah langsung bergabung ke ruang, bukan termasuk pengguna yang bergabung dengan memiliki keanggotaan dalam grup gabungan.

joined_group_count

int32

Jumlah semua grup yang telah bergabung langsung ke ruang.

PermissionSetting

Mewakili setelan izin ruang.

Kolom
managers_allowed

bool

Apakah pengelola ruang memiliki izin ini atau tidak.

members_allowed

bool

Apakah anggota non-pengelola memiliki izin ini atau tidak.

PermissionSettings

Setelan izin untuk ruang yang diberi nama. Untuk menetapkan setelan izin saat membuat ruang, tentukan kolom PredefinedPermissionSettings dalam permintaan Anda.

Kolom
manage_members_and_groups

PermissionSetting

Setelan untuk mengelola anggota dan grup dalam ruang.

modify_space_details

PermissionSetting

Setelan untuk memperbarui nama, avatar, deskripsi, dan panduan ruang.

toggle_history

PermissionSetting

Setelan untuk mengaktifkan dan menonaktifkan histori ruang.

use_at_mention_all

PermissionSetting

Setelan untuk menggunakan @semua dalam ruang.

manage_apps

PermissionSetting

Setelan untuk mengelola aplikasi dalam ruang.

manage_webhooks

PermissionSetting

Setelan untuk mengelola webhook dalam ruang.

post_messages

PermissionSetting

Hanya output. Setelan untuk memposting pesan dalam ruang.

reply_messages

PermissionSetting

Setelan untuk membalas pesan dalam ruang.

PredefinedPermissionSettings

Setelan izin ruang yang dapat Anda tentukan saat membuat ruang yang diberi nama. Setelan lainnya mungkin ditambahkan di masa mendatang. Untuk mengetahui detail setelan izin untuk ruang yang diberi nama, lihat Pelajari ruang.

Enum
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED Tidak ditentukan. Jangan gunakan.
COLLABORATION_SPACE Setelan untuk membuat ruang menjadi ruang kolaborasi tempat semua anggota dapat memposting pesan.
ANNOUNCEMENT_SPACE Setelan untuk membuat ruang menjadi ruang pengumuman tempat hanya pengelola ruang yang dapat memposting pesan.

SpaceDetails

Detail tentang ruang, termasuk deskripsi dan aturan.

Kolom
description

string

Opsional. Deskripsi ruang. Misalnya, jelaskan topik diskusi, tujuan fungsional, atau peserta ruang.

Mendukung hingga 150 karakter.

guidelines

string

Opsional. Aturan, ekspektasi, dan etika ruang.

Mendukung hingga 5.000 karakter.

SpaceThreadingState

Menentukan jenis status rangkaian pesan di ruang Chat.

Enum
SPACE_THREADING_STATE_UNSPECIFIED Direservasi.
THREADED_MESSAGES Ruang bernama yang mendukung rangkaian pesan. Saat pengguna merespons pesan, mereka dapat membalas dalam rangkaian pesan, yang mempertahankan respons mereka dalam konteks pesan asli.
GROUPED_MESSAGES Ruang bernama tempat percakapan diatur menurut topik. Topik dan balasannya dikelompokkan bersama.
UNTHREADED_MESSAGES Pesan langsung (DM) antara dua orang dan percakapan grup antara 3 orang atau lebih.

SpaceType

Jenis ruang. Wajib ada saat membuat atau memperbarui ruang. Output hanya untuk penggunaan lain.

Enum
SPACE_TYPE_UNSPECIFIED Direservasi.
SPACE Tempat orang-orang mengirim pesan, berbagi file, dan berkolaborasi. SPACE dapat menyertakan aplikasi Chat.
GROUP_CHAT Percakapan grup antara 3 orang atau lebih. GROUP_CHAT dapat menyertakan aplikasi Chat.
DIRECT_MESSAGE Pesan 1:1 antara dua orang atau manusia dan aplikasi Chat.

Jenis

Tidak digunakan lagi: Sebagai gantinya, gunakan SpaceType.

Enum
TYPE_UNSPECIFIED Direservasi.
ROOM Percakapan antara dua manusia atau lebih.
DM Pesan Langsung 1:1 antara manusia dan aplikasi Chat, di mana semua pesan ditampilkan secara datar. Perhatikan bahwa ini tidak termasuk pesan langsung antara dua manusia.

SpaceBatchUpdatedEventData

Payload peristiwa untuk beberapa update pada ruang.

Jenis acara: google.workspace.chat.space.v1.batchUpdated

Kolom
spaces[]

SpaceUpdatedEventData

Daftar ruang yang diperbarui.

SpaceEvent

Peristiwa yang mewakili perubahan atau aktivitas di ruang Google Chat. Untuk mempelajari lebih lanjut, lihat Menggunakan acara dari Google Chat.

Kolom
name

string

Nama resource dari peristiwa ruang.

Format: spaces/{space}/spaceEvents/{spaceEvent}

event_time

Timestamp

Waktu saat peristiwa terjadi.

event_type

string

Jenis peristiwa ruang angkasa. Setiap jenis peristiwa memiliki versi batch, yang mewakili beberapa instance jenis peristiwa yang terjadi dalam waktu singkat. Untuk permintaan spaceEvents.list(), hapus jenis peristiwa batch dalam filter kueri Anda. Secara default, server menampilkan jenis peristiwa dan versi batch-nya.

Jenis peristiwa yang didukung untuk messages:

  • Pesan baru: google.workspace.chat.message.v1.created
  • Pesan diperbarui: google.workspace.chat.message.v1.updated
  • Pesan dihapus: google.workspace.chat.message.v1.deleted
  • Beberapa pesan baru: google.workspace.chat.message.v1.batchCreated
  • Beberapa pesan yang diperbarui: google.workspace.chat.message.v1.batchUpdated
  • Beberapa pesan dihapus: google.workspace.chat.message.v1.batchDeleted

Jenis acara yang didukung untuk langganan:

  • Keanggotaan baru: google.workspace.chat.membership.v1.created
  • Keanggotaan yang diperbarui: google.workspace.chat.membership.v1.updated
  • Langganan yang dihapus: google.workspace.chat.membership.v1.deleted
  • Beberapa keanggotaan baru: google.workspace.chat.membership.v1.batchCreated
  • Beberapa pembaruan keanggotaan: google.workspace.chat.membership.v1.batchUpdated
  • Beberapa keanggotaan yang dihapus: google.workspace.chat.membership.v1.batchDeleted

Jenis peristiwa yang didukung untuk reaksi:

  • Reaksi baru: google.workspace.chat.reaction.v1.created
  • Reaksi dihapus: google.workspace.chat.reaction.v1.deleted
  • Beberapa reaksi baru: google.workspace.chat.reaction.v1.batchCreated
  • Beberapa reaksi dihapus: google.workspace.chat.reaction.v1.batchDeleted

Jenis peristiwa yang didukung tentang ruang:

  • Ruang yang diperbarui: google.workspace.chat.space.v1.updated
  • Beberapa pembaruan ruang: google.workspace.chat.space.v1.batchUpdated

Kolom union payload.

payload hanya dapat berupa salah satu dari yang berikut:

message_created_event_data

MessageCreatedEventData

Payload peristiwa untuk pesan baru.

Jenis acara: google.workspace.chat.message.v1.created

message_updated_event_data

MessageUpdatedEventData

Payload peristiwa untuk pesan yang diperbarui.

Jenis acara: google.workspace.chat.message.v1.updated

message_deleted_event_data

MessageDeletedEventData

Payload peristiwa untuk pesan yang dihapus.

Jenis acara: google.workspace.chat.message.v1.deleted

message_batch_created_event_data

MessageBatchCreatedEventData

Payload peristiwa untuk beberapa pesan baru.

Jenis acara: google.workspace.chat.message.v1.batchCreated

message_batch_updated_event_data

MessageBatchUpdatedEventData

Payload peristiwa untuk beberapa pesan yang diperbarui.

Jenis acara: google.workspace.chat.message.v1.batchUpdated

message_batch_deleted_event_data

MessageBatchDeletedEventData

Payload peristiwa untuk beberapa pesan yang dihapus.

Jenis acara: google.workspace.chat.message.v1.batchDeleted

space_updated_event_data

SpaceUpdatedEventData

Payload peristiwa untuk update ruang.

Jenis acara: google.workspace.chat.space.v1.updated

space_batch_updated_event_data

SpaceBatchUpdatedEventData

Payload peristiwa untuk beberapa update pada ruang.

Jenis acara: google.workspace.chat.space.v1.batchUpdated

membership_created_event_data

MembershipCreatedEventData

Payload peristiwa untuk keanggotaan baru.

Jenis acara: google.workspace.chat.membership.v1.created

membership_updated_event_data

MembershipUpdatedEventData

Payload peristiwa untuk keanggotaan yang diperbarui.

Jenis acara: google.workspace.chat.membership.v1.updated

membership_deleted_event_data

MembershipDeletedEventData

Payload peristiwa untuk keanggotaan yang dihapus.

Jenis acara: google.workspace.chat.membership.v1.deleted

membership_batch_created_event_data

MembershipBatchCreatedEventData

Payload peristiwa untuk beberapa keanggotaan baru.

Jenis acara: google.workspace.chat.membership.v1.batchCreated

membership_batch_updated_event_data

MembershipBatchUpdatedEventData

Payload peristiwa untuk beberapa keanggotaan yang diperbarui.

Jenis acara: google.workspace.chat.membership.v1.batchUpdated

membership_batch_deleted_event_data

MembershipBatchDeletedEventData

Payload peristiwa untuk beberapa keanggotaan yang dihapus.

Jenis acara: google.workspace.chat.membership.v1.batchDeleted

reaction_created_event_data

ReactionCreatedEventData

Payload peristiwa untuk reaksi baru.

Jenis acara: google.workspace.chat.reaction.v1.created

reaction_deleted_event_data

ReactionDeletedEventData

Payload peristiwa untuk reaksi yang dihapus.

Jenis acara: google.workspace.chat.reaction.v1.deleted

reaction_batch_created_event_data

ReactionBatchCreatedEventData

Payload peristiwa untuk beberapa reaksi baru.

Jenis acara: google.workspace.chat.reaction.v1.batchCreated

reaction_batch_deleted_event_data

ReactionBatchDeletedEventData

Payload peristiwa untuk beberapa reaksi yang dihapus.

Jenis acara: google.workspace.chat.reaction.v1.batchDeleted

SpaceReadState

Status sudah dibaca pengguna dalam ruang, digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca.

Kolom
name

string

Nama resource dari status operasi baca ruang.

Format: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

Opsional. Waktu saat status baca ruang pengguna diperbarui. Biasanya ini berkaitan dengan stempel waktu pesan terakhir yang dibaca, atau stempel waktu yang ditentukan oleh pengguna untuk menandai posisi terakhir dibaca dalam ruang.

SpaceUpdatedEventData

Payload peristiwa untuk ruang yang diupdate.

Jenis acara: google.workspace.chat.space.v1.updated

Kolom
space

Space

Ruang yang diperbarui.

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.

Kolom
name

string

Nama resource thread.

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

thread_key

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.

ThreadReadState

Status baca pengguna dalam rangkaian pesan, digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca.

Kolom
name

string

Nama resource dari status pembacaan thread.

Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

Waktu saat status pembacaan thread pengguna diperbarui. Biasanya ini berkaitan dengan stempel waktu pesan yang terakhir dibaca dalam rangkaian pesan.

UpdateMembershipRequest

Pesan permintaan untuk memperbarui keanggotaan.

Kolom
membership

Membership

Wajib. Keanggotaan yang akan diperbarui. Hanya kolom yang ditentukan oleh update_mask yang akan diperbarui.

update_mask

FieldMask

Wajib. Jalur kolom yang akan diperbarui. Pisahkan beberapa nilai dengan koma atau gunakan * untuk memperbarui semua jalur kolom.

Jalur kolom yang didukung saat ini:

  • role
use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

UpdateMessageRequest

Permintaan untuk memperbarui pesan.

Kolom
message

Message

Wajib. Pesan dengan kolom diperbarui.

update_mask

FieldMask

Wajib. Jalur kolom yang akan diperbarui. Pisahkan beberapa nilai dengan koma atau gunakan * untuk memperbarui semua jalur kolom.

Jalur kolom yang didukung saat ini:

allow_missing

bool

Opsional. Jika true dan pesan tersebut tidak ditemukan, pesan baru akan dibuat dan updateMask akan diabaikan. ID pesan yang ditentukan harus ditetapkan klien atau permintaan gagal.

UpdateSpaceReadStateRequest

Pesan permintaan untuk UpdateSpaceReadState API.

Kolom
space_read_state

SpaceReadState

Wajib. Status operasi baca ruang dan kolom yang akan diperbarui.

Hanya mendukung pembaruan status baca untuk pengguna yang memanggil.

Untuk merujuk ke pengguna yang menelepon, tetapkan salah satu opsi berikut:

  • Alias me. Misalnya, users/me/spaces/{space}/spaceReadState.

  • Alamat email Workspace mereka. Misalnya, users/user@example.com/spaces/{space}/spaceReadState.

  • ID pengguna mereka. Misalnya, users/123456789/spaces/{space}/spaceReadState.

Format: users/{pengguna}/spaces/{space}/spaceReadState

update_mask

FieldMask

Wajib. Jalur kolom yang akan diperbarui. Jalur kolom yang didukung saat ini:

  • last_read_time

Saat last_read_time sebelum waktu pembuatan pesan terbaru, ruang akan muncul sebagai belum dibaca di UI.

Untuk menandai ruang sebagai telah dibaca, tetapkan last_read_time ke nilai mana pun nanti (lebih besar) dari waktu pembuatan pesan terbaru. last_read_time dikonversi agar cocok dengan waktu pembuatan pesan terbaru. Perhatikan bahwa status telah dibaca ruang hanya memengaruhi status telah dibaca pesan yang terlihat dalam percakapan tingkat teratas ruang. Balasan dalam thread tidak terpengaruh oleh stempel waktu ini, dan sebagai gantinya bergantung pada status pembacaan thread.

UpdateSpaceRequest

Permintaan untuk memperbarui satu ruang.

Kolom
space

Space

Wajib. Ruang dengan kolom yang akan diperbarui. Space.name harus diisi dalam bentuk spaces/{space}. Hanya kolom yang ditentukan oleh update_mask yang akan diperbarui.

update_mask

FieldMask

Wajib. Jalur kolom yang diperbarui, dipisahkan koma jika ada beberapa.

Anda dapat memperbarui kolom berikut untuk ruang:

  • space_details

  • display_name: Hanya mendukung pembaruan nama tampilan untuk ruang yang kolom spaceType-nya adalah SPACE. Jika Anda menerima pesan error ALREADY_EXISTS, coba nilai lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

  • space_type: Hanya mendukung perubahan jenis ruang GROUP_CHAT menjadi SPACE. Sertakan display_name bersama dengan space_type dalam mask update dan pastikan ruang yang ditentukan memiliki nama tampilan yang tidak kosong dan jenis ruang SPACE. Menyertakan mask space_type dan jenis SPACE di ruang yang ditentukan saat memperbarui nama tampilan bersifat opsional jika ruang yang ada sudah memiliki jenis SPACE. Mencoba memperbarui jenis spasi dengan cara lain akan menghasilkan error argumen yang tidak valid. space_type tidak didukung dengan akses admin.

  • space_history_state: Memperbarui setelan histori ruang dengan mengaktifkan atau menonaktifkan histori untuk ruang. Hanya didukung jika setelan histori diaktifkan untuk organisasi Google Workspace. Untuk memperbarui status histori ruang, Anda harus menghilangkan semua mask kolom lainnya dalam permintaan Anda. space_history_state tidak didukung dengan akses admin.

  • access_settings.audience: Memperbarui setelan akses terkait siapa saja yang dapat menemukan ruang, bergabung ke ruang, dan melihat pratinjau pesan di ruang bernama dengan kolom spaceType sebagai SPACE. Jika ruang yang ada memiliki target audiens, Anda dapat menghapus audiens dan membatasi akses ruang dengan menghilangkan nilai untuk mask kolom ini. Guna memperbarui setelan akses untuk ruang, pengguna yang mengautentikasi harus menjadi pengelola ruang dan menghilangkan semua mask kolom lainnya dalam permintaan Anda. Anda tidak dapat memperbarui kolom ini jika ruang berada dalam mode impor. Untuk mempelajari lebih lanjut, lihat Membuat ruang yang dapat ditemukan oleh pengguna tertentu. access_settings.audience tidak didukung dengan akses admin.

  • Pratinjau Developer: Mendukung perubahan setelan izin ruang, jalur kolom yang didukung meliputi: permission_settings.manage_members_and_groups, permission_settings.modify_space_details, permission_settings.toggle_history, permission_settings.use_at_mention_all, permission_settings.manage_apps, permission_settings.manage_webhooks, permission_settings.reply_messages (Peringatan: sama-sama eksklusif dengan semua jalur kolom setelan non-izin lainnya). permission_settings tidak didukung dengan akses admin.

use_admin_access

bool

Saat true, metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.

Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang.

Memerlukan cakupan OAuth 2.0 chat.admin.spaces.

Beberapa nilai FieldMask tidak didukung menggunakan akses admin. Untuk mengetahui detailnya, lihat deskripsi update_mask.

Pengguna

Pengguna di Google Chat. Saat ditampilkan sebagai output dari permintaan, jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output untuk resource User hanya mengisi name dan type pengguna.

Kolom
name

string

Nama resource untuk user Google Chat.

Format: users/{user}. users/app dapat digunakan sebagai alias untuk pengguna bot aplikasi pemanggil.

Untuk human users, {user} adalah ID pengguna yang sama dengan:

  • id untuk Person di People API. Misalnya, users/123456789 di Chat API mewakili orang yang sama dengan ID profil Orang 123456789 di People API.

  • id untuk pengguna di Admin SDK Directory API.

  • alamat email pengguna dapat digunakan sebagai alias untuk {user} di permintaan API. Misalnya, jika ID profil Person API People untuk user@example.com adalah 123456789, Anda dapat menggunakan users/user@example.com sebagai alias untuk merujuk users/123456789. Hanya nama resource kanonis (misalnya users/123456789) yang akan ditampilkan dari API.

display_name

string

Hanya output. Nama tampilan pengguna.

domain_id

string

ID unik domain Google Workspace pengguna.

type

Type

Jenis pengguna.

is_anonymous

bool

Hanya output. Saat true, pengguna dihapus atau profilnya tidak terlihat.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. JANGAN GUNAKAN.
HUMAN Pengguna manusia.
BOT Pengguna aplikasi Chat.

UserMentionMetadata

Metadata anotasi untuk sebutan pengguna (@).

Kolom
user

User

Pengguna menyebutkan.

type

Type

Jenis sebutan pengguna.

Jenis

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

WidgetMarkup

Widget adalah elemen UI yang menyajikan teks dan gambar.

Kolom
buttons[]

Button

Daftar tombol. Tombol juga berstatus oneof data dan hanya salah satu kolom ini yang perlu ditetapkan.

Kolom union data. WidgetMarkup hanya dapat memiliki salah satu item berikut. Anda dapat menggunakan beberapa kolom WidgetMarkup untuk menampilkan lebih banyak item. data hanya dapat berupa salah satu dari yang berikut:
text_paragraph

TextParagraph

Tampilkan paragraf teks dalam widget ini.

image

Image

Tampilkan gambar dalam widget ini.

key_value

KeyValue

Tampilkan item nilai kunci dalam widget ini.

Tombol

Tombol. Dapat berupa tombol teks atau tombol gambar.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang berikut:

text_button

TextButton

Tombol dengan teks dan tindakan onclick.

image_button

ImageButton

Tombol dengan gambar dan tindakan onclick.

FormAction

Tindakan formulir menjelaskan perilaku saat formulir dikirimkan. Misalnya, Anda dapat memanggil Apps Script untuk menangani formulir.

Kolom
action_method_name

string

Nama metode digunakan untuk mengidentifikasi bagian formulir mana yang memicu pengiriman formulir. Informasi ini dipantulkan kembali ke aplikasi Chat sebagai bagian dari peristiwa klik kartu. Anda dapat menggunakan nama metode yang sama untuk beberapa elemen yang memicu perilaku umum.

parameters[]

ActionParameter

Daftar parameter tindakan.

ActionParameter

Daftar parameter string yang akan disediakan saat metode tindakan dipanggil. Misalnya, pertimbangkan tiga tombol tidur sebentar: penundaan sekarang, tunda satu hari, tunda minggu depan. Anda mungkin menggunakan action method = snooze(), dengan meneruskan jenis penundaan dan waktu penundaan dalam daftar parameter string.

Kolom
key

string

Nama parameter untuk skrip tindakan.

value

string

Nilai parameter.

Ikon

Kumpulan ikon yang didukung.

Enum
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

Gambar

Gambar yang ditentukan oleh URL dan dapat memiliki tindakan onclick.

Kolom
image_url

string

URL gambar.

on_click

OnClick

Tindakan onclick.

aspect_ratio

double

Rasio aspek gambar ini (lebar dan tinggi). Kolom ini memungkinkan Anda mencadangkan tinggi yang tepat untuk gambar selagi menunggu gambar dimuat. Hal ini tidak dimaksudkan untuk mengganti rasio aspek bawaan gambar. Jika tidak disetel, server akan mengisinya dengan melakukan pengambilan data gambar.

ImageButton

Tombol gambar dengan tindakan onclick.

Kolom
on_click

OnClick

Tindakan onclick.

name

string

Nama image_button ini yang digunakan untuk aksesibilitas. Nilai default diberikan jika nama ini tidak ditentukan.

Kolom union icons. Ikon dapat ditentukan oleh Icon enum atau URL. icons hanya dapat berupa salah satu dari yang berikut:
icon

Icon

Ikon yang ditetapkan oleh enum yang menunjukkan ikon yang disediakan oleh Chat API.

icon_url

string

Ikon yang ditentukan oleh URL.

KeyValue

Elemen UI berisi kunci (label) dan nilai (konten). Elemen ini juga dapat berisi beberapa tindakan seperti tombol onclick.

Kolom
top_label

string

Teks label atas. Teks terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

content

string

Teks konten. Teks berformat didukung dan selalu diperlukan. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

content_multiline

bool

Jika konten harus multibaris.

bottom_label

string

Teks label bawah. Teks terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

on_click

OnClick

Tindakan onclick. Hanya label atas, label bawah, dan wilayah konten yang dapat diklik.

Kolom union icons. Setidaknya salah satu ikon, top_label dan bottom_label harus ditentukan. icons hanya dapat berupa salah satu dari yang berikut:
icon

Icon

Nilai enum yang diganti dengan Chat API dengan gambar ikon yang sesuai.

icon_url

string

Ikon yang ditentukan oleh URL.

Kolom union control. Widget kontrol. Anda dapat menetapkan button atau switch_widget, tetapi tidak keduanya. control hanya dapat berupa salah satu dari yang berikut:
button

Button

Tombol yang dapat diklik untuk memicu tindakan.

OnClick

Tindakan onclick (misalnya, membuka link).

Kolom

Kolom union data.

data hanya dapat berupa salah satu dari yang berikut:

action

FormAction

Tindakan formulir akan dipicu oleh tindakan onclick ini jika ditentukan.

TextButton

Tombol dengan teks dan tindakan onclick.

Kolom
text

string

Teks tombol.

on_click

OnClick

Tindakan onclick tombol.

TextParagraph

Paragraf teks. Teks terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

Kolom
text

string