tipo de recurso convite
Namespace: microsoft.graph
Representa um convite usado para adicionar usuários externos a uma organização.
O processo de convite usa o fluxo a seguir:
- Um convite é criado
- Um convite é enviado ao usuário convidado (contendo um link do convite)
- O usuário convidado clica no link do convite, entra e recupera o convite, e a criação da entidade de usuário que representa o usuário convidado é concluída
- O usuário é redirecionado para uma página específica após a conclusão do resgate
A criação de um convite retornará uma URL de resgate na resposta (inviteRedeemUrl). A API de convite de criação pode enviar automaticamente um email contendo a URL de resgate para o usuário convidado, definindo o sendInvitationMessage como true. Você também pode personalizar a mensagem que será enviada ao usuário convidado. Em vez disso, se você quiser enviar a URL de resgate por meio de alguns outros meios, poderá definir o sendInvitationMessage como false e usar a URL de resgate da resposta para criar sua própria comunicação. Atualmente, não há nenhuma API para executar o processo de resgate. O usuário convidado precisa clicar no link inviteRedeemUrl enviado na comunicação na etapa acima e passar pelo processo interativo de resgate em um navegador. Depois de concluído, o usuário convidado se torna um usuário externo na organização.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Criar convite | invitation | Escreva as propriedades e os relacionamentos do objeto invitation. |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
invitedUserDisplayName | String | O nome de exibição do usuário que está sendo convidado. |
invitedUserEmailAddress | String | O endereço de email do usuário que está sendo convidado. Obrigatório. Os seguintes caracteres especiais não são permitidos no endereço de email:
No entanto, as seguintes exceções se aplicam:
|
invitedUserMessageInfo | invitedUserMessageInfo | Configurações adicionais para a mensagem que está sendo enviada ao usuário convidado, incluindo a lista de destinatários cc, o idioma e o texto da mensagem de personalização. |
invitedUserType | String | O userType do usuário que está sendo convidado. Por padrão, é Guest Você pode convidar como Member se fosse um administrador da empresa. |
inviteRedirectUrl | Cadeia de caracteres | A URL para a qual o usuário deve ser redirecionado depois que o convite for resgatado. Obrigatório. |
inviteRedeemUrl | Cadeia de caracteres | O URL que o usuário pode usar para resgatar o convite dele. Somente leitura. |
resetRedemption | Boolean | Redefina o status de resgate do usuário e reinvite um usuário mantendo seu identificador de usuário, associações de grupo e atribuições de aplicativo. Essa propriedade permite permitir que um usuário entre usando um endereço de email diferente do do convite anterior. Para obter mais informações sobre como usar essa propriedade, consulte Redefinir o status de resgate para um usuário convidado. |
sendInvitationMessage | Boolean | Indica se um email deve ser enviado ao usuário que está sendo convidado. O padrão é false . |
status | Cadeia de caracteres | O status do convite. Os valores possíveis são: PendingAcceptance , Completed , InProgress , e Error . |
Relações
Relação | Tipo | Descrição |
---|---|---|
invitedUser | User | O usuário criado como parte da criação do convite. Read-Only |
Representação JSON
Veja a seguir uma representação JSON do recurso
{
"invitedUserDisplayName": "string",
"invitedUserEmailAddress": "string",
"invitedUserMessageInfo": {"@odata.type": "microsoft.graph.invitedUserMessageInfo"},
"sendInvitationMessage": false,
"inviteRedirectUrl": "string",
"inviteRedeemUrl": "string",
"resetRedemption": false,
"status": "string",
"invitedUser": {"@odata.type": "microsoft.graph.user"},
"invitedUserType": "string"
}