Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Présentation de l'API User Invitation
L'API User Invitation de Cloud Identity vous permet d'identifier et de gérer les comptes non gérés lors de l'intégration d'utilisateurs à votre domaine Google Workspace ou Cloud Identity.
Les comptes non gérés sont définis par les critères suivants :
L'adresse e-mail est un compte personnel et c'est l'adresse e-mail principale du compte.
Le domaine de l'adresse e-mail correspond à un domaine Google Workspace ou Cloud Identity validé existant.
Ce cas se présente généralement lorsque l'un des utilisateurs du client s'est inscrit aux services Google grand public à l'aide d'une adresse e-mail attribuée par son entreprise ou son établissement d'enseignement.
Lorsque le client s'inscrit à Google Workspace ou à Cloud Identity et provisionne un compte utilisateur avec la même adresse e-mail principale qu'un compte non géré existant, ce compte non géré entraîne un conflit qui doit être résolu.
L'API User Invite permet d'automatiser les tâches de résolution de clés :
Déterminer si une adresse e-mail donnée est éligible pour rejoindre le domaine du client (doit répondre aux deux critères) .
Envoyer des invitations ad hoc ou par lot aux adresses e-mail éligibles pour qu'elles puissent rejoindre le domaine du client .
Récupérer une liste de comptes non gérés, filtrables par leur état d'invitation. Tous les comptes non gérés du domaine du client sont traités comme des invitations d'utilisateurs non envoyées (state==NOT_YET_SENT) jusqu'à leur envoi.
Rechercher une invitation spécifique par adresse e-mail.
Annuler les invitations déjà envoyées.
Le flux d'invitation de l'utilisateur permet à l'utilisateur final et à l'administrateur de s'assurer que toutes les données créées à l'aide du compte personnel sont gérées par la bonne entité :
Si l'utilisateur final possède des données relatives à l'entreprise dans son compte personnel et accepte l'invitation, l'administrateur peut assumer la propriété des données et les gérer conformément aux règles du client.
Si les données de l'utilisateur final ne sont pas liées à l'entreprise et qu'ils refusent cette invitation, l'utilisateur reçoit une notification l'informant qu'il devra peut-être renommer ultérieurement l'adresse e-mail si l'administrateur crée un compte Google pour lui. L'administrateur peut créer un nouveau compte géré et expulser l'adresse e-mail principale du compte personnel, entraînant ainsi le conflit. L'utilisateur final est alors invité à renommer son adresse e-mail chaque fois qu'il se connecte à son compte Google personnel.
Étapes suivantes
Voici quelques étapes que vous pouvez également suivre :
Pour comprendre comment fonctionne la résolution des conflits de comptes dans la console d'administration, consultez la section Rechercher et gérer des comptes existants du centre d'aide de la console d'administration Google.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (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."]]
