Mengizinkan aplikasi Google Chat untuk mengimpor data
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dengan Google Chat API, aplikasi dapat mengimpor data dari platform pesan lain ke Google Chat menggunakan ruang mode impor. Untuk mengetahui informasi selengkapnya, lihat
Mengimpor data pesan ke Google Chat dari layanan lain.
Untuk membaca dan menulis resource di ruang mode impor, Anda harus
mengautentikasi aplikasi Chat dengan akun layanan.
Berikan cakupan otorisasi Chat API berikut kepada akun layanan oleh administrator: https://www.googleapis.com/auth/chat.import.
Hanya administrator domain Google Workspace yang dapat memberikan cakupan OAuth ini ke akun layanan melalui delegasi seluruh domain.
Setiap domain tempat aplikasi Chat membuat ruang mode impor harus memiliki cakupan OAuth ini. Setelah akun layanan diberi otoritas tingkat domain untuk cakupan ini, aplikasi Chat dapat mengakses ruang mode impor dengan meniru identitas akun pengguna.
Dalam beberapa skenario, akun pengguna untuk peniruan identitas mungkin tidak lagi
tersedia. Dalam kasus ini, aplikasi Chat dapat menggunakan
kredensial akun layanan mereka sebagai penggantian. Misalnya, jika Anda menghapus akun pengguna yang digunakan selama pembuatan pesan, aplikasi Chat dapat menggunakan kredensial akun layanannya sendiri untuk membuat pesan yang berisi konten yang sama. Aplikasi Chat dapat
mengakses ruang mode impor sebagai aplikasi menggunakan kredensial akun layanan dengan
cakupan OAuth berikut: https://www.googleapis.com/auth/chat.bot.
Cakupan Google Chat API lainnya tidak diperlukan saat mengimpor resource ke ruang mode impor.
Aplikasi Chat hanya dapat mengimpor konten ke ruang mode impor yang dibuatnya, dan bukan ke ruang mode impor yang dibuat oleh aplikasi lain.
Tabel berikut mencantumkan metode resource yang dapat dipanggil aplikasi Chat di ruang mode impor, dan jenis autentikasi yang didukung:
Metode resource |
Peniruan identitas pengguna didukung |
Kredensial akun layanan yang didukung |
spaces.create
|
Ya |
Tidak |
spaces.get
|
Tidak |
Ya |
spaces.update
|
Ya |
Tidak |
spaces.delete
|
Ya |
Tidak |
spaces.completeImport
|
Ya |
Tidak |
spaces.messages.create
|
Ya |
Ya |
spaces.messages.delete
|
Ya |
Ya |
spaces.messages.get
|
Tidak |
Ya |
spaces.messages.list
|
Ya |
Tidak |
spaces.messages.update
|
Ya |
Ya |
spaces.messages.reactions.create
|
Ya |
Tidak |
spaces.messages.reactions.delete
|
Ya |
Tidak |
spaces.members.create
|
Ya |
Tidak |
spaces.members.delete
|
Ya |
Tidak |
spaces.members.list
|
Ya |
Tidak |
media.upload
|
Ya |
Tidak |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eGoogle Chat API allows importing data from other platforms into Google Chat using import mode spaces.\u003c/p\u003e\n"],["\u003cp\u003eChat apps require specific authentication and authorization to read and write resources in these spaces, needing domain administrator approval.\u003c/p\u003e\n"],["\u003cp\u003eApps can impersonate user accounts or utilize their service account credentials for specific actions within import mode spaces.\u003c/p\u003e\n"],["\u003cp\u003eImport mode spaces support various resource methods with differing authentication requirements, as detailed in the provided table.\u003c/p\u003e\n"],["\u003cp\u003eChat apps can only import content into spaces they create and not into spaces created by other apps.\u003c/p\u003e\n"]]],["Apps use the Google Chat API's import mode to bring data from other platforms into Google Chat. This requires authentication with a service account granted the `https://www.googleapis.com/auth/chat.import` scope via domain-wide delegation by a Google Workspace admin. Apps can impersonate user accounts or use service account credentials (`https://www.googleapis.com/auth/chat.bot`). Only specific resource methods are supported in import mode spaces. Import mode is exclusive, meaning apps can only modify spaces they create.\n"],null,["# Authorize Google Chat apps to import data\n\nWith the Google Chat API, apps can import data from other messaging platforms into\nGoogle Chat by using *import mode* spaces. For more information, see\n[Import message data to Google Chat from another service](https://support.google.com/a/answer/13465849).\n\nTo read and write resources in import mode spaces, you must\n[authenticate Chat apps with a service account](/workspace/chat/authenticate-authorize-chat-app).\nGrant the service account the following Chat API authorization scope\nby an administrator: `https://www.googleapis.com/auth/chat.import`.\n\nOnly Google Workspace domain administrators can grant this OAuth scope to\nservice accounts through\n[domain-wide delegation](/identity/protocols/oauth2/service-account#delegatingauthority).\nEvery domain that a Chat app creates import mode spaces\nin must have this OAuth scope. After the service account has been delegated\ndomain-wide authority for this scope, Chat apps can access import\nmode spaces by\n[impersonating a user account](/identity/protocols/oauth2/service-account#authorizingrequests).\n\nIn some scenarios, the user account for impersonation might no longer be\navailable. In these cases, the Chat app can use their\nservice account credentials as a fallback. For example, if you delete a user\naccount that was used during message creation, the\nChat app can use their own service account credentials\nto create a message containing the same contents. Chat apps can\naccess import mode spaces as an app using service account credentials with the\nfollowing OAuth scope: `https://www.googleapis.com/auth/chat.bot`.\n\nNo other [Google Chat API scopes](/workspace/chat/authenticate-authorize#scopes)\nare required when importing resources into an import mode space.\nChat apps can only import content into the import mode spaces\nthat they create, and not into the import mode spaces created by other apps.\n\nThe following table lists the resource methods that Chat apps can\ncall in import mode spaces, and what kind of authentication they support:\n\n| Resource method | User impersonation supported | Service account credentials supported |\n|------------------------------------|------------------------------|---------------------------------------|\n| `spaces.create` | Yes | No |\n| `spaces.get` | No | Yes |\n| `spaces.update` | Yes | No |\n| `spaces.delete` | Yes | No |\n| `spaces.completeImport` | Yes | No |\n| `spaces.messages.create` | Yes | Yes |\n| `spaces.messages.delete` | Yes | Yes |\n| `spaces.messages.get` | No | Yes |\n| `spaces.messages.list` | Yes | No |\n| `spaces.messages.update` | Yes | Yes |\n| `spaces.messages.reactions.create` | Yes | No |\n| `spaces.messages.reactions.delete` | Yes | No |\n| `spaces.members.create` | Yes | No |\n| `spaces.members.delete` | Yes | No |\n| `spaces.members.list` | Yes | No |\n| `media.upload` | Yes | No |\n\nRelated topics\n--------------\n\n- To learn more about authentication and authorization, see [Authenticate and authorize Google Chat apps and API requests](/workspace/chat/authenticate-authorize).\n- To learn how to set up a service account to access the Google Chat API, see [Authenticate as a Google Chat app](/workspace/chat/authenticate-authorize-chat-app).\n- To learn how to start importing resources using import mode spaces, see [Import data to Google Chat](/workspace/chat/import-data)."]]
