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 seluruh domain. Untuk mengetahui informasi selengkapnya, lihat Mengizinkan aplikasi Google Chat untuk mengimpor data.
|
CreateCustomEmoji |
---|
Memerlukan autentikasi pengguna.
|
CreateMembership |
---|
Membuat langganan untuk aplikasi Chat yang melakukan panggilan, pengguna, atau Grup Google. Membuat langganan untuk aplikasi Chat lain tidak didukung. Saat membuat langganan, jika kebijakan penerimaan otomatis anggota yang ditentukan dinonaktifkan, anggota tersebut akan diundang, dan harus menerima undangan ruang sebelum bergabung. Jika tidak, membuat langganan akan menambahkan anggota 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 ke 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 langganan. 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 contoh, 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. Sebagai contoh, lihat Menghapus ruang. Mendukung jenis autentikasi berikut:
|
FindDirectMessage |
---|
Menampilkan pesan langsung yang 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 panggilan. 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 media API. Sebagai contoh, lihat Mendapatkan metadata tentang lampiran pesan. Memerlukan autentikasi aplikasi.
|
GetCustomEmoji |
---|
Memerlukan autentikasi pengguna.
|
GetMembership |
---|
Menampilkan detail tentang langganan. Untuk mengetahui contohnya, lihat Mendapatkan detail tentang langganan pengguna atau aplikasi Google Chat. Mendukung jenis autentikasi berikut:
|
GetMessage |
---|
Menampilkan detail tentang pesan. Untuk contohnya, lihat Mendapatkan detail tentang pesan. Mendukung jenis autentikasi berikut: Catatan: Pesan mungkin ditampilkan dari anggota atau ruang yang diblokir.
|
GetSpace |
---|
Menampilkan detail tentang ruang. Untuk contohnya, 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 peristiwa, pengguna yang diautentikasi harus menjadi anggota ruang. Sebagai contoh, lihat Mendapatkan detail acara 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. Untuk mengetahui contohnya, lihat Mendapatkan detail tentang status baca rangkaian pesan 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 di 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, responsnya 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 yang diautentikasi harus menjadi anggota ruang. Untuk contohnya, lihat Mencantumkan peristiwa dari ruang Google Chat.
|
ListSpaces |
---|
Mencantumkan ruang yang anggotanya adalah pemanggil. Chat grup dan DM tidak dicantumkan hingga pesan pertama dikirim. Untuk contoh, lihat Mencantumkan 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 dengan tepat satu keanggotaan untuk mewakili pengguna manusia. Jika satu pengguna memblokir pengguna lainnya, permintaan akan gagal dan DM tidak akan dibuat. Untuk membuat DM antara pengguna yang menelepon dan aplikasi panggilan, tetapkan Jika DM sudah ada di antara dua pengguna, meskipun salah satu pengguna memblokir pengguna lainnya pada saat permintaan dibuat, DM yang ada akan ditampilkan. Ruang dengan balasan berangkai tidak didukung. Jika Anda menerima pesan error Memerlukan autentikasi pengguna.
|
UpdateMembership |
---|
Memperbarui langganan. Misalnya, lihat Memperbarui langganan 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. Untuk mengetahui contohnya, lihat Memperbarui ruang. Jika Anda memperbarui kolom Mendukung jenis autentikasi berikut:
|
UpdateSpaceNotificationSetting |
---|
Memerlukan autentikasi pengguna.
|
UpdateSpaceReadState |
---|
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.
|
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 |
Hanya input. URL untuk pengguna untuk diautentikasi atau dikonfigurasi. (Hanya untuk |
dialog_ |
Input saja. Respons terhadap peristiwa interaksi yang terkait dengan dialog. Harus disertai dengan |
updated_ |
Input saja. Respons widget yang diperbarui. |
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 |
Memperbarui kartu pada pesan pengguna. Hal ini hanya diizinkan sebagai respons terhadap peristiwa MESSAGE dengan URL yang cocok, atau peristiwa CARD_CLICKED dengan jenis pengirim pesan HUMAN . Teks diabaikan. |
REQUEST_CONFIG |
Minta autentikasi atau konfigurasi tambahan kepada pengguna secara pribadi. |
DIALOG |
Menampilkan dialog. |
UPDATE_WIDGET |
Kueri opsi pelengkapan otomatis teks widget. |
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 untuk permintaan guna memanggil atau mengirimkan dialog.
Kolom | |
---|---|
status_ |
Kode status. |
user_ |
Pesan yang akan dikirim kepada pengguna tentang status permintaan mereka. Jika tidak disetel, pesan umum berdasarkan |
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 |
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 link yang lengkap. |
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 bersama API media 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 dalam 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 BuilderKolom | |
---|---|
card_ |
Wajib diisi 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 yang ditautkan. Format: |
thread |
Thread dari resource ruang Chat yang ditautkan. Format: |
message |
Pesan resource ruang Chat tertaut. 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 dilakukan adalah: menghapus invoice, mengirim invoice melalui email, atau membuka invoice di browser.
Tidak didukung oleh aplikasi Google Chat.
Kolom | |
---|---|
action_ |
Label yang biasa ditampilkan di item menu tindakan. |
on_ |
Tindakan onclick untuk item tindakan ini. |
CardHeader
Kolom | |
---|---|
title |
Judul harus ditetapkan. 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 properti tata letak tidak diperlukan (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 yang akan dibuat keanggotaannya. 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 tertentu untuk kolom tertentu:
Saat membuat hubungan keanggotaan untuk dirinya sendiri, aplikasi Chat harus melakukan autentikasi sebagai pengguna] dan menggunakan cakupan |
use_ |
Jika 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. Penggunaan opsi ini akan mengabaikan thread ID atau yang disertakan. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Membuat pesan sebagai balasan ke 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 bernama 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. 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
Merepresentasikan 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. Diperlukan saat emoji kustom dibuat, hanya output 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 |
Hanya input. 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. Batasan dapat berubah sewaktu-waktu. |
filename |
Wajib. Hanya input. 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 keanggotaan dalam 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 keanggotaan aplikasi dalam 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 |
Jika 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 dihapus. Nilai lainnya mungkin akan ditambahkan di masa mendatang.
Enum | |
---|---|
DELETION_TYPE_UNSPECIFIED |
Nilai ini tidak digunakan. |
CREATOR |
Pengguna menghapus pesannya sendiri. |
SPACE_OWNER |
Pemilik ruang telah 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 |
Input saja. Isi dialog, yang dirender dalam modal. Aplikasi Google Chat tidak mendukung entity kartu berikut: |
DialogAction
Berisi dialog dan kode status permintaan.
Kolom | |
---|---|
action_ |
Input saja. Status untuk permintaan guna memanggil atau mengirimkan dialog. Menampilkan status dan pesan kepada pengguna, jika diperlukan. 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 link 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 memberi reaksi pada 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
Meminta untuk mendapatkan langganan ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource langganan 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_ |
Saat Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Mendapatkan keanggotaan 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 acara ruang.
Kolom | |
---|---|
name |
Wajib. Nama resource peristiwa ruang. Format: |
GetSpaceNotificationSettingRequest
Minta pesan untuk mendapatkan setelan notifikasi ruang. Hanya mendukung mendapatkan setelan notifikasi untuk pengguna yang menelepon.
Kolom | |
---|---|
name |
Wajib. Format: users/{pengguna}/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 opsi berikut:
Format: users/{user}/spaces/{space}/spaceReadState |
GetSpaceRequest
Permintaan untuk menampilkan satu spasi.
Kolom | |
---|---|
name |
Wajib. Nama resource ruang, dalam bentuk Format: |
use_ |
Saat 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 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:
Format: pengguna/{pengguna}/ruang/{ruang}/threads/{thread}/threadReadState |
Grup
Grup Google 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 maksimum 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 berdasarkan 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: spaces/{space} |
page_ |
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 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 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. |
filter |
Opsional. Filter kueri. Anda dapat memfilter keanggotaan berdasarkan peran ( Untuk memfilter berdasarkan 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 untuk mencantumkan langganan ruang.
Kolom | |
---|---|
memberships[] |
Daftar yang tidak diurutkan. Daftar langganan 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 daftar pesan. 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 pesan daftar sebelumnya. 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 memberikan hasil yang tidak diharapkan. |
filter |
Filter kueri. Anda dapat memfilter pesan menurut tanggal ( Untuk memfilter pesan menurut 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 listingan pesan.
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 maksimum 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 berdasarkan emoji ( Untuk memfilter reaksi beberapa emoji atau pengguna, gabungkan kolom yang serupa dengan 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, diterima dari panggilan peristiwa ruang daftar sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk mencantumkan peristiwa ruang harus sesuai dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat menyebabkan hasil yang tidak terduga. |
filter |
Wajib. Filter kueri. Anda harus menentukan minimal 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 listingan 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 maksimum spasi 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 akan otomatis diubah menjadi 1.000. Nilai negatif menampilkan error |
page_ |
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 terduga. |
filter |
Opsional. Filter kueri. Anda dapat memfilter ruang menurut 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 langganan, 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 langganan, 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_ |
Opsional. Tidak dapat diubah. Waktu penghapusan keanggotaan, seperti saat anggota keluar atau dihapus 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 langganan ini. Jenis anggota lainnya mungkin didukung di 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
Merepresentasikan tindakan yang diizinkan pengguna di ruang Chat. Nilai enum lainnya mungkin ditambahkan di masa mendatang.
Enum | |
---|---|
MEMBERSHIP_ROLE_UNSPECIFIED |
Nilai default. Untuk users : mereka bukan anggota ruang, tetapi dapat diundang. Untuk Google Groups : peran ini selalu ditetapkan (nilai enum lainnya mungkin akan digunakan pada 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 di SpaceType.SPACE . |
MembershipState
Menentukan hubungan anggota dengan ruang. Status keanggotaan lainnya mungkin didukung di masa mendatang.
Enum | |
---|---|
MEMBERSHIP_STATE_UNSPECIFIED |
Nilai default. Jangan gunakan. |
JOINED |
Pengguna ditambahkan ke ruang, dan dapat berpartisipasi dalam ruang tersebut. |
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 langganan baru.
Jenis acara: google.workspace.chat.membership.v1.batchCreated
Kolom | |
---|---|
memberships[] |
Daftar keanggotaan baru. |
MembershipBatchDeletedEventData
Payload peristiwa untuk beberapa keanggotaan yang dihapus.
Jenis peristiwa: google.workspace.chat.membership.v1.batchDeleted
Kolom | |
---|---|
memberships[] |
Daftar keanggotaan yang dihapus. |
MembershipBatchUpdatedEventData
Payload peristiwa untuk beberapa keanggotaan yang diperbarui.
Jenis peristiwa: google.workspace.chat.membership.v1.batchUpdated
Kolom | |
---|---|
memberships[] |
Daftar keanggotaan yang diperbarui. |
MembershipCreatedEventData
Payload peristiwa untuk langganan baru.
Jenis peristiwa: google.workspace.chat.membership.v1.created
.
Kolom | |
---|---|
membership |
Langganan baru. |
MembershipDeletedEventData
Payload peristiwa untuk langganan yang dihapus.
Jenis acara: google.workspace.chat.membership.v1.deleted
Kolom | |
---|---|
membership |
Langganan yang dihapus. Hanya kolom |
MembershipUpdatedEventData
Payload peristiwa untuk langganan yang diperbarui.
Jenis peristiwa: google.workspace.chat.membership.v1.updated
Kolom | |
---|---|
membership |
Keanggotaan 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 kali 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 akan menghasilkan chip pratinjau. Anda juga dapat @menyebut pengguna Google Chat, atau semua orang dalam ruang. Untuk mempelajari cara membuat pesan teks, lihat Mengirim pesan. |
formatted_ |
Hanya output. Berisi pesan
Untuk informasi selengkapnya, lihat Melihat pemformatan teks yang dikirim dalam pesan |
cards[] |
Tidak digunakan lagi: Gunakan 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 pesan teks biasa. Ukuran maksimum |
cards_ |
Array kartu. Hanya aplikasi Chat yang dapat membuat kartu. Jika aplikasi Chat Anda diautentikasi sebagai pengguna, pesan tidak boleh berisi kartu. Untuk mempelajari cara membuat pesan yang berisi kartu, lihat Mengirim pesan. Desain dan pratinjau kartu dengan Card Builder. Membuka Pembuat Kartu |
annotations[] |
Hanya output. Anotasi yang terkait dengan |
thread |
Rangkaian pesan yang menyertakan pesan tersebut. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan. |
space |
Jika aplikasi Chat Anda melakukan autentikasi sebagai pengguna, output akan mengisi ruang |
fallback_ |
Deskripsi teks biasa tentang kartu pesan, yang digunakan saat kartu sebenarnya tidak dapat ditampilkan—misalnya, notifikasi seluler. |
action_ |
Input saja. 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 khusus 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 terlihat 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 dalam 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 acara: 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 acara: 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 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 acara: google.workspace.chat.reaction.v1.batchDeleted
Kolom | |
---|---|
reactions[] |
Daftar reaksi yang dihapus. |
ReactionCreatedEventData
Payload peristiwa untuk reaksi baru.
Jenis peristiwa: 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 lengkap ruang Chat. Misalnya, smart chip ruang. |
SearchSpacesRequest
Permintaan untuk menelusuri daftar ruang berdasarkan kueri.
Kolom | |
---|---|
use_ |
Jika 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 maksimum spasi 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 tersebut akan otomatis diubah menjadi 1.000. |
page_ |
Token, diterima dari panggilan ruang penelusuran sebelumnya. 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 memberikan hasil yang tidak diharapkan. |
query |
Wajib. Kueri penelusuran. Anda dapat menelusuri 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_ |
Total jumlah spasi yang cocok dengan kueri, di semua halaman. Jika hasilnya lebih dari 10.000 spasi, nilai ini adalah estimasi. |
SetUpSpaceRequest
Permintaan untuk membuat 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 antar-manusia, tetapkan Untuk membuat percakapan 1:1 antara manusia dan aplikasi Chat yang menelepon, tetapkan Jika 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. |
memberships[] |
Opsional. Pengguna atau grup Google Chat yang akan diundang untuk bergabung ke ruang. Hapus pengguna yang menelepon, karena pengguna tersebut ditambahkan secara otomatis. Set saat ini mengizinkan hingga 20 langganan (selain pemanggil). Untuk keanggotaan manusia, kolom Untuk langganan grup Google, kolom Opsional saat menetapkan Wajib jika menetapkan Wajib saat menetapkan Harus kosong saat membuat percakapan 1:1 antara manusia dan aplikasi Chat panggilan (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 |
Menambahkan 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 |
Nama resource ruang. Format: Dengan |
type |
Hanya output. Tidak digunakan lagi: Sebagai gantinya, 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 hingga 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 ruang dalam kondisi berikut:
Untuk ruang yang 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 Membuat ruang di |
create_ |
Opsional. Tidak dapat diubah. Untuk ruang yang dibuat di Chat, waktu pembuatan ruang. Kolom ini hanya output, kecuali jika digunakan di 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 |
last_ |
Hanya output. Stempel waktu pesan terakhir dalam ruang. |
admin_ |
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_ |
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 Menetapkan audiens target memerlukan autentikasi pengguna. |
AccessState
Menampilkan status akses ruang.
Enum | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Status akses tidak diketahui atau tidak didukung di 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 memberi target audiens akses ke ruang. 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 atau tidak. |
members_ |
Apakah anggota non-pengelola memiliki izin ini. |
PermissionSettings
Setelan izin yang dapat Anda tentukan saat memperbarui ruang bernama yang sudah 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 dalam 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 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 |
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 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. Diperlukan 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 antara orang dan aplikasi Chat. |
Jenis
Tidak digunakan lagi: Sebagai gantinya, gunakan SpaceType
.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Direservasi. |
ROOM |
Percakapan antara dua orang atau lebih. |
DM |
Pesan Langsung 1:1 antara manusia dan aplikasi Chat, dengan semua pesan bersifat datar. Perhatikan bahwa ini tidak termasuk pesan langsung antara dua manusia. |
SpaceBatchUpdatedEventData
Payload peristiwa untuk beberapa update pada ruang.
Jenis peristiwa: 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 angkasa. Setiap jenis peristiwa memiliki versi batch, yang mewakili beberapa instance jenis peristiwa yang terjadi dalam waktu singkat. Untuk permintaan Jenis peristiwa yang didukung untuk messages:
Jenis peristiwa 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 acara: |
message_ |
Payload peristiwa untuk pesan yang diperbarui. Jenis peristiwa: |
message_ |
Payload peristiwa untuk pesan yang dihapus. Jenis acara: |
message_ |
Payload peristiwa untuk beberapa pesan baru. Jenis acara: |
message_ |
Payload peristiwa untuk beberapa pesan yang diperbarui. Jenis peristiwa: |
message_ |
Payload peristiwa untuk beberapa pesan yang dihapus. Jenis peristiwa: |
space_ |
Payload peristiwa untuk pembaruan ruang. Jenis peristiwa: |
space_ |
Payload peristiwa untuk beberapa update pada ruang. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk langganan baru. Jenis acara: |
membership_ |
Payload peristiwa untuk langganan yang diperbarui. Jenis acara: |
membership_ |
Payload peristiwa untuk keanggotaan yang dihapus. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk beberapa keanggotaan baru. Jenis peristiwa: |
membership_ |
Payload peristiwa untuk beberapa keanggotaan yang diperbarui. Jenis acara: |
membership_ |
Payload peristiwa untuk beberapa keanggotaan yang dihapus. Jenis peristiwa: |
reaction_ |
Payload peristiwa untuk reaksi baru. Jenis peristiwa: |
reaction_ |
Payload peristiwa untuk reaksi yang dihapus. Jenis peristiwa: |
reaction_ |
Payload peristiwa untuk beberapa reaksi baru. Jenis peristiwa: |
reaction_ |
Payload peristiwa untuk beberapa reaksi yang dihapus. Jenis peristiwa: |
SpaceNotificationSetting
Setelan notifikasi pengguna dalam 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 tersebut, 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 baca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang telah dibaca dan belum dibaca.
Kolom | |
---|---|
name |
Nama resource dari status operasi 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 diupdate.
Jenis peristiwa: google.workspace.chat.space.v1.updated
Kolom | |
---|---|
space |
Ruang yang diperbarui. |
Rangkaian pesan
Rangkaian pesan di ruang Google Chat. Untuk contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.
Jika menentukan rangkaian pesan saat membuat pesan, Anda dapat menetapkan kolom messageReplyOption
untuk menentukan apa yang terjadi jika tidak ditemukan 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 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 |
ThreadReadState
Status baca pengguna dalam rangkaian pesan, yang digunakan untuk mengidentifikasi pesan yang telah 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. Langganan 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_ |
Jika 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 yang diperbarui. |
update_ |
Wajib. Jalur kolom yang akan diperbarui. Pisahkan beberapa nilai dengan koma atau gunakan Jalur kolom yang saat ini didukung:
|
allow_ |
Opsional. Jika |
UpdateSpaceNotificationSettingRequest
Permintaan untuk memperbarui setelan notifikasi ruang. Hanya mendukung pembaruan setelan notifikasi untuk pengguna yang menelepon.
Kolom | |
---|---|
space_ |
Wajib. Nama fasilitas 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 dari hal berikut:
Format: users/{user}/spaces/{space}/spaceReadState |
update_ |
Wajib. Jalur kolom yang akan diperbarui. Jalur kolom yang didukung saat ini:
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_ |
Saat 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 autentikasi sebagai pengguna, output untuk resource User
hanya akan 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. Saat |
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 menyajikan teks dan gambar.
Kolom | |
---|---|
buttons[] |
Daftar tombol. Tombol juga |
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_ |
Tampilkan paragraf teks dalam widget ini. |
image |
Menampilkan gambar di widget ini. |
key_ |
Tampilkan item nilai kunci dalam 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 tidur sebentar: penundaan sekarang, tunda satu hari, tunda minggu depan. Anda dapat 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 sambil 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_ |
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 ditetapkan 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 multibaris. |
bottom_ |
Teks label bawah. 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. |
on_ |
Tindakan |
Kolom union icons . Setidaknya salah satu ikon, top_label dan bottom_label harus ditentukan. icons hanya dapat berupa salah satu dari yang berikut: |
|
icon |
Nilai enum yang diganti oleh 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 yang berikut: |
|
button |
Tombol yang dapat diklik untuk memicu tindakan. |
OnClick
Tindakan onclick
(misalnya, membuka link).
Kolom | |
---|---|
Kolom union
|
|
action |
Tindakan formulir akan 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 cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.
Kolom | |
---|---|
text |
|