Package google.chat.v1

Indeks

ChatService

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

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

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.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji)

Membuat emoji kustom.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

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, pembuatan langganan akan menambahkan anggota langsung ke ruang yang ditentukan.

Mendukung jenis autentikasi berikut:

Untuk contoh penggunaan, lihat:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

Membuat pesan di ruang Google Chat. Untuk contoh, lihat Mengirim pesan.

Metode create() memerlukan autentikasi pengguna atau autentikasi aplikasi. Chat mengatribusikan pengirim pesan secara berbeda, bergantung pada jenis autentikasi yang Anda gunakan dalam permintaan.

Gambar berikut menunjukkan cara Chat mengatribusikan pesan saat Anda menggunakan autentikasi aplikasi. Chat menampilkan aplikasi Chat sebagai pengirim pesan. Konten pesan dapat berisi teks (text), kartu (cardsV2), dan widget aksesori (accessoryWidgets).

Pesan dikirim dengan autentikasi aplikasi

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 (text).

Pesan dikirim dengan autentikasi pengguna

Ukuran pesan maksimum, termasuk konten pesan, adalah 32.000 byte.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

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

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

Membuat ruang tanpa anggota. Dapat digunakan untuk membuat ruang yang diberi nama. Ruang yang dikelompokkan menurut topik tidak didukung. Sebagai contoh, lihat Membuat ruang.

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

Jika Anda adalah anggota program Pratinjau Developer, Anda dapat membuat chat grup dalam mode impor menggunakan spaceType.GROUP_CHAT.

Mendukung jenis autentikasi berikut:

Saat mengautentikasi sebagai aplikasi, kolom space.customer harus ditetapkan dalam permintaan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty)

Menghapus emoji kustom.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

Menghapus keanggotaan. Untuk contohnya, lihat Menghapus pengguna atau aplikasi Google Chat dari ruang.

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

Menghapus pesan. 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.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

Menghapus reaksi terhadap pesan. Hanya emoji unicode yang didukung. Untuk contoh, lihat Menghapus reaksi.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

Menghapus ruang yang diberi nama. Selalu melakukan penghapusan beruntun, yang berarti resource turunan ruang, seperti pesan yang diposting dalam ruang dan keanggotaan dalam ruang, juga akan dihapus. Untuk contoh, lihat Menghapus ruang.

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

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

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:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji)

Menampilkan detail tentang emoji kustom.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

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

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

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.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

Menampilkan detail tentang ruang. Untuk contohnya, lihat Mendapatkan detail tentang ruang.

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

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

Catatan: Kolom permissionSettings tidak ditampilkan dalam objek Ruang data peristiwa Ruang untuk permintaan ini.

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

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

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

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

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

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

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse)

Mencantumkan emoji kustom yang terlihat oleh pengguna terautentikasi.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Mencantumkan langganan di ruang. Sebagai contoh, lihat Mencantumkan pengguna dan aplikasi Google Chat dalam 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. Keanggotaan listingan dengan Autentikasi pengguna mencantumkan keanggotaan dalam ruang yang dapat diakses oleh pengguna terautentikasi.

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

Mencantumkan pesan di ruang tempat pemanggil adalah 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, {}. Untuk contoh, lihat Mencantumkan pesan.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse)

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

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse)

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 Membership yang berisi detail keanggotaan terbaru. Jika anggota baru dihapus selama periode yang diminta, payload peristiwa akan berisi resource Membership kosong.

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

Untuk contohnya, lihat Mencantumkan peristiwa dari ruang Google Chat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse)

Mencantumkan ruang yang anggotanya adalah pemanggil. 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 spaces.search() menggunakan hak istimewa administrator Workspace.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse)

Menampilkan daftar ruang di organisasi Google Workspace berdasarkan penelusuran administrator.

Memerlukan autentikasi pengguna dengan hak istimewa administrator. Dalam permintaan, tetapkan use_admin_access ke true.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space)

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

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

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

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

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 dibuat.

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

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

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

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership)

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

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message)

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

Mendukung jenis autentikasi berikut:

Saat menggunakan autentikasi aplikasi, permintaan hanya dapat memperbarui pesan yang dibuat oleh aplikasi Chat yang melakukan panggilan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space)

Memperbarui ruang. Sebagai contoh, lihat Memperbarui ruang.

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

Mendukung jenis autentikasi berikut:

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState)

Memperbarui status baca pengguna dalam ruang, yang digunakan untuk mengidentifikasi pesan yang telah dibaca dan belum dibaca. Untuk mengetahui contohnya, lihat Memperbarui status baca ruang pengguna.

Memerlukan autentikasi pengguna.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

AccessoryWidget

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

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

ButtonList

Daftar tombol.

ActionResponse

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

Kolom
type

ResponseType

Hanya input. Jenis respons aplikasi Chat.

url

string

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

dialog_action

DialogAction

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

updated_widget

UpdatedWidget

Input saja. Respons dari widget yang diupdate.

ResponseType

Jenis respons aplikasi Chat.

Enum
TYPE_UNSPECIFIED Jenis default yang ditangani sebagai NEW_MESSAGE.
NEW_MESSAGE Posting sebagai pesan baru dalam topik.
UPDATE_MESSAGE Perbarui pesan aplikasi Chat. Ini hanya diizinkan pada peristiwa CARD_CLICKED yang jenis pengirim pesannya adalah BOT.
UPDATE_USER_MESSAGE_CARDS Perbarui kartu pada pesan pengguna. 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[]

SelectionItem

Array objek SelectionItem.

UpdatedWidget

Respons widget yang diperbarui. Digunakan untuk memberikan opsi pelengkapan otomatis untuk widget.

Kolom
widget

string

ID widget yang diperbarui. ID harus cocok dengan ID untuk widget yang memicu permintaan update.

Kolom union updated_widget. Widget diupdate sebagai respons terhadap tindakan pengguna. updated_widget hanya dapat berupa salah satu dari berikut:
suggestions

SelectionItems

Daftar hasil pelengkapan otomatis widget

ActionStatus

Merepresentasikan status permintaan untuk memanggil atau mengirimkan dialog.

Kolom
status_code

Code

Kode status.

user_facing_message

string

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

Annotation

Hanya output. Anotasi yang terkait dengan isi teks biasa pada pesan. Untuk menambahkan pemformatan dasar ke pesan teks, lihat Memformat pesan teks.

Contoh isi pesan teks biasa:

Hello @FooBot how are you!"

Metadata anotasi yang sesuai:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
Kolom
type

AnnotationType

Jenis anotasi ini.

length

int32

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

start_index

int32

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

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

UserMentionMetadata

Metadata sebutan pengguna.

slash_command

SlashCommandMetadata

Metadata untuk perintah garis miring.

AnnotationType

Jenis anotasi.

Enum
ANNOTATION_TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
USER_MENTION Pengguna disebutkan.
SLASH_COMMAND Perintah garis miring dipanggil.

AttachedGif

Gambar GIF yang ditentukan oleh URL.

Kolom
uri

string

Hanya output. URL yang menghosting gambar GIF.

Lampiran

Lampiran di Google Chat.

Kolom
name

string

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

content_name

string

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

content_type

string

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

thumbnail_uri

string

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

download_uri

string

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

source

Source

Hanya output. Sumber lampiran.

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

AttachmentDataRef

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

drive_data_ref

DriveDataRef

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

Sumber

Sumber lampiran.

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

AttachmentDataRef

Referensi ke data lampiran.

Kolom
resource_name

string

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

attachment_upload_token

string

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

CardWithId

Kartu dalam 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 Card Builder

Kolom
card_id

string

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

card

Card

Kartu. Ukuran maksimum adalah 32 KB.

ChatSpaceLinkData

Data untuk link ruang Chat.

Kolom
space

string

Ruang resource ruang Chat tertaut.

Format: spaces/{space}

thread

string

Rangkaian pesan resource ruang Chat tertaut.

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

message

string

Pesan resource ruang Chat yang ditautkan.

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

CompleteImportSpaceRequest

Pesan permintaan untuk menyelesaikan proses impor ruang.

Kolom
name

string

Wajib. Nama resource ruang mode impor.

Format: spaces/{space}

CompleteImportSpaceResponse

Pesan respons untuk menyelesaikan proses impor ruang.

Kolom
space

Space

Ruang mode impor.

ContextualAddOnMarkup

Jenis ini tidak memiliki kolom.

Markup bagi developer untuk menentukan konten AddOn kontekstual.

Kartu

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

Kolom
header

CardHeader

Header kartu. Header biasanya berisi judul dan gambar.

sections[]

Section

Bagian-bagian dipisahkan oleh pemisah garis.

card_actions[]

CardAction

Tindakan kartu ini.

name

string

Nama kartu.

CardAction

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

Tidak didukung oleh aplikasi Google Chat.

Kolom
action_label

string

Label yang biasa ditampilkan di item menu tindakan.

on_click

OnClick

Tindakan onclick untuk item tindakan ini.

CardHeader

Kolom
title

string

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

subtitle

string

Subjudul header kartu.

image_style

ImageStyle

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

image_url

string

URL gambar di header kartu.

ImageStyle

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Batas persegi.
AVATAR Batas melingkar.

Bagian

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

Kolom
header

string

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

widgets[]

WidgetMarkup

Bagian harus berisi minimal satu widget.

CreateCustomEmojiRequest

Permintaan untuk membuat emoji kustom.

Kolom
custom_emoji

CustomEmoji

Wajib. Emoji kustom yang akan dibuat.

CreateMembershipRequest

Pesan permintaan untuk membuat keanggotaan.

Kolom
parent

string

Wajib. Nama resource ruang tempat membuat keanggotaan.

Format: spaces/{space}

membership

Membership

Wajib. Hubungan keanggotaan yang akan dibuat.

Kolom memberType harus berisi pengguna dengan kolom user.name dan user.type terisi. Server akan menetapkan nama resource dan menimpa nama apa pun yang ditentukan.

Saat membuat hubungan keanggotaan untuk pengguna manusia, aplikasi Chat harus menggunakan cakupan otorisasi tertentu dan menetapkan nilai tertentu untuk kolom tertentu:

  • Saat mengautentikasi sebagai pengguna, cakupan otorisasi chat.memberships diperlukan.

  • Saat melakukan autentikasi sebagai aplikasi, cakupan otorisasi chat.app.memberships diperlukan. Autentikasi sebagai aplikasi tersedia di

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

Saat membuat hubungan keanggotaan untuk dirinya sendiri, aplikasi Chat harus melakukan autentikasi sebagai pengguna] dan menggunakan cakupan chat.memberships.app, menetapkan user.type ke BOT, dan menetapkan user.name ke users/app.

use_admin_access

bool

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

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

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

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

CreateMessageRequest

Membuat pesan.

Kolom
parent

string

Wajib. Nama resource ruang tempat membuat pesan.

Format: spaces/{space}

message

Message

Wajib. Isi pesan.

thread_key
(deprecated)

string

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

request_id

string

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

message_reply_option

MessageReplyOption

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

message_id

string

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

Nilai untuk kolom ini harus memenuhi persyaratan berikut:

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

Untuk mengetahui detailnya, lihat Memberi nama pesan.

MessageReplyOption

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

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

CreateReactionRequest

Membuat reaksi terhadap pesan.

Kolom
parent

string

Wajib. Pesan tempat reaksi dibuat.

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

reaction

Reaction

Wajib. Reaksi yang akan dibuat.

CreateSpaceRequest

Permintaan untuk membuat ruang yang telah diberi nama tanpa anggota.

Kolom
space

Space

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

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

Jika Anda adalah anggota program Pratinjau Developer, SpaceType.GROUP_CHAT dapat digunakan jika importMode disetel ke benar (true).

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

request_id

string

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

Merepresentasikan emoji kustom.

Kolom
name

string

ID. Nama resource emoji kustom, yang ditetapkan oleh server.

Format: customEmojis/{customEmoji}

uid

string

Hanya output. Kunci unik untuk resource emoji kustom.

emoji_name

string

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: :valid-emoji-name:

temporary_image_uri

string

Hanya output. URL gambar untuk emoji kustom, valid minimal selama 10 menit. Perhatikan bahwa ini tidak diisi dalam respons saat emoji kustom dibuat.

payload

CustomEmojiPayload

Hanya input. Data payload.

CustomEmojiPayload

Data payload untuk emoji kustom.

Kolom
file_content

bytes

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

string

Wajib. Input saja. Nama file gambar.

Ekstensi file yang didukung: .png, .jpg, .gif.

DeleteCustomEmojiRequest

Permintaan untuk menghapus emoji kustom.

Kolom
name

string

Wajib. Nama resource emoji kustom yang akan dihapus.

Format: customEmojis/{customEmoji}

Anda dapat menggunakan nama emoji sebagai alias untuk {customEmoji}. Misalnya, customEmojis/:example-emoji: dengan :example-emoji: adalah nama emoji untuk emoji kustom.

DeleteMembershipRequest

Permintaan untuk menghapus keanggotaan dalam ruang.

Kolom
name

string

Wajib. Nama resource dari keanggotaan yang akan dihapus. Aplikasi chat dapat menghapus langganan pengguna manusia atau langganannya sendiri. Aplikasi Chat tidak dapat menghapus keanggotaan aplikasi lain.

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

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

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

use_admin_access

bool

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

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

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

Menghapus keanggotaan aplikasi dalam ruang tidak didukung menggunakan akses admin.

DeleteMessageRequest

Permintaan untuk menghapus pesan.

Kolom
name

string

Wajib. Nama resource pesan.

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

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

force

bool

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

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

DeleteReactionRequest

Menghapus reaksi terhadap pesan.

Kolom
name

string

Wajib. Nama reaksi yang akan dihapus.

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

DeleteSpaceRequest

Permintaan untuk menghapus ruang.

Kolom
name

string

Wajib. Nama resource ruang yang akan dihapus.

Format: spaces/{space}

use_admin_access

bool

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

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

Memerlukan cakupan OAuth 2.0 chat.admin.delete.

DeletionMetadata

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

Kolom
deletion_type

DeletionType

Menunjukkan siapa yang menghapus pesan.

DeletionType

Siapa yang menghapus pesan dan bagaimana pesan tersebut dihapus. Nilai lainnya mungkin akan ditambahkan di masa mendatang.

Enum
DELETION_TYPE_UNSPECIFIED Nilai ini tidak digunakan.
CREATOR Pengguna menghapus pesannya sendiri.
SPACE_OWNER Pemilik ruang menghapus pesan.
ADMIN Admin Google Workspace menghapus pesan 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

Card

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

DialogAction

Berisi dialog dan kode status permintaan.

Kolom
action_status

ActionStatus

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

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

Dialog

Input saja. Dialog untuk permintaan.

DriveDataRef

Referensi ke data lampiran drive.

Kolom
drive_file_id

string

ID untuk file Drive. Gunakan dengan Drive API.

DriveLinkData

Data untuk link Google Drive.

Kolom
drive_data_ref

DriveDataRef

DriveDataRef yang mereferensikan file Google Drive.

mime_type

string

Jenis mime resource Google Drive tertaut.

Emoji

Emoji yang digunakan sebagai reaksi terhadap pesan.

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

string

Emoji dasar yang direpresentasikan oleh string unicode.

custom_emoji

CustomEmoji

Hanya output. Emoji kustom.

EmojiReactionSummary

Jumlah orang yang memberi reaksi pada pesan dengan emoji tertentu.

Kolom
emoji

Emoji

Emoji yang terkait dengan reaksi.

reaction_count

int32

Jumlah total reaksi yang menggunakan emoji terkait.

FindDirectMessageRequest

Permintaan untuk mendapatkan ruang pesan langsung berdasarkan resource pengguna.

Kolom
name

string

Wajib. Nama resource pengguna yang akan dilihat pesan langsungnya.

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

GetAttachmentRequest

Permintaan untuk mendapatkan lampiran.

Kolom
name

string

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

GetCustomEmojiRequest

Permintaan untuk menampilkan satu emoji kustom.

Kolom
name

string

Wajib. Nama resource emoji kustom.

Format: customEmojis/{customEmoji}

Anda dapat menggunakan nama emoji sebagai alias untuk {customEmoji}. Misalnya, customEmojis/:example-emoji: dengan :example-emoji: adalah nama emoji untuk emoji kustom.

GetMembershipRequest

Meminta untuk mendapatkan langganan ruang.

Kolom
name

string

Wajib. Nama resource dari keanggotaan yang akan diambil.

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

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

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

use_admin_access

bool

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

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

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

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

GetMessageRequest

Permintaan untuk mendapatkan pesan.

Kolom
name

string

Wajib. Nama resource pesan.

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

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

GetSpaceEventRequest

Pesan permintaan untuk mendapatkan acara ruang.

Kolom
name

string

Wajib. Nama resource peristiwa ruang.

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

GetSpaceReadStateRequest

Pesan permintaan untuk GetSpaceReadState API.

Kolom
name

string

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

Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil.

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

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

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

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

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

GetSpaceRequest

Permintaan untuk menampilkan satu ruang.

Kolom
name

string

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

Format: spaces/{space}

use_admin_access

bool

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

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

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

GetThreadReadStateRequest

Pesan permintaan untuk GetThreadReadStateRequest API.

Kolom
name

string

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

Hanya mendukung mendapatkan status baca untuk pengguna yang memanggil.

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

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

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

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

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

Grup

Grup Google di Google Chat.

Kolom
name

string

Nama resource untuk 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 pesan dan rangkaian pesan disimpan.

ListCustomEmojisRequest

Permintaan untuk menampilkan daftar emoji kustom.

Kolom
page_size

int32

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_token

string

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

string

Opsional. Filter kueri.

Mendukung pemfilteran berdasarkan kreator.

Untuk memfilter menurut kreator, Anda harus menentukan nilai yang valid. Saat ini, hanya creator("users/me") dan NOT creator("users/me") yang diterima untuk memfilter emoji kustom berdasarkan apakah emoji tersebut dibuat oleh pengguna yang melakukan panggilan atau tidak.

Misalnya, kueri berikut menampilkan emoji kustom yang dibuat oleh pemanggil:

creator("users/me")

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListCustomEmojisResponse

Respons terhadap daftar emoji kustom.

Kolom
custom_emojis[]

CustomEmoji

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

next_page_token

string

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

ListMembershipsRequest

Pesan permintaan untuk keanggotaan listingan.

Kolom
parent

string

Wajib. Nama resource ruang yang akan mengambil daftar keanggotaan.

Format: spaces/{space}

page_size

int32

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

Jika tidak ditentukan, maksimal 100 langganan yang ditampilkan.

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

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Opsional. Token halaman, diterima dari panggilan sebelumnya untuk mencantumkan langganan. 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

string

Opsional. Filter kueri.

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

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

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

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

member.type = "HUMAN" atau member.type != "BOT" diperlukan saat use_admin_access ditetapkan ke benar. Filter jenis anggota lainnya akan ditolak.

Misalnya, kueri berikut valid:

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

member.type != "BOT"

Kueri berikut tidak valid:

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

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

show_groups

bool

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

show_invited

bool

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

Saat ini memerlukan autentikasi pengguna.

use_admin_access

bool

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

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

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

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

ListMembershipsResponse

Respons untuk mencantumkan langganan ruang.

Kolom
memberships[]

Membership

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

next_page_token

string

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

ListMessagesRequest

Mencantumkan pesan di ruang yang ditentukan tempat pengguna menjadi anggota.

Kolom
parent

string

Wajib. Nama resource ruang tempat pesan akan dicantumkan.

Format: spaces/{space}

page_size

int32

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

Jika tidak ditentukan, maksimal 25 akan ditampilkan.

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

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

Opsional, jika melanjutkan dari kueri sebelumnya.

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

Saat 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

string

Filter kueri.

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

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

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

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

Misalnya, kueri berikut valid:

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

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

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

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

thread.name = spaces/AAAAAAAAAAA/threads/123

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

order_by

string

Opsional, jika melanjutkan dari kueri sebelumnya.

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

  • ASC untuk menaik.

  • DESC untuk menurun.

Urutan default-nya adalah create_time ASC.

show_deleted

bool

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

ListMessagesResponse

Pesan respons untuk listingan pesan.

Kolom
messages[]

Message

Daftar pesan.

next_page_token

string

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

ListReactionsRequest

Mencantumkan reaksi terhadap pesan.

Kolom
parent

string

Wajib. Pesan yang diberi reaksi oleh pengguna.

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

page_size

int32

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

page_token

string

Opsional. (Jika melanjutkan dari kueri sebelumnya.)

Token halaman yang diterima dari panggilan reaksi daftar sebelumnya. Berikan 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

string

Opsional. Filter kueri.

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

Untuk memfilter reaksi beberapa emoji atau pengguna, gabungkan kolom yang serupa dengan operator OR, seperti emoji.unicode = "🙂" OR emoji.unicode = "👍" dan user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

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

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

Misalnya, kueri berikut valid:

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

Kueri berikut tidak valid:

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

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListReactionsResponse

Respons terhadap permintaan reaksi daftar.

Kolom
reactions[]

Reaction

Daftar reaksi di halaman yang diminta (atau pertama).

next_page_token

string

Token lanjutan untuk mengambil halaman hasil berikutnya. Kolom ini kosong untuk halaman hasil terakhir.

ListSpaceEventsRequest

Pesan permintaan untuk listingan acara ruang.

Kolom
parent

string

Wajib. Nama resource ruang Google Chat tempat peristiwa terjadi.

Format: spaces/{space}.

page_size

int32

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

Nilai negatif menampilkan error INVALID_ARGUMENT.

page_token

string

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

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

filter

string

Wajib. Filter kueri.

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

Secara opsional, Anda juga dapat memfilter berdasarkan waktu mulai (start_time) dan waktu berakhir (end_time):

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

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

Misalnya, kueri berikut valid:

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

Kueri berikut tidak valid:

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

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListSpaceEventsResponse

Pesan respons untuk listingan peristiwa ruang.

Kolom
space_events[]

SpaceEvent

Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu). Catatan: Kolom permissionSettings tidak ditampilkan dalam objek Ruang untuk permintaan daftar.

next_page_token

string

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_size

int32

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 INVALID_ARGUMENT.

page_token

string

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 terduga.

filter

string

Opsional. Filter kueri.

Anda dapat memfilter ruang berdasarkan jenis ruang (space_type).

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

Misalnya, kueri berikut valid:

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

Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.

ListSpacesResponse

Respons untuk permintaan daftar ruang.

Kolom
spaces[]

Space

Daftar spasi di halaman yang diminta (atau pertama). Catatan: Kolom permissionSettings tidak ditampilkan dalam objek Ruang untuk permintaan daftar.

next_page_token

string

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

MatchedUrl

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

Kolom
url

string

Hanya output. URL yang cocok.

Langganan

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

Kolom
name

string

Nama resource keanggotaan, yang ditetapkan oleh server.

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

state

MembershipState

Hanya output. Status keanggotaan.

role

MembershipRole

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

Kolom ini hanya dapat digunakan sebagai input di UpdateMembership.

create_time

Timestamp

Opsional. Tidak dapat diubah. Waktu pembuatan 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_time

Timestamp

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 pada masa mendatang. memberType hanya dapat berupa salah satu dari berikut:
member

User

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

group_member

Group

Grup Google yang sesuai dengan keanggotaan.

Membaca atau mengubah keanggotaan untuk Google Grup memerlukan autentikasi pengguna.

MembershipRole

Merepresentasikan 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 1:1 dan percakapan grup tanpa nama, semua orang memiliki peran ini.
ROLE_MANAGER Pengelola ruang. Pengguna memiliki semua izin dasar ditambah izin administratif yang memungkinkan mereka mengelola ruang, seperti menambahkan atau menghapus anggota. Hanya didukung dalam bahasa SpaceType.SPACE.

MembershipState

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

Enum
MEMBERSHIP_STATE_UNSPECIFIED Nilai default. Jangan gunakan.
JOINED Pengguna ditambahkan ke ruang, dan dapat berpartisipasi dalam ruang 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[]

MembershipCreatedEventData

Daftar keanggotaan baru.

MembershipBatchDeletedEventData

Payload peristiwa untuk beberapa langganan yang dihapus.

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

Kolom
memberships[]

MembershipDeletedEventData

Daftar keanggotaan yang dihapus.

MembershipBatchUpdatedEventData

Payload peristiwa untuk beberapa langganan yang diperbarui.

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

Kolom
memberships[]

MembershipUpdatedEventData

Daftar keanggotaan yang diperbarui.

MembershipCreatedEventData

Payload peristiwa untuk langganan baru.

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

Kolom
membership

Membership

Langganan baru.

MembershipDeletedEventData

Payload peristiwa untuk keanggotaan yang dihapus.

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

Kolom
membership

Membership

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

MembershipUpdatedEventData

Payload peristiwa untuk langganan yang diperbarui.

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

Kolom
membership

Membership

Keanggotaan yang diperbarui.

Pesan

Pesan di ruang Google Chat.

Kolom
name

string

Nama resource pesan.

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

Dengan {space} adalah ID ruang tempat pesan diposting dan {message} adalah ID yang ditetapkan sistem untuk pesan tersebut. Misalnya, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Jika menetapkan ID kustom saat membuat pesan, Anda dapat menggunakan ID ini untuk menentukan pesan dalam permintaan dengan mengganti {message} dengan nilai dari kolom clientAssignedMessageId. Misalnya, spaces/AAAAAAAAAAA/messages/client-custom-name. Untuk mengetahui detailnya, lihat Memberi nama pesan.

sender

User

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

create_time

Timestamp

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

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

last_update_time

Timestamp

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

delete_time

Timestamp

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

text

string

Isi teks biasa pesan. Link pertama ke gambar, video, atau halaman web akan 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_text

string

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

  • Sintaksis markup untuk cetak tebal, miring, coret, monospace, blok monospace, dan daftar berbutir.

  • Sebutan pengguna menggunakan format <users/{user}>.

  • Hyperlink kustom menggunakan format <{url}|{rendered_text}> dengan string pertama adalah URL dan string kedua adalah teks yang dirender—misalnya, <http://example.com|custom text>.

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

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

cards[]
(deprecated)

Card

Tidak digunakan lagi: Sebagai gantinya, gunakan cards_v2.

Kartu lengkap, berformat, dan interaktif yang dapat Anda gunakan untuk menampilkan elemen UI seperti: teks berformat, tombol, dan gambar yang dapat diklik. Kartu biasanya ditampilkan di bawah isi teks biasa pada pesan. cards dan cards_v2 dapat memiliki ukuran maksimum 32 KB.

cards_v2[]

CardWithId

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.

Buat desain dan lihat pratinjau kartu dengan Pembuat Kartu.

Membuka Card Builder

annotations[]

Annotation

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

thread

Thread

Rangkaian pesan yang menyertakan pesan tersebut. Untuk contoh penggunaan, lihat Memulai atau membalas rangkaian pesan.

space

Space

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

fallback_text

string

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

action_response

ActionResponse

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

argument_text

string

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

slash_command

SlashCommand

Hanya output. Informasi perintah garis miring, jika ada.

attachment[]

Attachment

Lampiran yang diupload pengguna.

matched_url

MatchedUrl

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

thread_reply

bool

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

Jika ruang tidak mendukung balasan dalam rangkaian pesan, kolom ini selalu false.

client_assigned_message_id

string

Opsional. ID kustom untuk pesan. Anda dapat menggunakan kolom untuk mengidentifikasi pesan, atau untuk mendapatkan, menghapus, atau memperbarui pesan. Untuk menetapkan ID kustom, tentukan kolom messageId saat Anda membuat pesan. Untuk mengetahui detailnya, lihat Memberi nama pesan.

emoji_reaction_summaries[]

EmojiReactionSummary

Hanya output. Daftar ringkasan reaksi emoji pada pesan.

private_message_viewer

User

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

DeletionMetadata

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

quoted_message_metadata

QuotedMessageMetadata

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

attached_gifs[]

AttachedGif

Hanya output. Gambar GIF yang dilampirkan ke pesan.

accessory_widgets[]

AccessoryWidget

Satu atau beberapa widget interaktif yang muncul di bagian bawah pesan. Anda dapat menambahkan widget aksesori ke pesan yang berisi teks, kartu, atau teks dan kartu. Tidak didukung untuk pesan yang berisi dialog. Untuk mengetahui detailnya, lihat Menambahkan widget interaktif di bagian bawah pesan.

Membuat pesan dengan widget aksesori memerlukan autentikasi aplikasi.

MessageBatchCreatedEventData

Payload peristiwa untuk beberapa pesan baru.

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

Kolom
messages[]

MessageCreatedEventData

Daftar pesan baru.

MessageBatchDeletedEventData

Payload peristiwa untuk beberapa pesan yang dihapus.

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

Kolom
messages[]

MessageDeletedEventData

Daftar pesan yang dihapus.

MessageBatchUpdatedEventData

Payload peristiwa untuk beberapa pesan yang diperbarui.

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

Kolom
messages[]

MessageUpdatedEventData

Daftar pesan yang diperbarui.

MessageCreatedEventData

Payload peristiwa untuk pesan baru.

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

Kolom
message

Message

Pesan baru.

MessageDeletedEventData

Payload peristiwa untuk pesan yang dihapus.

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

Kolom
message

Message

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

MessageUpdatedEventData

Payload peristiwa untuk pesan yang diperbarui.

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

Kolom
message

Message

Pesan yang diperbarui.

QuotedMessageMetadata

Informasi tentang pesan yang dikutip.

Kolom
name

string

Hanya output. Nama resource dari pesan yang dikutip.

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

last_update_time

Timestamp

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

Reaksi

Reaksi terhadap pesan.

Kolom
name

string

Nama resource reaksi.

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

user

User

Hanya output. Pengguna yang membuat reaksi.

emoji

Emoji

Emoji yang digunakan dalam reaksi.

ReactionBatchCreatedEventData

Payload peristiwa untuk beberapa reaksi baru.

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

Kolom
reactions[]

ReactionCreatedEventData

Daftar reaksi baru.

ReactionBatchDeletedEventData

Payload peristiwa untuk beberapa reaksi yang dihapus.

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

Kolom
reactions[]

ReactionDeletedEventData

Daftar reaksi yang dihapus.

ReactionCreatedEventData

Payload peristiwa untuk reaksi baru.

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

Kolom
reaction

Reaction

Reaksi baru.

ReactionDeletedEventData

Payload peristiwa untuk reaksi yang dihapus.

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

Kolom
reaction

Reaction

Reaksi yang dihapus.

RichLinkMetadata

Link lengkap ke resource.

Kolom
uri

string

URI link ini.

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

RichLinkType

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

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

SearchSpacesRequest

Permintaan untuk menelusuri daftar ruang berdasarkan kueri.

Kolom
use_admin_access

bool

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

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

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

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

page_size

int32

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

Jika tidak ditentukan, maksimal 100 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

string

Token, yang 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

string

Wajib. Kueri penelusuran.

Anda dapat menelusuri menggunakan parameter berikut:

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

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

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

display_name hanya menerima operator HAS (:). Teks yang akan dicocokkan pertama-tama akan ditokenisasi menjadi token dan setiap token dicocokkan dengan awalan tanpa mempertimbangkan huruf besar/kecil dan secara independen sebagai substring di mana saja dalam display_name ruang. Misalnya, Fun Eve cocok dengan Fun event atau The evening was fun, tetapi tidak dengan notFun event atau even.

external_user_allowed menerima true atau false.

space_history_state hanya menerima nilai dari kolom historyState dari resource space.

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

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

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

Contoh kueri berikut valid:

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

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

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

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

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

string

Opsional. Cara daftar ruang diurutkan.

Atribut yang didukung untuk diurutkan adalah:

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

Nilai operasi pengurutan yang valid adalah:

  • ASC untuk menaik. Nilai default.

  • DESC untuk menurun.

Sintaksis yang didukung adalah:

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

SearchSpacesResponse

Respons dengan daftar ruang yang sesuai dengan permintaan ruang penelusuran.

Kolom
spaces[]

Space

Halaman ruang yang diminta.

next_page_token

string

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

total_size

int32

Jumlah total ruang 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

Space

Wajib. Kolom Space.spaceType wajib diisi.

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

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

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

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

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

request_id

string

Opsional. ID unik untuk permintaan ini. 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[]

Membership

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

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

Opsional saat menetapkan Space.spaceType ke SPACE.

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

Wajib saat menetapkan Space.spaceType ke DIRECT_MESSAGE dengan pengguna manusia, beserta satu keanggotaan.

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

SlashCommand

Perintah garis miring di Google Chat.

Kolom
command_id

int64

ID perintah garis miring yang dipanggil.

SlashCommandMetadata

Metadata anotasi untuk perintah garis miring (/).

Kolom
bot

User

Aplikasi Chat yang perintahnya dipanggil.

type

Type

Jenis perintah garis miring.

command_name

string

Nama perintah garis miring yang dipanggil.

command_id

int64

ID perintah dari perintah garis miring yang dipanggil.

triggers_dialog

bool

Menunjukkan apakah perintah garis miring ditujukan untuk dialog.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Tambahkan aplikasi Chat ke ruang.
INVOKE 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

string

Nama resource ruang.

Format: spaces/{space}

Dengan {space} merepresentasikan ID yang ditetapkan sistem untuk ruang. Anda bisa mendapatkan ID ruang dengan memanggil metode spaces.list() atau dari URL ruang. Misalnya, jika URL ruang adalah https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, ID ruang adalah AAAAAAAAA.

type
(deprecated)

Type

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

space_type

SpaceType

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

single_user_bot_dm

bool

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

threaded
(deprecated)

bool

Hanya output. Tidak digunakan lagi: Gunakan spaceThreadingState sebagai gantinya. Apakah pesan disusun dalam ruang ini.

display_name

string

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

Untuk pesan langsung, kolom ini mungkin kosong.

Mendukung hingga 128 karakter.

external_user_allowed

bool

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

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

Untuk ruang yang sudah ada, kolom ini hanya output.

space_threading_state

SpaceThreadingState

Hanya output. Status rangkaian pesan di ruang Chat.

space_details

SpaceDetails

Detail tentang ruang, termasuk deskripsi dan aturan.

space_history_state

HistoryState

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

import_mode

bool

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

Pembuatan ruang di Import Mode memerlukan autentikasi pengguna.

create_time

Timestamp

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 jika spaceType adalah GROUP_CHAT atau SPACE.

last_active_time

Timestamp

Hanya output. Stempel waktu pesan terakhir dalam ruang.

admin_installed

bool

Hanya output. Untuk ruang pesan langsung (DM) dengan aplikasi Chat, 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_count

MembershipCount

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

access_settings

AccessSettings

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

space_uri

string

Hanya output. URI bagi pengguna untuk mengakses ruang.

customer

string

Opsional. Tidak dapat diubah. ID pelanggan domain ruang. Hanya diperlukan saat membuat ruang dengan autentikasi aplikasi dan SpaceType adalah SPACE. Jika tidak, tidak boleh ditetapkan.

Dalam format customers/{customer}, dengan customer adalah id dari [referensi pelanggan SDK Admin]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Aplikasi pribadi juga dapat menggunakan alias customers/my_customer untuk membuat ruang di organisasi Google Workspace yang sama dengan aplikasi.

Untuk DM, kolom ini tidak diisi.

Kolom union space_permission_settings. Merepresentasikan setelan izin ruang. Hanya diisi saat space_type adalah SPACE.

Memerlukan autentikasi pengguna. space_permission_settings hanya dapat berupa salah satu dari berikut:

predefined_permission_settings

PredefinedPermissionSettings

Opsional. Input saja. Setelan izin ruang yang telah ditentukan sebelumnya, hanya masukkan saat membuat ruang. Jika kolom tidak ditetapkan, ruang kolaborasi akan dibuat. Setelah Anda membuat ruang, setelan akan diisi di kolom PermissionSettings.

permission_settings

PermissionSettings

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_state

AccessState

Hanya output. Menunjukkan status akses ruang.

audience

string

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

Format: audiences/{audience}

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

Membaca target audiens mendukung:

Kolom ini tidak diisi saat menggunakan cakupan chat.bot dengan autentikasi aplikasi.

Untuk menetapkan target audiens, Anda memerlukan autentikasi pengguna.

AccessState

Merepresentasikan 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 memberikan akses ke ruang kepada target audiens. Pengguna atau Google Grup yang telah ditambahkan atau diundang secara terpisah ke ruang juga dapat menemukan dan mengakses ruang. Untuk mempelajari lebih lanjut, lihat Membuat ruang yang dapat ditemukan oleh pengguna tertentu.

Membuat ruang yang dapat ditemukan memerlukan autentikasi pengguna.

MembershipCount

Mewakili jumlah keanggotaan ruang, yang dikelompokkan ke dalam kategori.

Kolom
joined_direct_human_user_count

int32

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

joined_group_count

int32

Jumlah semua grup yang telah bergabung langsung ke ruang.

PermissionSetting

Merepresentasikan setelan izin ruang.

Kolom
managers_allowed

bool

Apakah pengelola ruang memiliki izin ini atau tidak.

members_allowed

bool

Apakah anggota non-pengelola memiliki izin ini.

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_members_and_groups

PermissionSetting

Setelan untuk mengelola anggota dan grup di ruang.

modify_space_details

PermissionSetting

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

toggle_history

PermissionSetting

Setelan untuk mengaktifkan dan menonaktifkan histori ruang.

use_at_mention_all

PermissionSetting

Setelan untuk menggunakan @semua dalam ruang.

manage_apps

PermissionSetting

Setelan untuk mengelola aplikasi dalam ruang.

manage_webhooks

PermissionSetting

Setelan untuk mengelola webhook dalam ruang.

post_messages

PermissionSetting

Hanya output. Setelan untuk memposting pesan dalam ruang.

reply_messages

PermissionSetting

Setelan untuk membalas pesan dalam ruang.

PredefinedPermissionSettings

Setelan izin 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 menjadikan ruang sebagai ruang pengumuman tempat hanya pengelola ruang yang dapat memposting pesan.

SpaceDetails

Detail tentang ruang, termasuk deskripsi dan aturan.

Kolom
description

string

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

Mendukung hingga 150 karakter.

guidelines

string

Opsional. Aturan, ekspektasi, dan etika ruang.

Mendukung hingga 5.000 karakter.

SpaceThreadingState

Menentukan jenis status rangkaian pesan di ruang Chat.

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

SpaceType

Jenis ruang. 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 antara orang dan aplikasi Chat.

Jenis

Tidak digunakan lagi: Sebagai gantinya, gunakan SpaceType.

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

SpaceBatchUpdatedEventData

Payload peristiwa untuk beberapa update pada ruang.

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

Kolom
spaces[]

SpaceUpdatedEventData

Daftar ruang yang diperbarui.

SpaceEvent

Peristiwa yang mewakili perubahan atau aktivitas di ruang Google Chat. Untuk mempelajari lebih lanjut, lihat Bekerja dengan peristiwa dari Google Chat.

Kolom
name

string

Nama resource dari peristiwa ruang.

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

event_time

Timestamp

Waktu saat peristiwa terjadi.

event_type

string

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

Jenis peristiwa yang didukung untuk messages:

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

Jenis acara yang didukung untuk langganan:

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

Jenis peristiwa yang didukung untuk reaksi:

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

Jenis peristiwa yang didukung tentang ruang:

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

Kolom union payload.

payload hanya dapat berupa salah satu dari yang berikut:

message_created_event_data

MessageCreatedEventData

Payload peristiwa untuk pesan baru.

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

message_updated_event_data

MessageUpdatedEventData

Payload peristiwa untuk pesan yang diperbarui.

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

message_deleted_event_data

MessageDeletedEventData

Payload peristiwa untuk pesan yang dihapus.

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

message_batch_created_event_data

MessageBatchCreatedEventData

Payload peristiwa untuk beberapa pesan baru.

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

message_batch_updated_event_data

MessageBatchUpdatedEventData

Payload peristiwa untuk beberapa pesan yang diperbarui.

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

message_batch_deleted_event_data

MessageBatchDeletedEventData

Payload peristiwa untuk beberapa pesan yang dihapus.

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

space_updated_event_data

SpaceUpdatedEventData

Payload peristiwa untuk pembaruan ruang.

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

space_batch_updated_event_data

SpaceBatchUpdatedEventData

Payload peristiwa untuk beberapa update pada ruang.

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

membership_created_event_data

MembershipCreatedEventData

Payload peristiwa untuk langganan baru.

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

membership_updated_event_data

MembershipUpdatedEventData

Payload peristiwa untuk keanggotaan yang diperbarui.

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

membership_deleted_event_data

MembershipDeletedEventData

Payload peristiwa untuk langganan yang dihapus.

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

membership_batch_created_event_data

MembershipBatchCreatedEventData

Payload peristiwa untuk beberapa keanggotaan baru.

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

membership_batch_updated_event_data

MembershipBatchUpdatedEventData

Payload peristiwa untuk beberapa keanggotaan yang diperbarui.

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

membership_batch_deleted_event_data

MembershipBatchDeletedEventData

Payload peristiwa untuk beberapa keanggotaan yang dihapus.

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

reaction_created_event_data

ReactionCreatedEventData

Payload peristiwa untuk reaksi baru.

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

reaction_deleted_event_data

ReactionDeletedEventData

Payload peristiwa untuk reaksi yang dihapus.

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

reaction_batch_created_event_data

ReactionBatchCreatedEventData

Payload peristiwa untuk beberapa reaksi baru.

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

reaction_batch_deleted_event_data

ReactionBatchDeletedEventData

Payload peristiwa untuk beberapa reaksi yang dihapus.

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

SpaceReadState

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

Kolom
name

string

Nama resource dari status operasi baca ruang.

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

last_read_time

Timestamp

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

SpaceUpdatedEventData

Payload peristiwa untuk ruang yang diupdate.

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

Kolom
space

Space

Ruang yang diperbarui.

Rangkaian pesan

Rangkaian pesan di ruang Google Chat. Untuk mengetahui contoh penggunaannya, lihat Memulai atau membalas rangkaian pesan.

Jika menentukan rangkaian pesan saat membuat pesan, Anda dapat menetapkan kolom messageReplyOption untuk menentukan apa yang terjadi jika tidak ditemukan rangkaian pesan yang cocok.

Kolom
name

string

Nama resource thread.

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

thread_key

string

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

ThreadReadState

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

Kolom
name

string

Nama resource dari status pembacaan thread.

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

last_read_time

Timestamp

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

UpdateMembershipRequest

Pesan permintaan untuk memperbarui keanggotaan.

Kolom
membership

Membership

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

update_mask

FieldMask

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

Jalur kolom yang didukung saat ini:

  • role
use_admin_access

bool

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

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

Memerlukan cakupan OAuth 2.0 chat.admin.memberships.

UpdateMessageRequest

Permintaan untuk memperbarui pesan.

Kolom
message

Message

Wajib. Pesan dengan kolom yang diperbarui.

update_mask

FieldMask

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

Jalur kolom yang didukung saat ini:

allow_missing

bool

Opsional. Jika true dan pesan tidak ditemukan, pesan baru akan dibuat dan updateMask akan diabaikan. ID pesan yang ditentukan harus client-assigned atau permintaan gagal.

UpdateSpaceReadStateRequest

Pesan permintaan untuk UpdateSpaceReadState API.

Kolom
space_read_state

SpaceReadState

Wajib. Status 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:

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

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

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

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

update_mask

FieldMask

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

  • last_read_time

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

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

UpdateSpaceRequest

Permintaan untuk memperbarui satu ruang.

Kolom
space

Space

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

update_mask

FieldMask

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

Anda dapat memperbarui kolom berikut untuk ruang:

space_details: Memperbarui deskripsi ruang. Mendukung hingga 150 karakter.

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

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

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

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

permission_settings: Mendukung perubahan setelan izin ruang. Saat memperbarui setelan izin, Anda hanya dapat menentukan mask kolom permissionSettings; Anda tidak dapat memperbarui mask kolom lain secara bersamaan. permissionSettings tidak didukung dengan useAdminAccess. Mask kolom yang didukung meliputi:

  • permission_settings.manageMembersAndGroups
  • permission_settings.modifySpaceDetails
  • permission_settings.toggleHistory
  • permission_settings.useAtMentionAll
  • permission_settings.manageApps
  • permission_settings.manageWebhooks
  • permission_settings.replyMessages
use_admin_access

bool

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

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

Memerlukan cakupan OAuth 2.0 chat.admin.spaces.

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

Pengguna

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

Kolom
name

string

Nama resource untuk user Google Chat.

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

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

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

  • id untuk pengguna di Admin SDK Directory API.

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

display_name

string

Hanya output. Nama tampilan pengguna.

domain_id

string

ID unik domain Google Workspace pengguna.

type

Type

Jenis pengguna.

is_anonymous

bool

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

Jenis

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

UserMentionMetadata

Metadata anotasi untuk sebutan pengguna (@).

Kolom
user

User

Pengguna yang disebutkan.

type

Type

Jenis sebutan pengguna.

Jenis

Enum
TYPE_UNSPECIFIED Nilai default untuk enum. Jangan gunakan.
ADD Menambahkan pengguna ke ruang.
MENTION Menyebut pengguna dalam ruang.

WidgetMarkup

Widget adalah elemen UI yang menampilkan teks dan gambar.

Kolom
buttons[]

Button

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

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

TextParagraph

Menampilkan paragraf teks di widget ini.

image

Image

Tampilkan gambar dalam widget ini.

key_value

KeyValue

Tampilkan item nilai kunci dalam widget ini.

Tombol

Tombol. Dapat berupa tombol teks atau tombol gambar.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:

text_button

TextButton

Tombol dengan teks dan tindakan onclick.

image_button

ImageButton

Tombol dengan gambar dan tindakan onclick.

FormAction

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

Kolom
action_method_name

string

Nama metode digunakan untuk mengidentifikasi bagian formulir mana yang memicu pengiriman formulir. Informasi ini 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[]

ActionParameter

Daftar parameter tindakan.

ActionParameter

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

Kolom
key

string

Nama parameter untuk skrip tindakan.

value

string

Nilai parameter.

Ikon

Kumpulan ikon yang didukung.

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

Gambar

Gambar yang ditentukan oleh URL dan dapat memiliki tindakan onclick.

Kolom
image_url

string

URL gambar.

on_click

OnClick

Tindakan onclick.

aspect_ratio

double

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

ImageButton

Tombol gambar dengan tindakan onclick.

Kolom
on_click

OnClick

Tindakan onclick.

name

string

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

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

Icon

Ikon yang ditentukan oleh enum yang mengindeks ke ikon yang disediakan oleh Chat API.

icon_url

string

Ikon yang ditentukan oleh URL.

KeyValue

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

Kolom
top_label

string

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

content

string

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

content_multiline

bool

Jika konten harus berupa multibaris.

bottom_label

string

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

on_click

OnClick

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

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

Icon

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

icon_url

string

Ikon yang ditentukan oleh URL.

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

Button

Tombol yang dapat diklik untuk memicu tindakan.

OnClick

Tindakan onclick (misalnya, membuka link).

Kolom

Kolom union data.

data hanya dapat berupa salah satu dari yang berikut:

action

FormAction

Tindakan formulir dipicu oleh tindakan onclick ini jika ditentukan.

TextButton

Tombol dengan teks dan tindakan onclick.

Kolom
text

string

Teks tombol.

on_click

OnClick

Tindakan onclick tombol.

TextParagraph

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

Kolom
text

string