Indeks
ChatService
(antarmuka)AccessoryWidget
(pesan)ActionResponse
(pesan)ActionResponse.ResponseType
(enum)ActionResponse.SelectionItems
(pesan)ActionResponse.UpdatedWidget
(pesan)ActionStatus
(pesan)Annotation
(pesan)AnnotationType
(enum)AttachedGif
(pesan)Attachment
(pesan)Attachment.Source
(enum)AttachmentDataRef
(pesan)CardWithId
(pesan)ChatSpaceLinkData
(pesan)CompleteImportSpaceRequest
(pesan)CompleteImportSpaceResponse
(pesan)ContextualAddOnMarkup
(pesan)ContextualAddOnMarkup.Card
(pesan)ContextualAddOnMarkup.Card.CardAction
(pesan)ContextualAddOnMarkup.Card.CardHeader
(pesan)ContextualAddOnMarkup.Card.CardHeader.ImageStyle
(enum)ContextualAddOnMarkup.Card.Section
(pesan)CreateCustomEmojiRequest
(pesan)CreateMembershipRequest
(pesan)CreateMessageRequest
(pesan)CreateMessageRequest.MessageReplyOption
(enum)CreateReactionRequest
(pesan)CreateSpaceRequest
(pesan)CustomEmoji
(pesan)CustomEmoji.CustomEmojiPayload
(pesan)DeleteCustomEmojiRequest
(pesan)DeleteMembershipRequest
(pesan)DeleteMessageRequest
(pesan)DeleteReactionRequest
(pesan)DeleteSpaceRequest
(pesan)DeletionMetadata
(pesan)DeletionMetadata.DeletionType
(enum)Dialog
(pesan)DialogAction
(pesan)DriveDataRef
(pesan)DriveLinkData
(pesan)Emoji
(pesan)EmojiReactionSummary
(pesan)FindDirectMessageRequest
(pesan)GetAttachmentRequest
(pesan)GetCustomEmojiRequest
(pesan)GetMembershipRequest
(pesan)GetMessageRequest
(pesan)GetSpaceEventRequest
(pesan)GetSpaceNotificationSettingRequest
(pesan)GetSpaceReadStateRequest
(pesan)GetSpaceRequest
(pesan)GetThreadReadStateRequest
(pesan)Group
(pesan)HistoryState
(enum)ListCustomEmojisRequest
(pesan)ListCustomEmojisResponse
(pesan)ListMembershipsRequest
(pesan)ListMembershipsResponse
(pesan)ListMessagesRequest
(pesan)ListMessagesResponse
(pesan)ListReactionsRequest
(pesan)ListReactionsResponse
(pesan)ListSpaceEventsRequest
(pesan)ListSpaceEventsResponse
(pesan)ListSpacesRequest
(pesan)ListSpacesResponse
(pesan)MatchedUrl
(pesan)Membership
(pesan)Membership.MembershipRole
(enum)Membership.MembershipState
(enum)MembershipBatchCreatedEventData
(pesan)MembershipBatchDeletedEventData
(pesan)MembershipBatchUpdatedEventData
(pesan)MembershipCreatedEventData
(pesan)MembershipDeletedEventData
(pesan)MembershipUpdatedEventData
(pesan)Message
(pesan)MessageBatchCreatedEventData
(pesan)MessageBatchDeletedEventData
(pesan)MessageBatchUpdatedEventData
(pesan)MessageCreatedEventData
(pesan)MessageDeletedEventData
(pesan)MessageUpdatedEventData
(pesan)QuotedMessageMetadata
(pesan)Reaction
(pesan)ReactionBatchCreatedEventData
(pesan)ReactionBatchDeletedEventData
(pesan)ReactionCreatedEventData
(pesan)ReactionDeletedEventData
(pesan)RichLinkMetadata
(pesan)RichLinkMetadata.RichLinkType
(enum)SearchSpacesRequest
(pesan)SearchSpacesResponse
(pesan)SetUpSpaceRequest
(pesan)SlashCommand
(pesan)SlashCommandMetadata
(pesan)SlashCommandMetadata.Type
(enum)Space
(pesan)Space.AccessSettings
(pesan)Space.AccessSettings.AccessState
(enum)Space.MembershipCount
(pesan)Space.PermissionSetting
(pesan)Space.PermissionSettings
(pesan)Space.PredefinedPermissionSettings
(enum)Space.SpaceDetails
(pesan)Space.SpaceThreadingState
(enum)Space.SpaceType
(enum)Space.Type
(enum)SpaceBatchUpdatedEventData
(pesan)SpaceEvent
(pesan)SpaceNotificationSetting
(pesan)SpaceNotificationSetting.MuteSetting
(enum)SpaceNotificationSetting.NotificationSetting
(enum)SpaceReadState
(pesan)SpaceUpdatedEventData
(pesan)Thread
(pesan)ThreadReadState
(pesan)UpdateMembershipRequest
(pesan)UpdateMessageRequest
(pesan)UpdateSpaceNotificationSettingRequest
(pesan)UpdateSpaceReadStateRequest
(pesan)UpdateSpaceRequest
(pesan)User
(pesan)User.Type
(enum)UserMentionMetadata
(pesan)UserMentionMetadata.Type
(enum)WidgetMarkup
(pesan)WidgetMarkup.Button
(pesan)WidgetMarkup.FormAction
(pesan)WidgetMarkup.FormAction.ActionParameter
(pesan)WidgetMarkup.Icon
(enum)WidgetMarkup.Image
(pesan)WidgetMarkup.ImageButton
(pesan)WidgetMarkup.KeyValue
(pesan)WidgetMarkup.OnClick
(pesan)WidgetMarkup.OpenLink
(pesan)WidgetMarkup.TextButton
(pesan)WidgetMarkup.TextParagraph
(pesan)
ChatService
Memungkinkan developer membuat aplikasi dan integrasi Chat di Google Chat Platform.
CompleteImportSpace |
---|
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.
|
CreateCustomEmoji |
---|
Memerlukan autentikasi pengguna.
|
CreateMembership |
---|
Membuat keanggotaan untuk aplikasi Chat panggilan, pengguna, atau grup Google. Pembuatan keanggotaan untuk aplikasi Chat lain tidak didukung. 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. Mendukung jenis autentikasi berikut:
Untuk contoh penggunaan, lihat:
|
CreateMessage |
---|
Membuat pesan di ruang Google Chat. Untuk contoh, lihat Mengirim pesan. Metode Gambar berikut menunjukkan cara Chat mengatribusikan pesan saat Anda menggunakan autentikasi aplikasi. Chat menampilkan aplikasi Chat sebagai pengirim pesan. Konten pesan dapat berisi teks ( Gambar berikut menunjukkan cara Chat mengatribusikan pesan saat Anda menggunakan autentikasi pengguna. Chat menampilkan pengguna sebagai pengirim pesan dan mengatribusikan aplikasi Chat ke pesan dengan menampilkan namanya. Konten pesan hanya boleh berisi teks ( Ukuran pesan maksimum, termasuk konten pesan, adalah 32.000 byte.
|
CreateReaction |
---|
Membuat reaksi dan menambahkannya ke pesan. Hanya emoji unicode yang didukung. Sebagai contoh, lihat Menambahkan reaksi pada pesan. Memerlukan autentikasi pengguna.
|
CreateSpace |
---|
Membuat ruang tanpa anggota. Dapat digunakan untuk membuat ruang bernama. Ruang yang dikelompokkan menurut topik tidak didukung. Sebagai contoh, lihat Membuat ruang. Jika Anda menerima pesan error Jika Anda adalah anggota program Pratinjau Developer, Anda dapat membuat chat grup dalam mode impor menggunakan Mendukung jenis autentikasi berikut: Saat mengautentikasi sebagai aplikasi, kolom
|
DeleteCustomEmoji |
---|
Memerlukan autentikasi pengguna.
|
DeleteMembership |
---|
Menghapus keanggotaan. Untuk contohnya, lihat Menghapus pengguna atau aplikasi Google Chat dari ruang. Mendukung jenis autentikasi berikut:
|
DeleteMessage |
---|
Menghapus pesan. Untuk contoh, lihat Menghapus pesan. Mendukung jenis autentikasi berikut: Saat menggunakan autentikasi aplikasi, permintaan hanya dapat menghapus pesan yang dibuat oleh aplikasi Chat yang melakukan panggilan.
|
DeleteReaction |
---|
Menghapus reaksi terhadap pesan. Hanya emoji unicode yang didukung. Untuk mengetahui contohnya, lihat Menghapus reaksi. Memerlukan autentikasi pengguna.
|
DeleteSpace |
---|
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. Untuk contoh, lihat Menghapus ruang. Mendukung jenis autentikasi berikut:
|
FindDirectMessage |
---|
Menampilkan pesan langsung yang sudah ada dengan pengguna yang ditentukan. Jika tidak ada ruang pesan langsung yang ditemukan, error Dengan autentikasi aplikasi, menampilkan ruang pesan langsung antara pengguna yang ditentukan dan aplikasi Chat yang memanggil. Dengan autentikasi pengguna, menampilkan ruang pesan langsung antara pengguna yang ditentukan dan pengguna terautentikasi. // Mendukung jenis autentikasi berikut:
|
GetAttachment |
---|
Mendapatkan metadata lampiran pesan. Data lampiran diambil menggunakan API media. Sebagai contoh, lihat Mendapatkan metadata tentang lampiran pesan. Memerlukan autentikasi aplikasi.
|
GetCustomEmoji |
---|
Memerlukan autentikasi pengguna.
|
GetMembership |
---|
Menampilkan detail tentang langganan. Misalnya, lihat Mendapatkan detail tentang keanggotaan pengguna atau aplikasi Google Chat. Mendukung jenis autentikasi berikut:
|
GetMessage |
---|
Menampilkan detail tentang pesan. Sebagai contoh, lihat Mendapatkan detail tentang pesan. Mendukung jenis autentikasi berikut: Catatan: Mungkin menampilkan pesan dari anggota atau ruang yang diblokir.
|
GetSpace |
---|
Menampilkan detail tentang ruang. Sebagai contoh, lihat Mendapatkan detail tentang ruang. Mendukung jenis autentikasi berikut:
|
GetSpaceEvent |
---|
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 Catatan: Kolom Memerlukan autentikasi pengguna. Untuk mendapatkan acara, pengguna yang diautentikasi harus menjadi anggota ruang. Untuk mengetahui contohnya, lihat Mendapatkan detail tentang peristiwa dari ruang Google Chat.
|
GetSpaceNotificationSetting |
---|
Memerlukan autentikasi pengguna.
|
GetSpaceReadState |
---|
Menampilkan detail tentang status baca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang telah dibaca dan belum dibaca. Untuk mengetahui contohnya, lihat Mendapatkan detail tentang status baca ruang pengguna. Memerlukan autentikasi pengguna.
|
GetThreadReadState |
---|
Menampilkan detail tentang status baca pengguna dalam rangkaian pesan, yang digunakan untuk mengidentifikasi pesan yang telah dibaca dan belum dibaca. Sebagai contoh, lihat Mendapatkan detail tentang status pembacaan thread pengguna. Memerlukan autentikasi pengguna.
|
ListCustomEmojis |
---|
Memerlukan autentikasi pengguna.
|
ListMemberships |
---|
Mencantumkan keanggotaan dalam ruang. Untuk mengetahui contohnya, lihat Mencantumkan pengguna dan aplikasi Google Chat di ruang. Mencantumkan keanggotaan dengan autentikasi aplikasi akan mencantumkan keanggotaan di ruang yang dapat diakses oleh aplikasi Chat, tetapi mengecualikan keanggotaan aplikasi Chat, termasuk keanggotaan aplikasi Chat itu sendiri. Mencantumkan langganan dengan Autentikasi pengguna akan mencantumkan langganan di ruang yang dapat diakses oleh pengguna terautentikasi. Mendukung jenis autentikasi berikut:
|
ListMessages |
---|
Mencantumkan pesan dalam ruang tempat pemanggil menjadi anggota, termasuk pesan dari anggota dan ruang yang diblokir. Jika Anda mencantumkan pesan dari ruang tanpa pesan, responsnya adalah objek kosong. Saat menggunakan antarmuka REST/HTTP, respons akan berisi objek JSON kosong, Memerlukan autentikasi pengguna.
|
ListReactions |
---|
Mencantumkan reaksi terhadap pesan. Untuk mengetahui contohnya, lihat Membuat daftar reaksi untuk pesan. Memerlukan autentikasi pengguna.
|
ListSpaceEvents |
---|
Mencantumkan peristiwa dari ruang Google Chat. Untuk setiap peristiwa, payload berisi versi terbaru resource Chat. Misalnya, jika Anda mencantumkan peristiwa tentang anggota ruang baru, server akan menampilkan resource Memerlukan autentikasi pengguna. Untuk mencantumkan peristiwa, pengguna terautentikasi harus menjadi anggota ruang. Untuk contohnya, lihat Mencantumkan peristiwa dari ruang Google Chat.
|
ListSpaces |
---|
Mencantumkan ruang tempat pemanggil menjadi anggota. Chat grup dan DM tidak dicantumkan hingga pesan pertama dikirim. Sebagai contoh, lihat Daftar ruang. Mendukung jenis autentikasi berikut: Untuk menampilkan daftar semua ruang yang telah diberi nama menurut organisasi Google Workspace, gunakan metode
|
SearchSpaces |
---|
Menampilkan daftar ruang di organisasi Google Workspace berdasarkan penelusuran administrator. Memerlukan autentikasi pengguna dengan hak istimewa administrator. Dalam permintaan, tetapkan
|
SetUpSpace |
---|
Membuat ruang dan menambahkan pengguna yang ditentukan ke dalamnya. 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 Untuk menentukan grup Google yang akan ditambahkan, tambahkan keanggotaan dengan Untuk ruang bernama atau chat grup, 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 tepat satu langganan untuk mewakili pengguna manusia. Jika satu pengguna memblokir pengguna lainnya, permintaan akan gagal dan DM tidak akan dibuat. Untuk membuat DM antara pengguna yang melakukan panggilan dan aplikasi yang melakukan panggilan, tetapkan 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 Memerlukan autentikasi pengguna.
|
UpdateMembership |
---|
Memperbarui langganan. Untuk contohnya, lihat Memperbarui keanggotaan pengguna di ruang. Mendukung jenis autentikasi berikut:
|
UpdateMessage |
---|
Memperbarui pesan. Ada perbedaan antara metode Mendukung jenis autentikasi berikut: Saat menggunakan autentikasi aplikasi, permintaan hanya dapat memperbarui pesan yang dibuat oleh aplikasi Chat yang melakukan panggilan.
|
UpdateSpace |
---|
Memperbarui ruang. Sebagai contoh, lihat Memperbarui ruang. Jika Anda memperbarui kolom Mendukung jenis autentikasi berikut:
|
UpdateSpaceNotificationSetting |
---|
Memerlukan autentikasi pengguna.
|
UpdateSpaceReadState |
---|
Memperbarui status baca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang telah dibaca dan belum dibaca. Untuk contohnya, lihat Memperbarui status baca ruang pengguna. Memerlukan autentikasi pengguna.
|
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_ |
Daftar tombol. |
ActionResponse
Parameter yang dapat digunakan aplikasi Chat untuk mengonfigurasi cara responsnya diposting.
Kolom | |
---|---|
type |
Hanya input. Jenis respons aplikasi Chat. |
url |
Input saja. URL untuk pengguna untuk diautentikasi atau dikonfigurasi. (Hanya untuk |
dialog_ |
Input saja. Respons terhadap peristiwa interaksi yang terkait dengan dialog. Harus disertai dengan |
updated_ |
Hanya input. 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. Hal ini hanya diizinkan pada peristiwa CARD_CLICKED dengan jenis pengirim pesan 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[] |
Array objek SelectionItem. |
UpdatedWidget
Respons dari widget yang diupdate. Digunakan untuk memberikan opsi pelengkapan otomatis untuk widget.
Kolom | |
---|---|
widget |
ID widget yang diperbarui. ID harus cocok dengan ID untuk widget yang memicu permintaan update. |
Kolom union updated_widget . Widget diupdate sebagai respons atas tindakan pengguna. updated_widget hanya dapat berupa salah satu dari berikut: |
|
suggestions |
Daftar hasil pelengkapan otomatis widget |
ActionStatus
Merepresentasikan status permintaan untuk memanggil atau mengirimkan dialog.
Kolom | |
---|---|
status_ |
Kode status. |
user_ |
Pesan yang akan dikirim kepada pengguna tentang status permintaan mereka. Jika tidak ditetapkan, pesan umum berdasarkan |
Annotation
Hanya output. Anotasi yang terkait dengan isi teks biasa pesan. Untuk menambahkan pemformatan dasar ke pesan teks, lihat Memformat pesan teks.
Contoh isi pesan teks biasa:
Hello @FooBot how are you!"
Metadata anotasi yang sesuai:
"annotations":[{
"type":"USER_MENTION",
"startIndex":6,
"length":7,
"userMention": {
"user": {
"name":"users/{user}",
"displayName":"FooBot",
"avatarUrl":"https://goo.gl/aeDtrS",
"type":"BOT"
},
"type":"MENTION"
}
}]
Kolom | |
---|---|
type |
Jenis anotasi ini. |
length |
Panjang substring dalam isi pesan teks biasa yang sesuai dengan anotasi ini. |
start_ |
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_ |
Metadata sebutan pengguna. |
slash_ |
Metadata untuk perintah garis miring. |
rich_ |
Metadata untuk link yang kaya. |
AnnotationType
Jenis anotasi.
Enum | |
---|---|
ANNOTATION_TYPE_UNSPECIFIED |
Nilai default untuk enum. Jangan gunakan. |
USER_MENTION |
Pengguna disebutkan. |
SLASH_COMMAND |
Perintah garis miring dipanggil. |
RICH_LINK |
Anotasi rich link. |
AttachedGif
Gambar GIF yang ditentukan oleh URL.
Kolom | |
---|---|
uri |
Hanya output. URL yang menghosting gambar GIF. |
Lampiran
Lampiran di Google Chat.
Kolom | |
---|---|
name |
Nama resource lampiran, dalam bentuk |
content_ |
Hanya output. Nama file asli untuk konten, bukan jalur lengkap. |
content_ |
Hanya output. Jenis konten (jenis MIME) dari file. |
thumbnail_ |
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_ |
Hanya output. URL download yang harus digunakan untuk mengizinkan pengguna manusia mendownload lampiran. Aplikasi chat tidak boleh menggunakan URL ini untuk mendownload konten lampiran. |
source |
Hanya output. Sumber lampiran. |
Kolom union data_ref . Referensi data ke lampiran. data_ref hanya dapat berupa salah satu dari berikut: |
|
attachment_ |
Referensi ke data lampiran. Kolom ini digunakan dengan media API untuk mendownload data lampiran. |
drive_ |
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_ |
Nama resource data lampiran. Kolom ini digunakan dengan media API untuk mendownload data lampiran. |
attachment_ |
Token buram yang berisi referensi ke lampiran yang diupload. Dianggap 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 diautentikasi sebagai pengguna, pesan tidak boleh berisi kartu.
Buat desain dan lihat pratinjau kartu dengan Pembuat Kartu.
Membuka Pembuat KartuKolom | |
---|---|
card_ |
Wajib jika pesan berisi beberapa kartu. ID unik untuk kartu dalam pesan. |
card |
Kartu. Ukuran maksimum adalah 32 KB. |
ChatSpaceLinkData
Data untuk link ruang Chat.
Kolom | |
---|---|
space |
Ruang resource ruang Chat tertaut. Format: |
thread |
Thread dari resource ruang Chat yang ditautkan. Format: |
message |
Pesan resource ruang Chat yang ditautkan. Format: |
CompleteImportSpaceRequest
Pesan permintaan untuk menyelesaikan proses impor ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource ruang mode impor. Format: |
CompleteImportSpaceResponse
Pesan respons untuk menyelesaikan proses impor ruang.
Kolom | |
---|---|
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 |
Header kartu. Header biasanya berisi judul dan gambar. |
sections[] |
Bagian-bagian dipisahkan oleh pembagi garis. |
card_ |
Tindakan kartu ini. |
name |
Nama kartu. |
CardAction
Tindakan kartu adalah tindakan yang terkait dengan kartu. Untuk kartu invoice, tindakan yang umum adalah: hapus invoice, kirim invoice melalui email, atau buka invoice di browser.
Tidak didukung oleh aplikasi Google Chat.
Kolom | |
---|---|
action_ |
Label yang digunakan untuk ditampilkan di item menu tindakan. |
on_ |
Tindakan onclick untuk item tindakan ini. |
CardHeader
Kolom | |
---|---|
title |
Judul harus ditentukan. Header memiliki tinggi tetap: jika judul dan subtitel ditentukan, masing-masing akan menempati satu baris. Jika hanya judul yang ditentukan, judul akan menempati kedua baris. |
subtitle |
Subjudul header kartu. |
image_ |
Jenis gambar (misalnya, batas persegi atau batas melingkar). |
image_ |
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 tidak diperlukan properti tata letak (misalnya, float).
Kolom | |
---|---|
header |
Header bagian. Teks terformat didukung. Untuk informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
widgets[] |
Bagian harus berisi minimal satu widget. |
CreateCustomEmojiRequest
Permintaan untuk membuat emoji kustom.
Kolom | |
---|---|
custom_ |
Wajib. Emoji kustom yang akan dibuat. |
CreateMembershipRequest
Pesan permintaan untuk membuat keanggotaan.
Kolom | |
---|---|
parent |
Wajib. Nama resource ruang tempat membuat keanggotaan. Format: spasi/{space} |
membership |
Wajib. Hubungan keanggotaan yang akan dibuat. Kolom Saat membuat hubungan keanggotaan untuk pengguna manusia, aplikasi Chat harus menggunakan cakupan otorisasi tertentu dan menetapkan nilai spesifik untuk kolom tertentu:
Saat membuat hubungan keanggotaan untuk dirinya sendiri, aplikasi Chat harus melakukan autentikasi sebagai pengguna] dan menggunakan cakupan |
use_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Pembuatan keanggotaan aplikasi atau membuat keanggotaan untuk pengguna di luar organisasi Google Workspace administrator tidak didukung menggunakan akses admin. |
CreateMessageRequest
Membuat pesan.
Kolom | |
---|---|
parent |
Wajib. Nama resource ruang tempat membuat pesan. Format: |
message |
Wajib. Isi pesan. |
thread_key |
Opsional. Tidak digunakan lagi: Sebagai gantinya, gunakan |
request_ |
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_ |
Opsional. Menentukan apakah pesan memulai rangkaian pesan atau membalas rangkaian pesan. Hanya didukung di ruang yang diberi nama. |
message_ |
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 Nilai untuk kolom ini harus memenuhi persyaratan berikut:
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 yang disertakan. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Membuat pesan sebagai balasan untuk rangkaian pesan yang ditentukan oleh thread ID atau . Jika gagal, pesan akan memulai rangkaian pesan baru. |
REPLY_MESSAGE_OR_FAIL |
Membuat pesan sebagai balasan ke rangkaian pesan yang ditentukan oleh thread ID atau . 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 |
Wajib. Pesan tempat reaksi dibuat. Format: |
reaction |
Wajib. Reaksi yang akan dibuat. |
CreateSpaceRequest
Permintaan untuk membuat ruang yang telah diberi nama tanpa anggota.
Kolom | |
---|---|
space |
Wajib. Kolom Jika Anda menerima pesan error Jika Anda adalah anggota program Pratinjau Developer, Ruang |
request_ |
Opsional. ID unik untuk permintaan ini. Sebaiknya gunakan UUID acak. 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 | |
---|---|
name |
ID. Nama resource emoji kustom, yang ditetapkan oleh server. Format: |
uid |
Hanya output. Kunci unik untuk resource emoji kustom. |
emoji_ |
Tidak dapat diubah. Nama yang diberikan pengguna untuk emoji kustom, yang unik dalam organisasi. Wajib diisi saat emoji kustom dibuat, output hanya jika tidak. Nama emoji harus diawali dan diakhiri dengan titik dua, harus berupa huruf kecil, dan hanya boleh berisi karakter alfanumerik, tanda hubung, dan garis bawah. Tanda hubung dan garis bawah harus digunakan untuk memisahkan kata dan tidak dapat digunakan secara berurutan. Contoh: |
temporary_ |
Hanya output. URL gambar untuk emoji kustom, valid minimal selama 10 menit. Perhatikan bahwa ini tidak diisi dalam respons saat emoji kustom dibuat. |
payload |
Input saja. Data payload. |
CustomEmojiPayload
Data payload untuk emoji kustom.
Kolom | |
---|---|
file_ |
Wajib. Input saja. Gambar yang digunakan untuk emoji kustom. Payload harus kurang dari 256 KB dan dimensi gambar harus antara 64 dan 500 piksel. Pembatasan ini dapat berubah sewaktu-waktu. |
filename |
Wajib. Input saja. Nama file gambar. Ekstensi file yang didukung: |
DeleteCustomEmojiRequest
Permintaan untuk menghapus emoji kustom.
Kolom | |
---|---|
name |
Wajib. Nama resource emoji kustom yang akan dihapus. Format: Anda dapat menggunakan nama emoji sebagai alias untuk |
DeleteMembershipRequest
Permintaan untuk menghapus langganan di ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource dari keanggotaan yang akan dihapus. Aplikasi Chat dapat menghapus keanggotaan pengguna manusia atau keanggotaan mereka sendiri. Aplikasi Chat tidak dapat menghapus keanggotaan aplikasi lain. Saat menghapus langganan manusia, memerlukan cakupan Saat menghapus langganan aplikasi, Anda memerlukan cakupan Format: |
use_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Menghapus langganan aplikasi di ruang tidak didukung menggunakan akses admin. |
DeleteMessageRequest
Permintaan untuk menghapus pesan.
Kolom | |
---|---|
name |
Wajib. Nama resource pesan. Format: Jika telah menetapkan ID kustom untuk pesan, Anda dapat menggunakan nilai dari kolom |
force |
Saat Hanya berlaku saat mengautentikasi sebagai pengguna. Tidak berpengaruh saat melakukan autentikasi sebagai aplikasi Chat. |
DeleteReactionRequest
Menghapus reaksi terhadap pesan.
Kolom | |
---|---|
name |
Wajib. Nama reaksi yang akan dihapus. Format: |
DeleteSpaceRequest
Permintaan untuk menghapus ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource ruang yang akan dihapus. Format: |
use_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 |
DeletionMetadata
Informasi tentang pesan yang dihapus. Pesan dihapus saat delete_time
disetel.
Kolom | |
---|---|
deletion_ |
Menunjukkan siapa yang menghapus pesan. |
DeletionType
Siapa yang menghapus pesan dan bagaimana pesan tersebut dihapus. Nilai lainnya dapat ditambahkan di masa mendatang.
Enum | |
---|---|
DELETION_TYPE_UNSPECIFIED |
Nilai ini tidak digunakan. |
CREATOR |
Pengguna menghapus pesannya sendiri. |
SPACE_OWNER |
Pemilik ruang telah menghapus pesan. |
ADMIN |
Admin Google Workspace menghapus pesan tersebut. |
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 |
Input saja. Isi dialog, yang dirender dalam modal. Aplikasi Google Chat tidak mendukung entitas kartu berikut: |
DialogAction
Berisi dialog dan kode status permintaan.
Kolom | |
---|---|
action_ |
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 |
Input saja. Dialog untuk permintaan. |
DriveDataRef
Referensi ke data lampiran drive.
Kolom | |
---|---|
drive_ |
ID untuk file Drive. Gunakan dengan Drive API. |
DriveLinkData
Data untuk penautan Google Drive.
Kolom | |
---|---|
drive_ |
DriveDataRef yang mereferensikan file Google Drive. |
mime_ |
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 |
Emoji dasar yang direpresentasikan oleh string unicode. |
custom_ |
Hanya output. Emoji kustom. |
EmojiReactionSummary
Jumlah orang yang bereaksi terhadap pesan dengan emoji tertentu.
Kolom | |
---|---|
emoji |
Emoji yang terkait dengan reaksi. |
reaction_ |
Jumlah total reaksi yang menggunakan emoji terkait. |
FindDirectMessageRequest
Permintaan untuk mendapatkan ruang pesan langsung berdasarkan resource pengguna.
Kolom | |
---|---|
name |
Wajib. Nama resource pengguna untuk menemukan pesan langsung. Format: |
GetAttachmentRequest
Permintaan untuk mendapatkan lampiran.
Kolom | |
---|---|
name |
Wajib. Nama resource lampiran, dalam bentuk |
GetCustomEmojiRequest
Permintaan untuk menampilkan satu emoji kustom.
Kolom | |
---|---|
name |
Wajib. Nama resource emoji kustom. Format: Anda dapat menggunakan nama emoji sebagai alias untuk |
GetMembershipRequest
Permintaan untuk mendapatkan keanggotaan ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource dari keanggotaan yang akan diambil. Untuk mendapatkan langganan aplikasi sendiri dengan menggunakan autentikasi pengguna, Anda dapat menggunakan Format: Anda dapat menggunakan email pengguna sebagai alias untuk |
use_ |
Jika Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Mendapatkan langganan aplikasi di ruang tidak didukung saat menggunakan akses admin. |
GetMessageRequest
Permintaan untuk mendapatkan pesan.
Kolom | |
---|---|
name |
Wajib. Nama resource pesan. Format: Jika telah menetapkan ID kustom untuk pesan, Anda dapat menggunakan nilai dari kolom |
GetSpaceEventRequest
Pesan permintaan untuk mendapatkan peristiwa ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource acara ruang. Format: |
GetSpaceNotificationSettingRequest
Minta pesan untuk mendapatkan setelan notifikasi ruang. Hanya mendukung mendapatkan setelan notifikasi untuk pengguna yang menelepon.
Kolom | |
---|---|
name |
Wajib. Format: users/{user}/spaces/{space}/spaceNotificationSetting
|
GetSpaceReadStateRequest
Pesan permintaan untuk GetSpaceReadState API.
Kolom | |
---|---|
name |
Wajib. Nama resource status baca ruang yang akan diambil. Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil. Untuk merujuk ke pengguna yang menelepon, tetapkan salah satu dari hal berikut:
Format: users/{user}/spaces/{space}/spaceReadState |
GetSpaceRequest
Permintaan untuk menampilkan satu spasi.
Kolom | |
---|---|
name |
Wajib. Nama resource ruang, dalam bentuk Format: |
use_ |
Jika Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 |
GetThreadReadStateRequest
Pesan permintaan untuk GetThreadReadStateRequest API.
Kolom | |
---|---|
name |
Wajib. Nama resource status baca thread yang akan diambil. Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil. Untuk merujuk ke pengguna yang menelepon, tetapkan salah satu dari hal berikut:
Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState |
Grup
Google Grup di Google Chat.
Kolom | |
---|---|
name |
Nama resource untuk Google Grup. 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. |
ListCustomEmojisRequest
Permintaan untuk menampilkan daftar emoji kustom.
Kolom | |
---|---|
page_ |
Opsional. Jumlah maksimum emoji kustom yang ditampilkan. Layanan dapat menampilkan lebih sedikit emoji kustom dari nilai ini. Jika tidak ditentukan, nilai defaultnya adalah 25. Nilai maksimumnya adalah 200; nilai di atas 200 akan diubah menjadi 200. |
page_ |
Opsional. (Jika melanjutkan dari kueri sebelumnya.) Token halaman yang diterima dari panggilan emoji kustom daftar sebelumnya. Berikan 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 terduga. |
filter |
Opsional. Filter kueri. Mendukung pemfilteran menurut kreator. Untuk memfilter menurut kreator, Anda harus menentukan nilai yang valid. Saat ini, hanya Misalnya, kueri berikut menampilkan emoji kustom yang dibuat oleh pemanggil:
Kueri yang tidak valid ditolak oleh server dengan error |
ListCustomEmojisResponse
Respons terhadap daftar emoji kustom.
Kolom | |
---|---|
custom_ |
Daftar yang tidak diurutkan. Daftar emoji kustom di halaman yang diminta (atau pertama). |
next_ |
Token yang dapat Anda kirim sebagai |
ListMembershipsRequest
Pesan permintaan untuk keanggotaan listingan.
Kolom | |
---|---|
parent |
Wajib. Nama resource ruang tempat daftar keanggotaan akan diambil. Format: spasi/{space} |
page_ |
Opsional. Jumlah maksimum langganan yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 100 langganan akan ditampilkan. Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai tersebut akan otomatis diubah menjadi 1.000. Nilai negatif menampilkan error |
page_ |
Opsional. Token halaman, yang diterima dari panggilan sebelumnya untuk mencantumkan keanggotaan. Berikan parameter ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter lain yang diberikan harus sesuai dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat menyebabkan hasil yang tidak terduga. |
filter |
Opsional. Filter kueri. Anda dapat memfilter langganan menurut peran ( Untuk memfilter menurut peran, tetapkan Untuk memfilter menurut jenis, tetapkan Untuk memfilter menurut peran dan jenis, gunakan operator
Misalnya, kueri berikut valid:
Kueri berikut tidak valid:
Kueri yang tidak valid ditolak oleh server dengan error |
show_ |
Opsional. Jika |
show_ |
Opsional. Jika Saat ini memerlukan autentikasi pengguna. |
use_ |
Jika Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Mencantumkan keanggotaan aplikasi di ruang tidak didukung saat menggunakan akses admin. |
ListMembershipsResponse
Respons terhadap daftar keanggotaan ruang.
Kolom | |
---|---|
memberships[] |
Daftar yang tidak diurutkan. Daftar keanggotaan di halaman yang diminta (atau pertama). |
next_ |
Token yang dapat Anda kirim sebagai |
ListMessagesRequest
Mencantumkan pesan di ruang yang ditentukan, yang merupakan anggota pengguna.
Kolom | |
---|---|
parent |
Wajib. Nama resource ruang tempat pesan akan dicantumkan. Format: |
page_ |
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 tersebut akan otomatis diubah menjadi 1.000. Nilai negatif menampilkan error |
page_ |
Opsional, jika melanjutkan dari kueri sebelumnya. Token halaman yang diterima dari panggilan list messages 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 |
Filter kueri. Anda dapat memfilter pesan menurut tanggal ( Untuk memfilter pesan berdasarkan tanggal pembuatannya, tentukan Untuk memfilter menurut rangkaian pesan, tentukan Untuk memfilter menurut rangkaian pesan dan tanggal, gunakan operator Misalnya, kueri berikut valid:
Kueri yang tidak valid ditolak oleh server dengan error |
order_ |
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:
Urutan default-nya adalah |
show_ |
Apakah akan menyertakan pesan yang dihapus. Pesan yang dihapus mencakup waktu penghapusan dan metadata tentang penghapusannya, tetapi konten pesan tidak tersedia. |
ListMessagesResponse
Pesan respons untuk pesan listingan.
Kolom | |
---|---|
messages[] |
Daftar pesan. |
next_ |
Anda dapat mengirim token sebagai |
ListReactionsRequest
Mencantumkan reaksi terhadap pesan.
Kolom | |
---|---|
parent |
Wajib. Pesan yang ditanggapi pengguna. Format: |
page_ |
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_ |
Opsional. (Jika melanjutkan dari kueri sebelumnya.) Token halaman yang diterima dari panggilan list reactions sebelumnya. Berikan 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 terduga. |
filter |
Opsional. Filter kueri. Anda dapat memfilter reaksi menurut emoji ( Agar dapat memfilter reaksi untuk beberapa emoji atau pengguna, gabungkan kolom serupa menggunakan operator Untuk memfilter reaksi menurut emoji dan pengguna, gunakan operator Jika kueri Anda menggunakan Misalnya, kueri berikut valid:
Kueri berikut tidak valid:
Kueri yang tidak valid ditolak oleh server dengan error |
ListReactionsResponse
Respons terhadap permintaan reaksi daftar.
Kolom | |
---|---|
reactions[] |
Daftar reaksi di halaman yang diminta (atau pertama). |
next_ |
Token lanjutan untuk mengambil halaman hasil berikutnya. Halaman terakhir dari hasil ini kosong. |
ListSpaceEventsRequest
Pesan permintaan untuk mencantumkan acara ruang.
Kolom | |
---|---|
parent |
Wajib. Nama resource ruang Google Chat tempat peristiwa terjadi. Format: |
page_ |
Opsional. Jumlah maksimum peristiwa ruang yang ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai negatif menampilkan error |
page_ |
Token halaman, yang diterima dari panggilan peristiwa ruang daftar sebelumnya. Berikan ini untuk mengambil halaman berikutnya. 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 |
Wajib. Filter kueri. Anda harus menentukan setidaknya satu jenis peristiwa ( Atau, Anda juga dapat memfilter menurut waktu mulai (
Untuk menentukan waktu mulai atau berakhir, gunakan operator sama dengan Misalnya, kueri berikut valid:
Kueri berikut tidak valid:
Kueri yang tidak valid ditolak oleh server dengan error |
ListSpaceEventsResponse
Pesan respons untuk mencantumkan peristiwa ruang.
Kolom | |
---|---|
space_ |
Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu). Catatan: Kolom |
next_ |
Token kelanjutan yang digunakan untuk mengambil lebih banyak peristiwa. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya. |
ListSpacesRequest
Permintaan untuk mencantumkan ruang tempat pemanggil menjadi anggota.
Kolom | |
---|---|
page_ |
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 |
page_ |
Opsional. Token halaman, diterima dari panggilan list spaces 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 |
Opsional. Filter kueri. Anda dapat memfilter ruang berdasarkan jenis ruang ( Untuk memfilter menurut jenis ruang, Anda harus menentukan nilai enum yang valid, seperti Misalnya, kueri berikut valid:
Kueri yang tidak valid ditolak oleh server dengan error |
ListSpacesResponse
Respons untuk permintaan daftar ruang.
Kolom | |
---|---|
spaces[] |
Daftar ruang di halaman yang diminta (atau pertama). Catatan: Kolom |
next_ |
Anda dapat mengirim token sebagai |
MatchedUrl
URL yang cocok dalam pesan Chat. Aplikasi Chat dapat melihat pratinjau URL yang cocok. Untuk mengetahui informasi selengkapnya, lihat Pratinjau link.
Kolom | |
---|---|
url |
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 |
Nama resource keanggotaan, yang ditetapkan oleh server. Format: |
state |
Hanya output. Status keanggotaan. |
role |
Opsional. Peran pengguna dalam ruang Chat, yang menentukan tindakan yang diizinkan di ruang tersebut. Kolom ini hanya dapat digunakan sebagai input di |
create_ |
Opsional. Tidak dapat diubah. Waktu pembuatan keanggotaan, seperti saat anggota bergabung atau diundang untuk bergabung ke ruang. Kolom ini hanya output, kecuali jika digunakan untuk mengimpor langganan historis di ruang mode impor. |
delete_ |
Opsional. Tidak dapat diubah. Waktu penghapusan keanggotaan, seperti saat anggota keluar dari ruang. Kolom ini hanya output, kecuali jika digunakan untuk mengimpor langganan historis di ruang mode impor. |
Kolom union memberType . Anggota yang terkait dengan langganan ini. Jenis anggota lainnya mungkin didukung pada masa mendatang. memberType hanya dapat berupa salah satu dari berikut: |
|
member |
Pengguna atau aplikasi Google Chat yang sesuai dengan langganan. Jika aplikasi Chat Anda diautentikasi sebagai pengguna, output akan mengisi |
group_ |
Google Grup tempat keanggotaan sesuai. Membaca atau mengubah keanggotaan untuk Google Grup memerlukan autentikasi pengguna. |
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 serta 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 tidak termasuk dalam ruang dan tidak memiliki undangan yang tertunda untuk bergabung ke ruang. |
MembershipBatchCreatedEventData
Payload peristiwa untuk beberapa langganan baru.
Jenis acara: google.workspace.chat.membership.v1.batchCreated
Kolom | |
---|---|
memberships[] |
Daftar langganan baru. |
MembershipBatchDeletedEventData
Payload peristiwa untuk beberapa langganan yang dihapus.
Jenis acara: google.workspace.chat.membership.v1.batchDeleted
Kolom | |
---|---|
memberships[] |
Daftar keanggotaan yang dihapus. |
MembershipBatchUpdatedEventData
Payload peristiwa untuk beberapa langganan yang diperbarui.
Jenis peristiwa: google.workspace.chat.membership.v1.batchUpdated
Kolom | |
---|---|
memberships[] |
Daftar langganan yang diperbarui. |
MembershipCreatedEventData
Payload peristiwa untuk keanggotaan baru.
Jenis peristiwa: google.workspace.chat.membership.v1.created
.
Kolom | |
---|---|
membership |
Langganan baru. |
MembershipDeletedEventData
Payload peristiwa untuk keanggotaan yang dihapus.
Jenis acara: google.workspace.chat.membership.v1.deleted
Kolom | |
---|---|
membership |
Keanggotaan yang dihapus. Hanya kolom |
MembershipUpdatedEventData
Payload peristiwa untuk langganan yang diperbarui.
Jenis peristiwa: google.workspace.chat.membership.v1.updated
Kolom | |
---|---|
membership |
Langganan yang diperbarui. |
Pesan
Pesan di ruang Google Chat.
Kolom | |
---|---|
name |
Nama resource pesan. Format: Dengan Jika menetapkan ID kustom saat membuat pesan, Anda dapat menggunakan ID ini untuk menentukan pesan dalam permintaan dengan mengganti |
sender |
Hanya output. Pengguna yang membuat pesan. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output akan mengisi pengguna |
create_ |
Opsional. Tidak dapat diubah. Untuk ruang yang dibuat di Chat, waktu saat pesan dibuat. Kolom ini hanya output, kecuali jika digunakan di ruang mode impor. Untuk ruang mode impor, tetapkan kolom ini ke stempel waktu historis saat pesan dibuat di sumber untuk mempertahankan waktu pembuatan asli. |
last_ |
Hanya output. Waktu saat pesan terakhir diedit oleh pengguna. Jika pesan belum pernah diedit, kolom ini kosong. |
delete_ |
Hanya output. Waktu saat pesan dihapus di Google Chat. Jika pesan tidak pernah dihapus, kolom ini kosong. |
text |
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 di ruang. Untuk mempelajari cara membuat pesan teks, lihat Mengirim pesan. |
formatted_ |
Hanya output. Berisi pesan
Untuk informasi selengkapnya, baca Melihat format teks yang dikirim dalam pesan |
cards[] |
Tidak digunakan lagi: Gunakan Kartu yang kaya, berformat, dan interaktif yang dapat Anda gunakan untuk menampilkan elemen UI seperti: teks berformat, tombol, dan gambar yang dapat diklik. Kartu biasanya ditampilkan di bawah isi pesan teks biasa. Ukuran maksimum |
cards_ |
Array kartu. Hanya aplikasi Chat yang dapat membuat kartu. Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, pesan tidak dapat berisi kartu. Untuk mempelajari cara membuat pesan yang berisi kartu, lihat Mengirim pesan. Desain dan pratinjau kartu dengan Card Builder. Membuka Pembuat Kartu |
annotations[] |
Hanya output. Anotasi yang terkait dengan |
thread |
Rangkaian pesan tempat pesan berada. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan. |
space |
Jika aplikasi Chat Anda diautentikasi sebagai pengguna, output akan mengisi ruang |
fallback_ |
Deskripsi teks biasa dari kartu pesan, yang digunakan saat kartu sebenarnya tidak dapat ditampilkan—misalnya, notifikasi seluler. |
action_ |
Hanya input. Parameter yang dapat digunakan aplikasi Chat untuk mengonfigurasi cara responsnya diposting. |
argument_ |
Hanya output. Isi pesan teks biasa dengan semua sebutan aplikasi Chat dihapus. |
slash_ |
Hanya output. Informasi perintah garis miring, jika ada. |
attachment[] |
Lampiran yang diupload pengguna. |
matched_ |
Hanya output. URL di |
thread_ |
Hanya output. Jika Jika ruang tidak mendukung balasan dalam rangkaian pesan, kolom ini selalu |
client_ |
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 |
emoji_ |
Hanya output. Daftar ringkasan reaksi emoji pada pesan. |
private_ |
Tidak dapat diubah. Input untuk membuat pesan, jika tidak, hanya output. Pengguna yang dapat melihat pesan. Jika ditetapkan, pesan bersifat pribadi dan hanya dapat dilihat oleh pengguna yang ditentukan dan aplikasi Chat. Untuk menyertakan kolom ini dalam permintaan, Anda harus memanggil Chat API menggunakan autentikasi aplikasi dan menghapus hal berikut: Untuk mengetahui detailnya, lihat Mengirim pesan secara pribadi. |
deletion_ |
Hanya output. Informasi tentang pesan yang dihapus. Pesan akan dihapus saat |
quoted_ |
Hanya output. Informasi tentang pesan yang dikutip oleh pengguna Google Chat di ruang. Pengguna Google Chat dapat mengutip pesan untuk membalasnya. |
attached_ |
Hanya output. Gambar GIF yang dilampirkan ke pesan. |
accessory_ |
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 peristiwa: google.workspace.chat.message.v1.batchCreated
Kolom | |
---|---|
messages[] |
Daftar pesan baru. |
MessageBatchDeletedEventData
Payload peristiwa untuk beberapa pesan yang dihapus.
Jenis acara: google.workspace.chat.message.v1.batchDeleted
Kolom | |
---|---|
messages[] |
Daftar pesan yang dihapus. |
MessageBatchUpdatedEventData
Payload peristiwa untuk beberapa pesan yang diperbarui.
Jenis peristiwa: google.workspace.chat.message.v1.batchUpdated
Kolom | |
---|---|
messages[] |
Daftar pesan yang diperbarui. |
MessageCreatedEventData
Payload peristiwa untuk pesan baru.
Jenis peristiwa: google.workspace.chat.message.v1.created
Kolom | |
---|---|
message |
Pesan baru. |
MessageDeletedEventData
Payload peristiwa untuk pesan yang dihapus.
Jenis peristiwa: google.workspace.chat.message.v1.deleted
Kolom | |
---|---|
message |
Pesan yang dihapus. Hanya kolom |
MessageUpdatedEventData
Payload peristiwa untuk pesan yang diperbarui.
Jenis peristiwa: google.workspace.chat.message.v1.updated
Kolom | |
---|---|
message |
Pesan yang diperbarui. |
QuotedMessageMetadata
Informasi tentang pesan yang dikutip.
Kolom | |
---|---|
name |
Hanya output. Nama resource dari pesan yang dikutip. Format: |
last_ |
Hanya output. Stempel waktu saat pesan yang dikutip dibuat atau saat pesan yang dikutip terakhir diperbarui. |
Reaksi
Reaksi terhadap pesan.
Kolom | |
---|---|
name |
Nama resource reaksi. Format: |
user |
Hanya output. Pengguna yang membuat reaksi. |
emoji |
Emoji yang digunakan dalam reaksi. |
ReactionBatchCreatedEventData
Payload peristiwa untuk beberapa reaksi baru.
Jenis acara: google.workspace.chat.reaction.v1.batchCreated
Kolom | |
---|---|
reactions[] |
Daftar reaksi baru. |
ReactionBatchDeletedEventData
Payload peristiwa untuk beberapa reaksi yang dihapus.
Jenis peristiwa: google.workspace.chat.reaction.v1.batchDeleted
Kolom | |
---|---|
reactions[] |
Daftar reaksi yang dihapus. |
ReactionCreatedEventData
Payload peristiwa untuk reaksi baru.
Jenis acara: google.workspace.chat.reaction.v1.created
Kolom | |
---|---|
reaction |
Reaksi baru. |
ReactionDeletedEventData
Payload peristiwa untuk reaksi yang dihapus.
Jenis: google.workspace.chat.reaction.v1.deleted
Kolom | |
---|---|
reaction |
Reaksi yang dihapus. |
RichLinkMetadata
Link lengkap ke resource.
Kolom | |
---|---|
uri |
URI link ini. |
rich_ |
Jenis link multimedia. |
Kolom union data . Data untuk resource tertaut. data hanya dapat berupa salah satu dari berikut: |
|
drive_ |
Data untuk link drive. |
chat_ |
Data untuk link ruang chat. |
RichLinkType
Jenis link multimedia. Jenis lainnya mungkin ditambahkan di masa mendatang.
Enum | |
---|---|
RICH_LINK_TYPE_UNSPECIFIED |
Nilai default untuk enum. Jangan gunakan. |
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_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Metode ini saat ini hanya mendukung akses admin, sehingga hanya |
page_ |
Jumlah spasi maksimum yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 100 ruang akan ditampilkan. Nilai maksimumnya adalah 1.000. Jika Anda menggunakan nilai lebih dari 1.000, nilai tersebut akan otomatis diubah menjadi 1.000. |
page_ |
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 menyebabkan hasil yang tidak terduga. |
query |
Wajib. Kueri penelusuran. Anda dapat melakukan penelusuran menggunakan parameter berikut:
Di berbagai kolom, hanya operator Di antara kolom yang sama, Contoh kueri berikut valid:
|
order_ |
Opsional. Cara pengurutan daftar ruang. Atribut yang didukung untuk diurutkan adalah:
Nilai operasi pengurutan yang valid adalah:
Sintaksis yang didukung adalah:
|
SearchSpacesResponse
Respons dengan daftar ruang yang sesuai dengan permintaan ruang penelusuran.
Kolom | |
---|---|
spaces[] |
Halaman dari ruang yang diminta. |
next_ |
Token yang dapat digunakan untuk mengambil halaman berikutnya. Jika kolom ini kosong, tidak ada halaman berikutnya. |
total_ |
Jumlah total ruang yang cocok dengan kueri, di semua halaman. Jika hasilnya lebih dari 10.000 spasi, nilai ini adalah estimasi. |
SetUpSpaceRequest
Meminta pembuatan ruang dan menambahkan pengguna tertentu ke dalamnya.
Kolom | |
---|---|
space |
Wajib. Kolom Untuk membuat ruang, tetapkan Untuk membuat chat grup, tetapkan Untuk membuat percakapan 1:1 antara manusia, tetapkan Untuk membuat percakapan 1:1 antara manusia dan aplikasi Chat yang memanggil, tetapkan Jika ruang |
request_ |
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[] |
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 Untuk keanggotaan grup Google, kolom Opsional saat menetapkan Wajib saat menetapkan Wajib saat menetapkan Harus kosong saat membuat percakapan 1:1 antara manusia dan aplikasi Chat yang menelepon (saat menetapkan |
SlashCommand
Perintah garis miring di Google Chat.
Kolom | |
---|---|
command_ |
ID perintah garis miring yang dipanggil. |
SlashCommandMetadata
Metadata anotasi untuk perintah garis miring (/).
Kolom | |
---|---|
bot |
Aplikasi Chat yang perintahnya dipanggil. |
type |
Jenis perintah garis miring. |
command_ |
Nama perintah garis miring yang dipanggil. |
command_ |
ID perintah dari perintah garis miring yang dipanggil. |
triggers_ |
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 |
Memanggil 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 |
Nama resource ruang. Format: Dengan |
type |
Hanya output. Tidak digunakan lagi: Gunakan |
space_ |
Jenis ruang. Wajib saat membuat ruang atau memperbarui jenis ruang. Output hanya untuk penggunaan lain. |
single_ |
Opsional. Apakah ruang adalah DM antara aplikasi Chat dan satu orang. |
threaded |
Hanya output. Tidak digunakan lagi: Sebagai gantinya, gunakan |
display_ |
Nama tampilan ruang. Diperlukan saat membuat ruang dengan Untuk pesan langsung, kolom ini mungkin kosong. Mendukung maksimal 128 karakter. |
external_ |
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:
Untuk ruang yang sudah ada, kolom ini hanya output. |
space_ |
Hanya output. Status rangkaian pesan di ruang Chat. |
space_ |
Detail tentang ruang, termasuk deskripsi dan aturan. |
space_ |
Status histori pesan untuk pesan dan rangkaian pesan di ruang ini. |
import_ |
Opsional. Apakah ruang ini dibuat di Pembuatan ruang di |
create_ |
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 jika |
last_ |
Hanya output. Stempel waktu pesan terakhir dalam ruang. |
admin_ |
Hanya output. Untuk ruang pesan langsung (DM) dengan aplikasi Chat, apakah 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 admin, aplikasi Chat Anda harus memiliki fitur pesan langsung. |
membership_ |
Hanya output. Jumlah keanggotaan gabungan yang dikelompokkan menurut jenis anggota. Diisi saat |
access_ |
Opsional. Menentukan setelan akses ruang. Hanya diisi jika |
space_ |
Hanya output. URI untuk pengguna agar dapat mengakses ruang. |
customer |
Opsional. Tidak dapat diubah. ID pelanggan domain ruang. Hanya diperlukan saat membuat ruang dengan autentikasi aplikasi dan Dalam format Untuk DM, kolom ini tidak diisi. |
Kolom union Memerlukan autentikasi pengguna. |
|
predefined_ |
Opsional. Input saja. Setelan izin ruang yang telah ditetapkan sebelumnya, hanya masukkan saat membuat ruang. Jika kolom tidak ditetapkan, ruang kolaborasi akan dibuat. Setelah Anda membuat ruang, setelan akan diisi di kolom |
permission_ |
Opsional. Setelan izin ruang untuk ruang yang ada. Input untuk memperbarui setelan izin ruang yang tepat, dengan setelan izin yang ada diganti. Output mencantumkan setelan izin saat ini. |
AccessSettings
Merepresentasikan setelan akses ruang.
Kolom | |
---|---|
access_ |
Hanya output. Menunjukkan status akses ruang. |
audience |
Opsional. Nama resource target audiens yang dapat menemukan ruang, bergabung ke ruang, dan melihat pratinjau pesan di ruang. Jika tidak ditetapkan, hanya pengguna atau Google Grup yang telah diundang atau ditambahkan ke ruang secara terpisah yang dapat mengaksesnya. Untuk mengetahui detailnya, lihat Membuat ruang dapat ditemukan oleh audiens target. Format: Untuk menggunakan target audiens default untuk organisasi Google Workspace, tetapkan ke Membaca target audiens mendukung:
Kolom ini tidak diisi saat menggunakan cakupan Untuk menetapkan target audiens, Anda memerlukan autentikasi pengguna. |
AccessState
Merepresentasikan 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. |
DISCOVERABLE |
Pengelola ruang telah memberikan akses ke ruang kepada target audiens. Pengguna atau Google Grup yang telah ditambahkan atau diundang ke ruang satu per satu juga dapat menemukan dan mengakses ruang tersebut. Untuk mempelajari lebih lanjut, lihat Membuat ruang yang dapat ditemukan oleh pengguna tertentu. Membuat ruang yang dapat ditemukan memerlukan autentikasi pengguna. |
MembershipCount
Mewakili jumlah keanggotaan ruang, yang dikelompokkan ke dalam kategori.
Kolom | |
---|---|
joined_ |
Jumlah pengguna manusia yang telah langsung bergabung ke ruang, bukan termasuk pengguna yang bergabung dengan memiliki keanggotaan dalam grup gabungan. |
joined_ |
Jumlah semua grup yang telah bergabung langsung ke ruang. |
PermissionSetting
Merepresentasikan setelan izin ruang.
Kolom | |
---|---|
managers_ |
Apakah pengelola ruang memiliki izin ini. |
members_ |
Apakah anggota non-pengelola memiliki izin ini atau tidak. |
PermissionSettings
Setelan izin yang dapat Anda tentukan saat memperbarui ruang bernama yang ada.
Untuk menetapkan setelan izin saat membuat ruang, tentukan kolom PredefinedPermissionSettings
dalam permintaan Anda.
Kolom | |
---|---|
manage_ |
Setelan untuk mengelola anggota dan grup dalam ruang. |
modify_ |
Setelan untuk memperbarui nama, avatar, deskripsi, dan panduan ruang. |
toggle_ |
Setelan untuk mengaktifkan dan menonaktifkan histori ruang. |
use_ |
Setelan untuk menggunakan @semua di ruang. |
manage_ |
Setelan untuk mengelola aplikasi di ruang. |
manage_ |
Setelan untuk mengelola webhook di ruang. |
post_ |
Hanya output. Setelan untuk memposting pesan dalam ruang. |
reply_ |
Setelan untuk membalas pesan dalam ruang. |
PredefinedPermissionSettings
Setelan izin standar yang hanya dapat Anda tentukan saat membuat ruang yang diberi nama. Setelan lainnya mungkin ditambahkan di masa mendatang. Untuk mengetahui detail tentang setelan izin untuk ruang bernama, lihat Mempelajari ruang.
Enum | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
Tidak ditentukan. Jangan gunakan. |
COLLABORATION_SPACE |
Setelan untuk menjadikan ruang sebagai 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 |
Opsional. Deskripsi ruang. Misalnya, jelaskan topik diskusi, tujuan fungsional, atau peserta ruang. Mendukung hingga 150 karakter. |
guidelines |
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 merespons pesan, pengguna dapat membalas dalam rangkaian pesan, yang akan 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. Diperlukan saat membuat atau memperbarui ruang. Output hanya untuk penggunaan lain.
Enum | |
---|---|
SPACE_TYPE_UNSPECIFIED |
Direservasi. |
SPACE |
Tempat 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: Gunakan SpaceType
sebagai gantinya.
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[] |
Daftar ruang yang diperbarui. |
SpaceEvent
Peristiwa yang mewakili perubahan atau aktivitas di ruang Google Chat. Untuk mempelajari lebih lanjut, lihat Bekerja dengan peristiwa dari Google Chat.
Kolom | |
---|---|
name |
Nama resource dari peristiwa ruang. Format: |
event_ |
Waktu saat peristiwa terjadi. |
event_ |
Jenis peristiwa ruang. Setiap jenis peristiwa memiliki versi batch, yang mewakili beberapa instance jenis peristiwa yang terjadi dalam jangka waktu singkat. Untuk permintaan Jenis peristiwa yang didukung untuk pesan:
Jenis acara yang didukung untuk langganan:
Jenis peristiwa yang didukung untuk reaksi:
Jenis peristiwa yang didukung tentang ruang:
|
Kolom union
|
|
message_ |
Payload peristiwa untuk pesan baru. Jenis peristiwa: |
message_ |
Payload peristiwa untuk pesan yang diperbarui. Jenis acara: |
message_ |
Payload peristiwa untuk pesan yang dihapus. Jenis acara: |
message_ |
Payload peristiwa untuk beberapa pesan baru. Jenis peristiwa: |
message_ |
Payload peristiwa untuk beberapa pesan yang diperbarui. Jenis peristiwa: |
message_ |
Payload peristiwa untuk beberapa pesan yang dihapus. Jenis acara: |
space_ |
Payload peristiwa untuk pembaruan ruang. Jenis acara: |
space_ |
Payload peristiwa untuk beberapa update pada ruang. Jenis acara: |
membership_ |
Payload peristiwa untuk keanggotaan baru. Jenis acara: |
membership_ |
Payload peristiwa untuk langganan yang diperbarui. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk langganan yang dihapus. Jenis acara: |
membership_ |
Payload peristiwa untuk beberapa keanggotaan baru. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk beberapa langganan yang diperbarui. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk beberapa keanggotaan yang dihapus. Jenis peristiwa: |
reaction_ |
Payload peristiwa untuk reaksi baru. Jenis acara: |
reaction_ |
Payload peristiwa untuk reaksi yang dihapus. Jenis acara: |
reaction_ |
Payload peristiwa untuk beberapa reaksi baru. Jenis acara: |
reaction_ |
Payload peristiwa untuk beberapa reaksi yang dihapus. Jenis peristiwa: |
SpaceNotificationSetting
Setelan notifikasi pengguna di ruang.
Kolom | |
---|---|
name |
ID. Nama resource setelan notifikasi ruang. Format: |
notification_ |
Setelan notifikasi. |
mute_ |
Setelan bisukan notifikasi ruang. |
MuteSetting
Jenis setelan bisukan notifikasi ruang.
Enum | |
---|---|
MUTE_SETTING_UNSPECIFIED |
Direservasi. |
UNMUTED |
Pengguna akan menerima notifikasi untuk ruang berdasarkan setelan notifikasi. |
MUTED |
Pengguna tidak akan menerima notifikasi apa pun untuk ruang, terlepas dari setelan notifikasinya. |
NotificationSetting
Jenis setelan notifikasi.
Enum | |
---|---|
NOTIFICATION_SETTING_UNSPECIFIED |
Direservasi. |
ALL |
Notifikasi dipicu oleh @sebutan, rangkaian pesan yang diikuti, pesan pertama dari rangkaian pesan baru. Semua rangkaian pesan baru diikuti secara otomatis, kecuali jika pengguna berhenti mengikutinya secara manual. |
MAIN_CONVERSATIONS |
Notifikasi dipicu oleh @sebutan, rangkaian pesan yang diikuti, pesan pertama dari rangkaian pesan baru. Tidak tersedia untuk pesan langsung 1:1. |
FOR_YOU |
Notifikasi dipicu oleh @sebutan, rangkaian pesan yang diikuti. Tidak tersedia untuk pesan langsung 1:1. |
OFF |
Notifikasi nonaktif. |
SpaceReadState
Status sudah dibaca pengguna dalam ruang, digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca.
Kolom | |
---|---|
name |
Nama resource status baca ruang. Format: |
last_ |
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 diperbarui.
Jenis peristiwa: google.workspace.chat.space.v1.updated
Kolom | |
---|---|
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 ada rangkaian pesan yang cocok.
Kolom | |
---|---|
name |
Nama resource thread. Contoh: |
thread_ |
Opsional. Input untuk membuat atau memperbarui rangkaian pesan. Jika tidak, hanya output. ID untuk thread. Mendukung hingga 4.000 karakter. ID ini unik untuk aplikasi Chat yang menetapkannya. Misalnya, jika beberapa aplikasi Chat membuat pesan menggunakan kunci rangkaian pesan yang sama, pesan-pesan tersebut akan diposting di rangkaian pesan yang berbeda. Untuk membalas di rangkaian pesan yang dibuat oleh seseorang atau aplikasi Chat lain, tentukan kolom |
ThreadReadState
Status baca pengguna dalam rangkaian pesan, digunakan untuk mengidentifikasi pesan yang sudah dibaca dan belum dibaca.
Kolom | |
---|---|
name |
Nama resource status pembacaan thread. Format: |
last_ |
Waktu saat status pembacaan thread pengguna diperbarui. Biasanya, ini sesuai dengan stempel waktu pesan terakhir yang dibaca dalam rangkaian pesan. |
UpdateMembershipRequest
Pesan permintaan untuk memperbarui keanggotaan.
Kolom | |
---|---|
membership |
Wajib. Keanggotaan yang akan diperbarui. Hanya kolom yang ditentukan oleh |
update_ |
Wajib. Jalur kolom yang akan diperbarui. Pisahkan beberapa nilai dengan koma atau gunakan Jalur kolom yang saat ini didukung:
|
use_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 |
UpdateMessageRequest
Permintaan untuk memperbarui pesan.
Kolom | |
---|---|
message |
Wajib. Pesan dengan kolom diperbarui. |
update_ |
Wajib. Jalur kolom yang akan diperbarui. Pisahkan beberapa nilai dengan koma atau gunakan Jalur kolom yang didukung saat ini:
|
allow_ |
Opsional. Jika |
UpdateSpaceNotificationSettingRequest
Permintaan untuk memperbarui setelan notifikasi ruang. Hanya mendukung pembaruan setelan notifikasi untuk pengguna yang menelepon.
Kolom | |
---|---|
space_ |
Wajib. Nama resource untuk setelan notifikasi ruang harus diisi dalam bentuk |
update_ |
Wajib. Jalur kolom yang didukung: - |
UpdateSpaceReadStateRequest
Pesan permintaan untuk UpdateSpaceReadState API.
Kolom | |
---|---|
space_ |
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:
Format: users/{user}/spaces/{space}/spaceReadState |
update_ |
Wajib. Jalur kolom yang akan diperbarui. Jalur kolom yang saat ini didukung:
Saat Untuk menandai ruang sebagai telah dibaca, tetapkan |
UpdateSpaceRequest
Permintaan untuk memperbarui satu ruang.
Kolom | |
---|---|
space |
Wajib. Ruang dengan kolom yang akan diperbarui. |
update_ |
Wajib. Jalur kolom yang diperbarui, dipisahkan koma jika ada beberapa. Anda dapat memperbarui kolom berikut untuk ruang:
|
use_ |
Jika Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Beberapa nilai |
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 |
Nama resource untuk Format: Untuk
|
display_ |
Hanya output. Nama tampilan pengguna. |
domain_ |
ID unik domain Google Workspace pengguna. |
type |
Jenis pengguna. |
is_ |
Hanya output. Jika |
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 |
Pengguna menyebutkan. |
type |
Jenis sebutan pengguna. |
Jenis
Enum | |
---|---|
TYPE_UNSPECIFIED |
Nilai default untuk enum. Jangan gunakan. |
ADD |
Menambahkan pengguna ke ruang. |
MENTION |
Sebutkan pengguna di ruang. |
WidgetMarkup
Widget adalah elemen UI yang menampilkan teks dan gambar.
Kolom | |
---|---|
buttons[] |
Daftar tombol. Tombol juga berstatus |
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_ |
Menampilkan paragraf teks di widget ini. |
image |
Tampilkan gambar dalam widget ini. |
key_ |
Menampilkan item nilai kunci di widget ini. |
Tombol
Tombol. Dapat berupa tombol teks atau tombol gambar.
Kolom | |
---|---|
Kolom union
|
|
text_ |
Tombol dengan teks dan tindakan |
image_ |
Tombol dengan gambar dan tindakan |
FormAction
Tindakan formulir menjelaskan perilaku saat formulir dikirimkan. Misalnya, Anda dapat memanggil Apps Script untuk menangani formulir.
Kolom | |
---|---|
action_ |
Nama metode digunakan untuk mengidentifikasi bagian formulir yang memicu pengiriman formulir. Informasi ini akan ditampilkan 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[] |
Daftar parameter tindakan. |
ActionParameter
Daftar parameter string yang akan disediakan saat metode tindakan dipanggil. Misalnya, pertimbangkan tiga tombol tunda: tunda sekarang, tunda satu hari, tunda minggu depan. Anda mungkin menggunakan action method = snooze()
, yang meneruskan jenis penundaan dan waktu penundaan dalam daftar parameter string.
Kolom | |
---|---|
key |
Nama parameter untuk skrip tindakan. |
value |
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 gambar. |
on_ |
Tindakan |
aspect_ |
Rasio aspek gambar ini (lebar dan tinggi). Kolom ini memungkinkan Anda mencadangkan tinggi yang tepat untuk gambar selagi menunggu gambar dimuat. 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_ |
Tindakan |
name |
Nama |
Kolom union icons . Ikon dapat ditentukan oleh Icon enum atau URL. icons hanya dapat berupa salah satu dari hal berikut: |
|
icon |
Ikon yang ditentukan oleh |
icon_ |
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_ |
Teks label atas. Teks terformat didukung. Untuk informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
content |
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_ |
Jika konten harus berupa multibaris. |
bottom_ |
Teks label bawah. Teks berformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
on_ |
Tindakan |
Kolom union icons . Setidaknya salah satu ikon, top_label , dan bottom_label harus ditentukan. icons hanya dapat berupa salah satu dari hal berikut: |
|
icon |
Nilai enum yang diganti dengan Chat API dengan gambar ikon yang sesuai. |
icon_ |
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 hal berikut: |
|
button |
Tombol yang dapat diklik untuk memicu tindakan. |
OnClick
Tindakan onclick
(misalnya, membuka link).
Kolom | |
---|---|
Kolom union
|
|
action |
Tindakan formulir dipicu oleh tindakan |
open_ |
Tindakan |
OpenLink
Link yang membuka jendela baru.
Kolom | |
---|---|
url |
URL yang akan dibuka. |
TextButton
Tombol dengan teks dan tindakan onclick
.
Kolom | |
---|---|
text |
Teks tombol. |
on_ |
Tindakan |
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 |
|