Autorizzare le app Google Chat a importare dati
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Con l'API Google Chat, le app possono importare i dati da altre piattaforme di messaggistica in
Google Chat utilizzando gli spazi in modalità di importazione. Per saperne di più, vedi
Importare i dati dei messaggi in Google Chat da un altro servizio.
Per leggere e scrivere risorse negli spazi in modalità di importazione, devi
autenticare le app di chat con un service account.
Concedi all'account di servizio il seguente ambito di autorizzazione dell'API Chat
da parte di un amministratore: https://www.googleapis.com/auth/chat.import.
Solo gli amministratori di dominio Google Workspace possono concedere questo ambito OAuth agli account di servizio tramite la delega a livello di dominio.
Ogni dominio in cui un'app di chat crea spazi in modalità di importazione
deve avere questo ambito OAuth. Dopo che all'account di servizio è stata delegata
l'autorità a livello di dominio per questo ambito, le app di Chat possono accedere agli spazi in modalità di importazione
simulando un account utente.
In alcuni scenari, l'account utente per la rappresentazione potrebbe non essere più
disponibile. In questi casi, l'app Chat può utilizzare le credenziali dell'account di servizio come fallback. Ad esempio, se elimini un account utente
utilizzato durante la creazione del messaggio, l'app
Chat può utilizzare le proprie credenziali dell'account di servizio
per creare un messaggio contenente gli stessi contenuti. Le app di chat possono
accedere agli spazi in modalità di importazione come app utilizzando le credenziali dell'account di servizio con il
seguente ambito OAuth: https://www.googleapis.com/auth/chat.bot.
Non sono necessari altri ambiti dell'API Google Chat
quando importi risorse in uno spazio in modalità di importazione.
Le app di chat possono importare contenuti solo negli spazi in modalità di importazione
che creano e non in quelli creati da altre app.
La tabella seguente elenca i metodi delle risorse che le app di chat possono
chiamare negli spazi in modalità di importazione e il tipo di autenticazione che supportano:
Metodo della risorsa |
Impersonificazione di un utente supportata |
Credenziali del service account supportate |
spaces.create
|
Sì |
No |
spaces.get
|
No |
Sì |
spaces.update
|
Sì |
No |
spaces.delete
|
Sì |
No |
spaces.completeImport
|
Sì |
No |
spaces.messages.create
|
Sì |
Sì |
spaces.messages.delete
|
Sì |
Sì |
spaces.messages.get
|
No |
Sì |
spaces.messages.list
|
Sì |
No |
spaces.messages.update
|
Sì |
Sì |
spaces.messages.reactions.create
|
Sì |
No |
spaces.messages.reactions.delete
|
Sì |
No |
spaces.members.create
|
Sì |
No |
spaces.members.delete
|
Sì |
No |
spaces.members.list
|
Sì |
No |
media.upload
|
Sì |
No |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
