برنامه‌های Google Chat را برای وارد کردن داده‌ها مجاز کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با استفاده از Google Chat API، برنامه‌ها می‌توانند داده‌ها را از سایر پلتفرم‌های پیام‌رسانی با استفاده از فضاهای حالت واردات به Google Chat وارد کنند. برای اطلاعات بیشتر، وارد کردن داده پیام به Google Chat از سرویس دیگری را ببینید.
برای خواندن و نوشتن منابع در فضاهای حالت واردات، باید برنامه‌های گپ را با یک حساب سرویس تأیید اعتبار کنید . به حساب سرویس، محدوده مجوز Chat API زیر را توسط سرپرست اعطا کنید: https://www.googleapis.com/auth/chat.import .
فقط سرپرستان دامنه Google Workspace می‌توانند این محدوده OAuth را از طریق تفویض اختیار در سطح دامنه به حساب‌های خدماتی اعطا کنند. هر دامنه ای که برنامه چت در آن فضاهای حالت واردات ایجاد می کند باید این محدوده OAuth را داشته باشد. پس از تفویض اختیار به حساب سرویس در سراسر دامنه برای این حوزه، برنامه‌های گپ می‌توانند با جعل هویت یک حساب کاربری به فضاهای حالت واردات دسترسی پیدا کنند.
در برخی از سناریوها، حساب کاربری برای جعل هویت ممکن است دیگر در دسترس نباشد. در این موارد، برنامه چت می‌تواند از اعتبار حساب سرویس خود به عنوان یک بازگشت استفاده کند. به عنوان مثال، اگر یک حساب کاربری را که در حین ایجاد پیام استفاده شده است حذف کنید، برنامه Chat می تواند از اعتبار حساب سرویس خود برای ایجاد پیامی حاوی همان محتوا استفاده کند. برنامه‌های گپ می‌توانند با استفاده از اطلاعات کاربری حساب سرویس با محدوده OAuth زیر به فضاهای حالت واردات به‌عنوان یک برنامه دسترسی داشته باشند: https://www.googleapis.com/auth/chat.bot .
هنگام وارد کردن منابع به فضای حالت واردات، هیچ حوزه API Google Chat دیگری مورد نیاز نیست. برنامه‌های چت فقط می‌توانند محتوا را به فضاهای حالت وارداتی که ایجاد می‌کنند وارد کنند، و نه در فضاهای حالت واردات ایجاد شده توسط برنامه‌های دیگر.
جدول زیر روش‌های منبعی را که برنامه‌های چت می‌توانند در فضاهای حالت واردات فراخوانی کنند و نوع احراز هویتی که آنها پشتیبانی می‌کنند فهرست می‌کند:
روش منابع | جعل هویت کاربر پشتیبانی می شود | اعتبار حساب خدمات پشتیبانی می شود |
|---|
spaces.create | بله | خیر |
spaces.get | خیر | بله |
spaces.update | بله | خیر |
spaces.delete | بله | خیر |
spaces.completeImport | بله | خیر |
spaces.messages.create | بله | بله |
spaces.messages.delete | بله | بله |
spaces.messages.get | خیر | بله |
spaces.messages.list | بله | خیر |
spaces.messages.update | بله | بله |
spaces.messages.reactions.create | بله | خیر |
spaces.messages.reactions.delete | بله | خیر |
spaces.members.create | بله | خیر |
spaces.members.delete | بله | خیر |
spaces.members.list | بله | خیر |
media.upload | بله | خیر |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
