Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Información general sobre la API User Invitation
La API User Invitation de Cloud Identity te permite identificar y gestionar cuentas no gestionadas como parte del proceso de incorporación de usuarios a tu dominio de Google Workspace o Cloud Identity.
Las cuentas no gestionadas se definen según los siguientes criterios:
La dirección de correo es una cuenta de consumidor y es la dirección de correo principal de la cuenta.
El dominio de la dirección de correo coincide con un dominio de Google Workspace o Cloud Identity verificado.
Estas cuentas suelen existir porque uno de los usuarios del cliente se ha registrado en servicios para consumidores de Google con su dirección de correo de trabajo o de centro educativo.
Cuando el cliente se registra en Google Workspace o Cloud Identity y aprovisiona una cuenta de usuario con la misma dirección de correo principal que una cuenta no gestionada, esta última entra en conflicto y debe resolverse.
La API User Invitation permite automatizar las tareas de resolución de claves:
Determina si una dirección de correo determinada puede unirse al dominio del cliente (debe cumplir ambos criterios).
Enviar invitaciones por correo electrónico puntuales o por lotes a direcciones de correo aptas para que puedan unirse al dominio del cliente
Recupera una lista de cuentas no gestionadas que se puede filtrar por el estado de la invitación. Todas las cuentas no gestionadas del dominio del cliente se tratan como invitaciones de usuario no enviadas (state==NOT_YET_SENT) hasta que se envían.
Buscar una invitación específica por dirección de correo electrónico
Cancelar invitaciones ya enviadas
El flujo de invitación de usuarios permite que tanto el usuario final como el administrador se aseguren de que los datos creados con la cuenta de consumidor los gestione la entidad correcta:
Si el usuario final tiene datos relacionados con la empresa en la cuenta de consumidor y acepta la invitación, el administrador puede hacerse propietario de los datos y gestionarlos de acuerdo con las políticas del cliente.
Si los datos del usuario final no están relacionados con la empresa y este rechaza la invitación, se le informará de que es posible que tenga que cambiar el nombre de la dirección de correo más adelante si el administrador crea una cuenta de Google para él. El administrador puede crear una cuenta gestionada y expulsar la dirección de correo principal de la cuenta de consumidor, lo que genera el conflicto. Después, se le pedirá al usuario final que cambie su dirección de correo por otra cada vez que inicie sesión en su cuenta personal de Google.
Pasos siguientes
Estos son algunos pasos que puedes seguir a continuación:
Para saber cómo funciona la resolución de conflictos de cuentas en la consola de administración, consulta el artículo Buscar y gestionar cuentas del Centro de Ayuda de Google Admin.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-10 (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."]]
