Atualize as propriedades da organização autenticada no momento. Neste caso, organization é definido como uma coleção de exatamente um registo, pelo que o respetivo ID tem de ser especificado no pedido. O ID também é conhecido como o tenantId da organização.
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão
Permissões com menos privilégios
Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)
Organization.ReadWrite.All
Indisponível.
Delegado (conta pessoal da Microsoft)
Sem suporte.
Sem suporte.
Application
Organization.ReadWrite.All
Indisponível.
As aplicações concedidas à permissão User.Read só conseguem ler as propriedades id, displayName e verifiedDomains da organização. Todas as outras propriedades são devolvidas com null valores. Para ler todas as propriedades, utilize, pelo menos, Organization.Read.All.
Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função suportada do Microsoft Entra ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.
Administrador de Licenças do AdHoc
Administrador de Aplicativos
Administrador de Autenticação
Administrador do Azure Information Protection
Administrador do Azure Information Protection
Administrador de Cobrança
Administrador de Aplicativos de Nuvem
Administrador de Dados de Conformidade
Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
Administrador de Análise de Computadores
Leitores de Diretórios
Revisor de Diretórios
Contas de Sincronização de Diretórios – para os serviços Microsoft Entra Connect e Microsoft Entra Cloud Sync
Escritores de diretório
Administrador do Dynamics 365
Administrador do Dynamics 365
Leitor Global
Utilizador Convidado
Administrador da Assistência Técnica
Administrador de Identidade Híbrida
Insights do Administrador
Administrador do Kaizala
Administrador de Licenças
Administrador de caixa de correio
Administrador de Ambiente de Trabalho Gerido da Microsoft
Utilizador da Microsoft Store para Empresas
Administrador de Comércio Moderno
Administrador do Power BI
Administrador do Power BI
Administrador de Autenticação Privilegiada
Administrador de Função Privilegiada
Utilizador Convidado Restrito
Administrador de Segurança
Operador de Segurança
Leitor de Segurança
Administrador do Suporte de Serviços
Administrador do Teams
Administrador de Comunicações do Teams
Engenheiro de Suporte de Comunicações de Equipes
Especialista em suporte à comunicação de equipes
Usuário
Administrador do usuário
Utilizador do Centro de Empresas de Licenciamento em Volume
Utilizador do Centro de Serviços de Licenciamento em Volume
No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Organization
{
MarketingNotificationEmails = new List<string>
{
"marketing@contoso.com",
},
PrivacyProfile = new PrivacyProfile
{
ContactEmail = "alice@contoso.com",
StatementUrl = "https://contoso.com/privacyStatement",
},
SecurityComplianceNotificationMails = new List<string>
{
"security@contoso.com",
},
SecurityComplianceNotificationPhones = new List<string>
{
"(123) 456-7890",
},
TechnicalNotificationMails = new List<string>
{
"tech@contoso.com",
},
};
// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Organization["{organization-id}"].PatchAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Organization organization = new Organization();
LinkedList<String> marketingNotificationEmails = new LinkedList<String>();
marketingNotificationEmails.add("marketing@contoso.com");
organization.setMarketingNotificationEmails(marketingNotificationEmails);
PrivacyProfile privacyProfile = new PrivacyProfile();
privacyProfile.setContactEmail("alice@contoso.com");
privacyProfile.setStatementUrl("https://contoso.com/privacyStatement");
organization.setPrivacyProfile(privacyProfile);
LinkedList<String> securityComplianceNotificationMails = new LinkedList<String>();
securityComplianceNotificationMails.add("security@contoso.com");
organization.setSecurityComplianceNotificationMails(securityComplianceNotificationMails);
LinkedList<String> securityComplianceNotificationPhones = new LinkedList<String>();
securityComplianceNotificationPhones.add("(123) 456-7890");
organization.setSecurityComplianceNotificationPhones(securityComplianceNotificationPhones);
LinkedList<String> technicalNotificationMails = new LinkedList<String>();
technicalNotificationMails.add("tech@contoso.com");
organization.setTechnicalNotificationMails(technicalNotificationMails);
Organization result = graphClient.organization().byOrganizationId("{organization-id}").patch(organization);
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.organization import Organization
from msgraph.generated.models.privacy_profile import PrivacyProfile
# To initialize your graph_client, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Organization(
marketing_notification_emails = [
"marketing@contoso.com",
],
privacy_profile = PrivacyProfile(
contact_email = "alice@contoso.com",
statement_url = "https://contoso.com/privacyStatement",
),
security_compliance_notification_mails = [
"security@contoso.com",
],
security_compliance_notification_phones = [
"(123) 456-7890",
],
technical_notification_mails = [
"tech@contoso.com",
],
)
result = await graph_client.organization.by_organization_id('organization-id').patch(request_body)