tipo de recurso de grupogroup resource type

Representa um grupo do Azure Active Directory (Azure AD), que pode ser um grupo do Office 365 ou um grupo de segurança.Represents an Azure Active Directory (Azure AD) group, which can be an Office 365 group, or a security group.

Herda de directoryObject.Inherits from directoryObject.

Por motivos de desempenho, as operações create, get e list retornam por padrão apenas um subconjunto das propriedades usadas com mais frequência.For performance reasons, the create, get, and list operations return only a subset of more commonly used properties by default. Essas propriedades padrão estão listadas na seção Propriedades.These default properties are noted in the Properties section. Para obter as propriedades não retornadas por padrão, especifique-as em uma opção de consulta $select do OData.To get any of the properties that are not returned by default, specify them in a $select OData query option.

Esse recurso permite:This resource supports:

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Gerenciamento de gruposGroup management
Criar grupoCreate group groupgroup Criar um novo grupo.Create a new group. Pode ser um grupo do Office 365, um grupo dinâmico ou um grupo de segurança.It can be an Office 365 group, dynamic group, or security group.
Obter grupoGet group groupgroup Ler as propriedades de um objeto group.Read properties of a group object.
Listar gruposList groups Coleção groupgroup collection Listar objetos group e suas propriedades.List group objects and their properties.
Atualizar grupoUpdate group NenhumNone Atualizar as propriedades de um objeto group.Update the properties of a group object.
Excluir grupoDelete group NenhumNone Excluir um objeto group.Delete group object.
deltadelta Coleção groupgroup collection Obter alterações incrementais para grupos.Get incremental changes for groups.
Listar groupLifecyclePoliciesList groupLifecyclePolicies Coleção groupLifecyclePolicygroupLifecyclePolicy collection Listar políticas de ciclo de vida de grupo.List group lifecycle policies.
RenovarRenew BoolianoBoolean Renova o período de validade de um grupo.Renews a group's expiration. Após renovar um grupo, o período de validade é estendido de acordo com o número de dias definido na política.When a group is renewed, the group expiration is extended by the number of days defined in the policy.
Adicionar proprietárioAdd owner NenhumNone Adicionar um novo proprietário para o grupo postando na propriedade de navegação owners (com suporte somente para grupos de segurança e grupos de segurança habilitados para email).Add a new owner for the group by posting to the owners navigation property (supported for security groups and mail-enabled security groups only).
Listar proprietáriosList owners Coleção directoryObjectdirectoryObject collection Obter os proprietários do grupo da propriedade de navegação owners.Get the owners of the group from the owners navigation property.
Remover proprietárioRemove owner NenhumNone Remover um proprietário de um grupo do Office 365, grupo de segurança ou grupo de segurança habilitado para email por meio da propriedade de navegação owners.Remove an owner from an Office 365 group, a security group or a mail-enabled security group through the owners navigation property.
Adicionar membroAdd member NenhumNone Adicionar um usuário ou grupo a esse grupo postando na propriedade de navegação members (com suporte somente para grupos de segurança e grupos de segurança habilitados para email).Add a user or group to this group by posting to the members navigation property (supported for security groups and mail-enabled security groups only).
Listar membrosList members Coleção directoryObjectdirectoryObject collection Obter os usuários e grupos que são membros diretos desse grupo da propriedade de navegação members.Get the users and groups that are direct members of this group from the members navigation property.
Listar membros transitivosList transitive members Coleção directoryObjectdirectoryObject collection Obtenha os usuários, grupos e dispositivos que são membros, inclusive membros aninhados desse grupo.Get the users, groups and devices that are members, including nested members of this group.
Listar memberOf transitivosList transitive memberOf Coleção directoryObjectdirectoryObject collection Enumera os grupos dos quais esse usuário é membro.List the groups that this user is a member of. Essa operação é transitiva e inclui os grupos que são membros aninhados desse grupo.This operation is transitive and includes the groups that this group is a nested member of.
Remover membroRemove member NoneNone Remover um membro de um grupo do Office 365, grupo de segurança ou grupo de segurança habilitado para email por meio da propriedade de navegação members. É possível remover usuários ou outros grupos.Remove a member from an Office 365 group, a security group or a mail-enabled security group through the members navigation property. You can remove users or other groups.
checkMemberGroupscheckMemberGroups Coleção de cadeias de caracteresString collection Verificar esse grupo quanto a uma associação em uma lista de grupos. Essa função é transitiva.Check this group for membership in a list of groups. The function is transitive.
getMemberGroupsgetMemberGroups Coleção de cadeias de caracteresString collection Retornar todos os grupos dos quais o grupo é membro. Essa função é transitiva.Return all the groups that the group is a member of. The function is transitive.
getMemberObjectsgetMemberObjects Coleção de cadeias de caracteresString collection Retornar todos os grupos dos quais o grupo é um membro. Essa função é transitiva.Return all of the groups that the group is a member of. The function is transitive.
Criar configuraçãoCreate setting groupSettinggroupSetting Crie um objeto de configuração com base em um groupSettingTemplate. A solicitação POST deve fornecer settingValues para todas as configurações definidas no modelo. Somente modelos específicos de grupos podem ser usados para essa operação.Create a setting object based on a groupSettingTemplate. The POST request must provide settingValues for all the settings defined in the template. Only groups specific templates may be used for this operation.
Obter configuraçãoGet setting groupSettinggroupSetting Ler propriedades de um objeto de configuração específico.Read properties of a specific setting object.
Listar configuraçõesList settings Conjunto groupSettinggroupSetting collection Lista propriedades de todos os objetos de configuração.List properties of all setting objects.
Atualizar configuraçãoUpdate setting groupSettinggroupSetting Atualizar um objeto de configuração.Update a setting object.
Excluir configuraçãoDelete setting NoneNone Excluir um objeto de configuração.Delete a setting object.
validatePropertiesvalidateProperties JSONJSON Valide se o nome de exibição do grupo do Office 365 ou apelido de email está em conformidade com as políticas de nomenclatura.Validate that an Office 365 group's display name or mail nickname complies with naming policies.
CalendarCalendar
Criar eventoCreate event eventevent Criar um novo Event postando na coleção de eventos.Create a new event by posting to the events collection.
Obter eventoGet event eventevent Ler as propriedades de um objeto event.Read properties of an event object.
Listar eventosList events Coleção de eventosevent collection Obter uma coleção de objetos de evento.Get an event object collection.
Atualizar eventoUpdate event NenhumNone Atualizar as propriedades de um objeto event.Update the properties of an event object.
Excluir eventoDelete event NenhumNone Excluir o objeto event.Delete event object.
Listar calendarViewList calendarView Coleção eventevent collection Obter um conjunto de eventos em uma janela de tempo especificada.Get a collection of events in a specified time window.
ConversasConversations
Criar conversaCreate conversation conversaconversation Crie uma nova conversa postando na coleção de conversas.Create a new conversation by posting to the conversations collection.
Obter conversaGet conversation conversationconversation Ler as propriedades de um objeto conversation.Read properties of a conversation object.
Listar conversasList conversations Coleção conversationconversation collection Obter uma coleção de objetos Conversation.Get a conversation object collection.
Excluir conversaDelete conversation NenhumNone Excluir objeto conversation.Delete conversation object.
Criar threadCreate thread conversationThreadconversationThread Criar um novo thread de conversa.Create a new conversation thread.
Acessar threadGet thread conversationThreadconversationThread Ler as propriedades de um objeto thread.Read properties of a thread object.
Listar threadsList threads Coleção conversationThreadconversationThread collection Obter todos os threads de um grupo.Get all the threads of a group.
Atualizar threadUpdate thread NenhumNone Atualizar as propriedades de um objeto thread.Update properties of a thread object.
Excluir threadDelete thread NenhumNone Excluir objeto thread.Delete thread object.
Listar acceptedSendersList acceptedSenders Coleção directoryObjectdirectoryObject collection Obtenha uma lista de usuários ou grupos que estão na lista de remetentes aceitos para este grupo.Get a list of users or groups that are in the accepted-senders list for this group.
Adicionar acceptedSenderAdd acceptedSender directoryObjectdirectoryObject Adicionar um Usuário ou Grupo à coleção acceptSenders.Add a User or Group to the acceptSenders collection.
Remover acceptedSenderRemove acceptedSender directoryObjectdirectoryObject Remover um Usuário ou Grupo da coleção acceptedSenders.Remove a User or Group from the acceptedSenders collection.
Listar rejectedSendersList rejectedSenders Coleção directoryObjectdirectoryObject collection Obtenha uma lista de usuários ou grupos que estão na lista de remetentes rejeitados para este grupo.Get a list of users or groups that are in the rejected-senders list for this group.
Adicionar rejectedSenderAdd rejectedSender directoryObjectdirectoryObject Adicionar um novo Usuário ou Grupo à coleção rejectedSenders.Add a new User or Group to the rejectedSenders collection.
Remover rejectedSenderRemove rejectedSender directoryObjectdirectoryObject Remover um novo Usuário ou Grupo da coleção Remetentesrejeitados.Remove new User or Group from the rejectedSenders collection.
Criar configuraçãoCreate setting groupSettinggroupSetting Crie um objeto de configuração com base em um groupSettingTemplate. A solicitação POST deve fornecer settingValues para todas as configurações definidas no modelo. Somente modelos específicos de grupos podem ser usados para essa operação.Create a setting object based on a groupSettingTemplate. The POST request must provide settingValues for all the settings defined in the template. Only groups specific templates may be used for this operation.
Obter configuraçãoGet setting groupSettinggroupSetting Ler propriedades de um objeto de configuração específico.Read properties of a specific setting object.
Listar configuraçõesList settings Conjunto groupSettinggroupSetting collection Lista propriedades de todos os objetos de configuração.List properties of all setting objects.
Atualizar configuraçãoUpdate setting NenhumNone Atualizar um objeto setting.Update a setting object.
Excluir configuraçãoDelete setting NoneNone Excluir um objeto de configuração.Delete a setting object.
Obter modelo de configuraçãoGet setting template NenhumNone Ler as propriedades de um modelo de configuração.Read properties of a setting template.
Listar modelo de configuraçãoList setting template NenhumNone Listar propriedades de todos os modelos de configuração.List properties of all setting templates.
Extensões abertasOpen extensions
Criar extensão abertaCreate open extension openTypeExtensionopenTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.Create an open extension and add custom properties to a new or existing resource.
Obter extensão abertaGet open extension Coleção openTypeExtensionopenTypeExtension collection Obtenha uma extensão aberta identificada pelo nome da extensão.Get an open extension identified by the extension name.
Extensões de esquemaSchema extensions
Adicionar valores de extensões de esquemaAdd schema extension values Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
Outros recursos de grupoOther group resources
Listar fotosList photos Coleção profilePhotoprofilePhoto collection Obter um conjunto de fotos de perfil para o grupo.Get a collection of profile photos for the group.
Listar plannerPlansList plannerPlans Coleção plannerPlanplannerPlan collection Obter os planos de planejador pertencentes ao grupo.Get Planner plans owned by the group.
Configurações do usuárioUser settings
addFavoriteaddFavorite NenhumNone Adicionar o grupo à lista de grupos de favoritos do usuário conectado.Add the group to the list of the signed-in user's favorite groups. Com suporte apenas para grupos do Office 365.Supported for only Office 365 groups.
removeFavoriteremoveFavorite NenhumNone Remover o grupo da lista de grupos favoritos do usuário conectado.Remove the group from the list of the signed-in user's favorite groups. Com suporte apenas para grupos do Office 365.Supported for only Office 365 groups.
Listar memberOfList memberOf Coleção directoryObjectdirectoryObject collection Obter os grupos e as unidades administrativas dos quais esse usuário é membro direto, da propriedade de navegação memberOf.Get the groups and administative units that this user is a direct member of, from the memberOf navigation property.
subscribeByMailsubscribeByMail NenhumNone Definir a propriedade isSubscribedByMail como true.Set the isSubscribedByMail property to true. Permitir que o usuário conectado receba conversas por email.Enabling the signed-in user to receive email conversations. Com suporte apenas para grupos do Office 365.Supported for only Office 365 groups.
unsubscribeByMailunsubscribeByMail NenhumNone Definir a propriedade isSubscribedByMail como false.Set the isSubscribedByMail property to false. Desabilitar o recebimento de conversas por email do usuário conectado.Disabling the signed-in user from receive email conversations. Com suporte apenas para grupos do Office 365.Supported for only Office 365 groups.
resetUnseenCountresetUnseenCount NenhumNone Redefinir unseenCount como 0 para todas as postagens que o usuário conectado não tenha visto desde a última visita.Reset the unseenCount to 0 of all the posts that the signed-in user has not seen since their last visit. Com suporte apenas para grupos do Office 365.Supported for only Office 365 groups.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
allowExternalSendersallowExternalSenders BooleanBoolean Indica se as pessoas externas à empresa podem enviar mensagens para o grupo.Indicates if people external to the organization can send messages to the group. O valor padrão é false.Default value is false.

Retornado apenas em $select.Returned only on $select.
assignedLicensesassignedLicenses Coleção assignedLicenseassignedLicense collection As licenças que são atribuídas ao grupo.The licenses that are assigned to the group.

Retornado apenas em $select.Returned only on $select. Somente leitura.Read-only.
autoSubscribeNewMembersautoSubscribeNewMembers BooleanBoolean Indica se novos membros adicionados ao grupo serão automaticamente inscritos para receberem notificações por email.Indicates if new members added to the group will be auto-subscribed to receive email notifications. Você pode definir essa propriedade em uma solicitação PATCH para o grupo. Não a defina na solicitação POST inicial que cria esse grupo.You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. O valor padrão é false.Default value is false.

Retornado apenas em $select.Returned only on $select.
classificaçãoclassification StringString Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou alto). Os valores válidos para esta propriedade são definidos criando um valor de configuração ClassificationList com base na definição de modelo.Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList setting value, based on the template definition.

Retornado por padrão.Returned by default.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Carimbo de data/hora da ocasião em que o grupo foi criado.Timestamp of when the group was created. Não é possível modificar o valor e ele é preenchido automaticamente quando o grupo é criado.The value cannot be modified and is automatically populated when the group is created. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
descriptiondescription StringString Uma descrição opcional para o grupo.An optional description for the group.

Retornado por padrão.Returned by default.
displayNamedisplayName StringString O nome de exibição do grupo.The display name for the group. Essa propriedade é obrigatória quando um grupo é criado e não pode ser apagado durante as atualizações.This property is required when a group is created and cannot be cleared during updates.

Retornado por padrão.Returned by default. Oferece suporte a $filter e $orderby.Supports $filter and $orderby.
groupTypesgroupTypes Coleção de cadeias de caracteresString collection Especifica o tipo de grupo e sua associação.Specifies the group type and its membership.

Se a coleção contiver Unified, o grupo será um grupo do Office 365; caso contrário, será um grupo de segurança.If the collection contains Unified then the group is an Office 365 group; otherwise it's a security group.

Se a coleção inclui DynamicMembership, o grupo tem associação dinâmica; caso contrário, a associação é estática.If the collection includes DynamicMembership, the group has dynamic membership; otherwise, membership is static.

Retornado por padrão.Returned by default. Oferece suporte a $filter.Supports $filter.
hasMembersWithLicenseErrorshasMembersWithLicenseErrors BooleanBoolean Indica se existem membros neste grupo com erros de licença da sua atribuição de licença baseada em grupo.Indicates whether there are members in this group that have license errors from its group-based license assignment.

Esta propriedade nunca é retornada em uma operação GET.This property is never returned on a GET operation. Você pode usá-lo como um argumento $filter para acessar os grupos que têm membros com erros de licença (ou seja, o filtro para essa propriedade é true).You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true). Veja um exemplo.See an example.
idid StringString O identificador exclusivo do grupo.The unique identifier for the group.

Retornado por padrão.Returned by default. Herdado de directoryObject.Inherited from directoryObject. Chave.Key. Não anulável.Not nullable. Somente leitura.Read-only.
isSubscribedByMailisSubscribedByMail BooleanBoolean Indica se o usuário conectado está inscrito para receber conversas de email.Indicates whether the signed-in user is subscribed to receive email conversations. O valor padrão é true.Default value is true.

Retornado apenas em $select.Returned only on $select.
licenseProcessingStatelicenseProcessingState StringString Indica o status da atribuição de licença de grupo para todos os membros do grupo.Indicates status of the group license assignment to all members of the group. O valor padrão é false.Default value is false. Somente leitura.Read-only. Valores possíveis: QueuedForProcessing, ProcessingInProgress e ProcessingComplete.Possible values: QueuedForProcessing, ProcessingInProgress, and ProcessingComplete.

Retornado apenas em $select.Returned only on $select. Somente leitura.Read-only.
emailmail StringString O endereço SMTP do grupo, por exemplo, "serviceadmins@contoso.onmicrosoft.com".The SMTP address for the group, for example, "serviceadmins@contoso.onmicrosoft.com".

Retornado por padrão.Returned by default. Somente leitura.Read-only. Oferece suporte a $filter.Supports $filter.
mailEnabledmailEnabled BooleanBoolean Especifica se o grupo está habilitado para email.Specifies whether the group is mail-enabled.

Retornado por padrão.Returned by default.
mailNicknamemailNickname StringString O alias de email do grupo, exclusivo na organização.The mail alias for the group, unique in the organization. Essa propriedade deve ser especificada quando um grupo é criado.This property must be specified when a group is created.

Retornado por padrão.Returned by default. Oferece suporte a $filter.Supports $filter.
onPremisesDomainNameonPremisesDomainName Cadeia de CaracteresString Contém o nome de domínio totalmente qualificado (FQDN) local, também chamado de dnsDomainName sincronizado no diretório local.Contains the on-premises , also called dnsDomainName synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local com o Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset Indica a última vez em que o grupo foi sincronizado com o diretório local. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.Indicates the last time at which the group was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Retornado por padrão.Returned by default. Somente leitura.Read-only. Oferece suporte a $filter.Supports $filter.
onPremisesNetBiosNameonPremisesNetBiosName Cadeia de CaracteresString Contém o netBios name local sincronizado no diretório local.Contains the on-premises **** synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local com o Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
onPremisesProvisioningErrorsonPremisesProvisioningErrors coleção OnPremisesProvisioningErroronPremisesProvisioningError collection Erros ao usar o produto de sincronização da Microsoft durante a configuração.Errors when using Microsoft synchronization product during provisioning.

Retornado por padrão.Returned by default.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString Contém o identificador de segurança (SID) local do grupo que foi sincronizado do local com a nuvem.Contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
onPremisesSamAccountNameonPremisesSamAccountName Cadeia de CaracteresString Contém o nome da conta SAM local sincronizado no diretório local.Contains the on-premises **** synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local com o Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean True se esse grupo está sincronizado de um diretório local; false se esse grupo foi originalmente sincronizado de um diretório local, mas não está mais sincronizado; null se esse objeto nunca foi sido sincronizado de um diretório local (padrão).true if this group is synced from an on-premises directory; false if this group was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default).

Retornado por padrão.Returned by default. Somente leitura.Read-only. Oferece suporte a $filter.Supports $filter.
preferredDataLocationpreferredDataLocation StringString O local de data preferido para o grupo.The preferred data location for the group. Saiba mais em OneDrive Online com Multi-Geo.For more information, see OneDrive Online Multi-Geo.

Retornado por padrão.Returned by default.
proxyAddressesproxyAddresses String collectionString collection Endereços de email para o grupo que direcionam para a mesma caixa de correio do grupo.Email addresses for the group that direct to the same group mailbox. Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"].For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. O operador any é obrigatório para filtrar expressões em propriedades de vários valores.The any operator is required to filter expressions on multi-valued properties.

Retornado por padrão.Returned by default. Somente leitura.Read-only. Não anulável.Not nullable. Oferece suporte a $filter.Supports $filter.
renewedDateTimerenewedDateTime DateTimeOffsetDateTimeOffset Carimbo de data/hora da ocasião em que o grupo foi renovado pela última vez.Timestamp of when the group was last renewed. Não é possível modificar isso diretamente e a atualização ocorre apenas por meio da ação de renovação de serviço.This cannot be modified directly and is only updated via the renew service action. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Retornado por padrão.Returned by default. Somente leitura.Read-only.
securityEnabledsecurityEnabled BooleanBoolean Especifica se o grupo é um grupo de segurança.Specifies whether the group is a security group.

Retornado por padrão.Returned by default. Oferece suporte a $filter.Supports $filter.
securityIdentifiersecurityIdentifier Cadeia de CaracteresString Identificador de segurança do grupo, usado em cenários do Windows.Security identifier of the group, used in Windows scenarios.

Retornado por padrão.Returned by default.
unseenCountunseenCount Int32Int32 Contagem das conversas que receberam novas postagens desde que o usuário conectado visitou o grupo pela última vez.Count of conversations that have received new posts since the signed-in user last visited the group.

Retornado apenas em $select.Returned only on $select.
visibilityvisibility StringString Especifica a visibilidade de um grupo do Office 365.Specifies the visibility of an Office 365 group. Valores possíveis são: Private, Public, ou Hiddenmembership; valores em branco são tratados como públicos.Possible values are: Private, Public, or Hiddenmembership; blank values are treated as public. Saiba mais em Opções de visibilidade do grupo.See group visibility options to learn more.
A visibilidade só pode ser configurada quando um grupo é criado, ela não é editável.Visibility can be set only when a group is created; it is not editable.
A visibilidade tem suporte apenas para grupos unificados; Não há suporte para grupos de segurança.Visibility is supported only for unified groups; it is not supported for security groups.

Retornado por padrão.Returned by default.

Opções de visibilidade do grupoGroup visibility options

Veja o que cada valor da propriedade de visibilidade significa:Here's what each visibility property value means:

ValorValue DescriçãoDescription
PúblicoPublic Qualquer pessoa pode ingressar no grupo sem precisar de permissão de proprietário.Anyone can join the group without needing owner permission.
Qualquer pessoa pode exibir o conteúdo do grupo.Anyone can view the contents of the group.
PrivadoPrivate A permissão de proprietário é necessária para ingressar no grupo.Owner permission is needed to join the group.
Não membros não podem exibir o conteúdo do grupo.Non-members cannot view the contents of the group.
HiddenmembershipHiddenmembership A permissão de proprietário é necessária para ingressar no grupo.Owner permission is needed to join the group.
Não membros não podem exibir o conteúdo do grupo.Non-members cannot view the contents of the group.
Não membros não podem ver os membros do grupo.Non-members cannot see the members of the group.
Administradores (global, empresa, usuário e helpdesk) podem visualizar a associação do grupo.Administrators (global, company, user, and helpdesk) can view the membership of the group.
O grupo aparece no catálogo de endereços global (GAL).The group appears in the global address book (GAL).

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
acceptedSendersacceptedSenders Coleção directoryObjectdirectoryObject collection A lista de usuários ou grupos que têm permissão para criar eventos de calendário ou postagens nesse grupo. Se essa lista não estiver vazia, somente os usuários ou grupos listados aqui poderão fazer postagens.The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post.
calendáriocalendar calendarcalendar O calendário do grupo. Somente leitura.The group's calendar. Read-only.
calendarViewcalendarView Coleção eventevent collection O modo de exibição do calendário. Somente leitura.The calendar view for the calendar. Read-only.
conversationsconversations Coleção conversationconversation collection As conversas do grupo.The group's conversations.
createdOnBehalfOfcreatedOnBehalfOf directoryObjectdirectoryObject O usuário (ou aplicativo) que criou o grupo. OBSERVAÇÃO: Não definido se o usuário for um administrador. Somente leitura.The user (or application) that created the group. NOTE: This is not set if the user is an administrator. Read-only.
Unidadedrive unidadedrive Unidade padrão do grupo.The group's default drive. Somente leitura.Read-only.
unidadesdrives Coleção drivedrive collection As unidades do grupo.The group's drives. Somente leitura.Read-only.
eventsevents Coleção eventevent collection Os eventos de calendário do grupo.The group's calendar events.
extensionsextensions Coleção extensionextension collection A coleção de extensões abertas definidas para o grupo. Somente leitura. Anulável.The collection of open extensions defined for the group. Read-only. Nullable.
groupLifecyclePoliciesgroupLifecyclePolicies Coleção groupLifecyclePolicygroupLifecyclePolicy collection O conjunto de políticas de ciclo de vida para esse grupo.The collection of lifecycle policies for this group. Somente leitura.Read-only. Anulável.Nullable.
memberOfmemberOf Coleção directoryObjectdirectoryObject collection Grupos dos quais esse grupo é membro. Métodos HTTP: GET (com suporte para todos os grupos). Somente leitura. Anulável.Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
membrosmembers Coleção directoryObjectdirectoryObject collection Os usuários e grupos que são membros desse grupo. Métodos HTTP: GET (com suporte para todos os grupos), POST (com suporte para grupos do Office 365, grupos de segurança e grupos de segurança habilitados para email), DELETE (com suporte para grupos do Office 365 e grupos de segurança) Anulável.Users and groups that are members of this group. HTTP Methods: GET (supported for all groups), POST (supported for Office 365 groups, security groups and mail-enabled security groups), DELETE (supported for Office 365 groups and security groups) Nullable.
membersWithLicenseErrorsmembersWithLicenseErrors Coleção userUser collection Uma lista de membros do grupo com erros de licença desse grupo baseado em atribuição de licença.A list of group members with license errors from this group-based license assignment. Somente leitura.Read-only.
onenoteonenote OnenoteOnenote Somente leitura.Read-only.
ownersowners Coleção directoryObjectdirectoryObject collection Os proprietários do grupo. Os proprietários são um conjunto de usuários não administradores e que têm permissão para modificar esse objeto. Limitado a 10 proprietários. Métodos HTTP: GET (com suporte para todos os grupos), POST (com suporte para grupos do Office 365, grupos de segurança e grupos de segurança habilitados para email), DELETE (com suporte para grupos do Office 365 e grupos de segurança). Anulável.The owners of the group. The owners are a set of non-admin users who are allowed to modify this object. Limited to 10 owners. HTTP Methods: GET (supported for all groups), POST (supported for Office 365 groups, security groups and mail-enabled security groups), DELETE (supported for Office 365 groups and security groups). Nullable.
Fotophoto profilePhotoprofilePhoto A foto de perfil do grupoThe group's profile photo
fotosphotos Coleção profilePhotoprofilePhoto collection As fotos de perfil pertencentes ao grupo. Somente leitura. Anulável.The profile photos owned by the group. Read-only. Nullable.
planejadorplanner plannerGroupplannerGroup Ponto de entrada para o recurso Planejador que pode existir para um Grupo unificado.Entry-point to Planner resource that might exist for a Unified Group.
rejectedSendersrejectedSenders Coleção directoryObjectdirectoryObject collection A lista de usuários ou grupos que não têm permissão para criar eventos de calendário ou postagens nesse grupo. AnulávelThe list of users or groups that are not allowed to create posts or calendar events in this group. Nullable
configuraçõessettings Conjunto groupSettinggroupSetting collection Somente leitura. Anulável.Read-only. Nullable.
sitessites conjunto de sitessite collection A lista de sites do SharePoint nesse grupo. Acesse o site padrão com /sites/root.The list of SharePoint sites in this group. Access the default site with /sites/root.
threadsthreads Coleção conversationThreadconversationThread collection Os threads de conversas do grupo. Anulável.The group's conversation threads. Nullable.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recurso.The following is a JSON representation of the resource.

{
  "allowExternalSenders": false,
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "autoSubscribeNewMembers": true,
  "classification": "string",
  "createdDateTime": "String (timestamp)",
  "description": "string",
  "displayName": "string",
  "groupTypes": ["string"],
  "hasMembersWithLicenseErrors": "Boolean",
  "id": "string (identifier)",
  "isSubscribedByMail": true,
  "licenseProcessingState": "string",
  "mail": "string",
  "mailEnabled": true,
  "mailNickname": "string",
  "onPremisesDomainName": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "string",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "string",
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "string",
  "proxyAddresses": ["string"],
  "renewedDateTime": "String (timestamp)",
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenCount": 1024,
  "visibility": "string",
  "acceptedSenders": [ { "@odata.type": "microsoft.graph.directoryObject"} ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [ { "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [ { "@odata.type": "microsoft.graph.event" }],
  "memberOf": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "members": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "membersWithLicenseErrors": [{"@odata.type": "microsoft.graph.user"}],
  "owners": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "sites": [ { "@odata.type": "microsoft.graph.site" } ],
  "threads": [ { "@odata.type": "microsoft.graph.conversationThread" }]
}

Confira tambémSee also