Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa os termos de uso personalizáveis de um locatário que é criado e gerenciado com Microsoft Entra ID Governance. Você pode usar os métodos a seguir para criar e gerenciar o recurso Microsoft Entra Termos de Uso de acordo com seu cenário.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | contrato | Crie um novo contrato postando na coleção de contratos. |
| List | coleção agreement | Obtenha uma coleção de objetos de contrato. |
| Get | contrato | Leia propriedades e relações de um objeto agreement. |
| Atualizar | Nenhum(a) | Atualize um objeto de contrato. |
| Delete | Nenhum | Exclua um objeto de contrato. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayName | Cadeia de caracteres | Nome de exibição do contrato. O nome de exibição é usado para acompanhamento interno do contrato, mas não é mostrado para usuários finais que exibem o contrato. Suporta $filter (eq). |
| id | String | Somente leitura. Suporta $filter (eq). |
| isPerDeviceAcceptanceRequired | Booliano | Essa configuração permite que você exija que os usuários finais aceitem esse contrato em todos os dispositivos dos quais estão acessando. O usuário final será obrigado a registrar seu dispositivo em Microsoft Entra ID, se ainda não o tiver feito. Suporta $filter (eq). |
| isViewingBeforeAcceptanceRequired | Booliano | Indica se o usuário precisa expandir o contrato antes de aceitar. Suporta $filter (eq). |
| termsExpiration | termsExpiration | Agenda de expiração e frequência de contrato para todos os usuários. Suporta $filter (eq). |
| userReacceptRequiredFrequency | Duração | A duração após a qual o usuário deve reaceitar os termos de uso. O valor é representado no formato ISO 8601 para durações. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| Aceitações | Coleção agreementAcceptance | Somente leitura. Informações sobre aceitações desse contrato. |
| file | agreementFile | PDF padrão vinculado a este contrato. |
| arquivos | coleção agreementFileLocalization | PDFs vinculados a esse contrato. Nota: Essa propriedade está em processo de preterida. Em vez disso, use a propriedade do arquivo . |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.agreement",
"id": "String (identifier)",
"displayName": "String",
"termsExpiration": {
"@odata.type": "microsoft.graph.termsExpiration"
},
"userReacceptRequiredFrequency": "String (duration)",
"isViewingBeforeAcceptanceRequired": "Boolean",
"isPerDeviceAcceptanceRequired": "Boolean"
}