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 de versão.

Representa os termos de uso personalizáveis de um locatário que são criados e gerenciados com Azure Active Directory (Azure AD). Você pode usar os métodos a seguir para criar e gerenciar o recurso Azure Active Directory termos de uso de acordo com seu cenário.

Métodos

Método	Tipo de retorno	Descrição
Criar	agreement	Crie um novo contrato postando na coleção de contratos.
Lista	coleção agreement	Obter uma coleção de objetos de contrato.
Get	agreement	Ler propriedades e relações de um objeto de contrato.
Atualizar	Nenhum(a)	Atualize um objeto agreement.
Delete	Nenhum	Excluir um objeto agreement.
Aceitação de lista	Coleção agreementAcceptance	Obter os detalhes sobre os registros de aceitação de um contrato específico.
Listar agreementAcceptances	Coleção agreementAcceptance	Obter as aceitaçãos de contrato para o usuário in-locar.
Obter agreementFile	Coleção agreementFile	Recupere os detalhes do arquivo padrão para um contrato, incluindo as informações de idioma e versão.
Listar arquivos	Coleção agreementFileLocalization	Recupere todos os arquivos localizados relacionados a um contrato.
Criar agreementFileLocalization	agreementFileLocalization	Crie um novo arquivo de contrato localizado.

Propriedades

Propriedade	Tipo	Descrição
displayName	Cadeia de caracteres	Nome de exibição do contrato. O nome de exibição é usado para o controle interno do contrato, mas não é mostrado aos usuários finais que visualizam o contrato. Suporta $filter (eq).
id	String	Somente leitura. Suporta $filter (eq).
isPerDeviceAcceptanceRequired	Booliano	Essa configuração permite exigir que os usuários finais aceitem esse contrato em todos os dispositivos de onde eles estão acessando. O usuário final será necessário para registrar seu dispositivo no Azure AD, caso ainda não tenha feito isso. Suporta $filter (eq).
isViewingBeforeAcceptanceRequired	Booliano	Indica se o usuário precisa expandir o contrato antes de aceitar. Suporta $filter (eq).
termsExpiration	termsExpiration	Cronograma de expiração e frequência de acordo para todos os usuários. Suporta $filter (eq).
userReacceptRequiredFrequency	Duration	A duração após a qual o usuário deve aceitar os termos de uso. O valor é representado no formato ISO 8601 por durações.

Relações

Relação	Tipo	Descrição
acceptances	Coleção agreementAcceptance	Somente leitura. Informações sobre as aceitaçãos deste contrato.
file	agreementFile	PDF padrão vinculado a este contrato.
arquivos	Coleção agreementFileLocalization	PDFs vinculados a este contrato. Observação: Essa propriedade está em processo de preterido. Use a propriedade file em vez disso.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.agreement",
  "id": "String (identifier)",
  "displayName": "String",
  "termsExpiration": {
    "@odata.type": "microsoft.graph.termsExpiration"
  },
  "userReacceptRequiredFrequency": "String (duration)",
  "isViewingBeforeAcceptanceRequired": "Boolean",
  "isPerDeviceAcceptanceRequired": "Boolean"
}