Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Panoramica dell'API User Invitation
L'API Cloud Identity User Invitation ti consente di identificare e gestire
gli account non gestiti nell'ambito dell'onboarding degli utenti nel tuo dominio Google Workspace o
Cloud Identity.
Gli account non gestiti sono definiti dai seguenti criteri:
l'indirizzo email è un account consumer ed è l'indirizzo email principale
dell'account e
il dominio dell'indirizzo email corrisponda a un dominio Google Workspace o Cloud Identity verificato esistente
Questi account esistono in genere perché uno degli utenti del cliente si è registrato ai servizi consumer di Google utilizzando il proprio indirizzo email di lavoro o scolastico.
Quando il cliente si registra a Google Workspace o Cloud Identity
e esegue il provisioning di un account utente con lo stesso indirizzo email principale di un
account non gestito esistente, quest'ultimo entra in conflitto e
deve essere risolto.
L'API User Invitation rende automatizzabili le attività di risoluzione delle chiavi:
Determina se un determinato indirizzo email è idoneo a entrare a far parte del dominio del cliente (deve soddisfare entrambi i criteri)
Invia inviti email ad hoc o in batch agli indirizzi email idonei in modo che
possano unirsi al dominio del cliente
Recupera un elenco di account non gestiti, filtrabili in base allo stato dell'invito. Tutti gli account non gestiti sul dominio del cliente vengono trattati come
inviti utente non inviati (state==NOT_YET_SENT) finché non vengono inviati.
Cercare un invito specifico per indirizzo email
Annullare gli inviti già inviati
Il flusso di invito dell'utente consente sia all'utente finale sia all'amministratore di
assicurarsi che tutti i dati creati utilizzando l'account consumer siano gestiti dall'entità corretta:
Se l'utente finale ha dati correlati all'attività nell'account consumer e
accetta l'invito, l'amministratore può assumere la proprietà e gestire
i dati in base alle norme del cliente.
Se i dati dell'utente finale non sono correlati all'attività e l'utente rifiuta, l'invito
avvisa l'utente che potrebbe dover rinominare l'indirizzo
email in un secondo momento se l'amministratore crea un nuovo Account Google per lui. L'amministratore può creare un nuovo account gestito ed eliminare l'indirizzo email principale dell'account consumer, creando il conflitto. All'utente finale
verrà quindi chiesto di rinominare il proprio indirizzo email con un altro indirizzo email ogni
volta che accede al proprio Account Google personale.
Passaggi successivi
Ecco alcuni passaggi successivi che puoi intraprendere:
Per capire come funziona la risoluzione dei conflitti tra account nella Console di amministrazione,
leggi
Trovare e gestire gli account esistenti
nel Centro assistenza Google Admin.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-08 UTC."],[[["\u003cp\u003eThe Cloud Identity User Invitation API helps manage unmanaged accounts during user onboarding to Google Workspace or Cloud Identity domains.\u003c/p\u003e\n"],["\u003cp\u003eUnmanaged accounts are consumer accounts whose email domain matches a verified Google Workspace or Cloud Identity domain, created because users signed up for consumer Google services with their work or school email.\u003c/p\u003e\n"],["\u003cp\u003eThis API automates key resolution tasks, like determining eligibility, sending invitations, listing unmanaged accounts, looking up specific invitations, and canceling sent invitations.\u003c/p\u003e\n"],["\u003cp\u003eThe user invitation process allows administrators to take ownership of business-related data from consumer accounts or inform users to rename their email if it's personal.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be set up by following the steps in \u003ca href=\"/identity/docs/how-to/setup-user-invitations\"\u003eSetting up the User Invitation API\u003c/a\u003e, and more information on conflict resolution can be found in the Google Admin Help Center under \u003ca href=\"https://support.google.com/a/answer/6178640\"\u003eFind and manage existing accounts\u003c/a\u003e.\u003c/p\u003e\n"]]],[],null,["# User Invitation API overview\n============================\n\nThe Cloud Identity User Invitation API allows you to identify and manage\nunmanaged accounts as part of onboarding users to your Google Workspace or\nCloud Identity domain.\n|\n| **Beta**\n|\n|\n| This product is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nUnmanaged accounts are defined by the following criteria:\n\n- the email address is a consumer account and it's the primary email address of the account, and\n- the domain of the email address matches an existing verified Google Workspace or Cloud Identity domain\n\nThese accounts generally exist because one of the customer's users has signed\nup for consumer Google services using their work or educational email address.\nWhen the customer then signs up for Google Workspace or Cloud Identity\nand provisions a user account with the same primary email address as an\nexisting unmanaged account, that unmanaged account becomes conflicted and\nneeds to be resolved.\n\nThe User Invitation API makes key resolution tasks automatable:\n\n- Determine if a given email address is eligible to join the customer's domain (must meet both criteria)\n- Send ad-hoc or batch email invitations to eligible email addresses so they can join the customer's domain\n- Retrieve a list of unmanaged accounts, filterable by their invitation state. All unmanaged accounts on the customer's domain are treated as unsent user invitations (`state==NOT_YET_SENT`) until they are sent.\n- Look up a specific invitation by email address\n- Cancel already-sent invitations\n\nThe user invitation flow allows both the end user and the administrator to\nensure that any data created using the consumer account is managed by the\ncorrect entity:\n\n- If the end user has business-related data under the consumer account and accepts the invitation, the administrator can take ownership and manage the data according to the customer's policies.\n- If the end user's data is not business-related and they decline, the invitation gives the user notice that they may need to rename the email address later if the admin creates a new Google account for them. The administrator can create a new managed account and evict the primary email address of the consumer account, creating the conflict. The end user will then be asked to rename their email address to another email address every time they log in to their personal Google account.\n\nNext steps\n----------\n\nHere are a few next steps you might take:\n\n- To set up the API, refer to [Setting up the User Invitation API](/identity/docs/how-to/setup-user-invitations).\n- To understand how account conflict resolution works in the Admin Console, read [Find and manage existing accounts](https://support.google.com/a/answer/6178640) in the Google Admin Help Center."]]
