tipo de recurso de contrato

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"
}