tipo de recurso post
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 um item de publicação individual numa entidade conversationThread .
Embora você não possa criar explicitamente uma postagem, seguir um destes procedimentos criaria uma postagem:
- Responder a uma postagem existente
- Responder a um thread existente
- Criar um thread em uma nova conversa
- Criar uma nova conversa
Esse recurso permite que você adicione seus próprios dados às propriedades personalizadas usando extensions.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar postagens | post | Obtenha as postagens do thread especificado. |
| Obter postagem | post | Obtenha as propriedades e os relacionamentos de uma postagem em um thread especificado. |
| Responder postagem | Nenhum | Responda a uma postagem e adicione uma nova postagem ao thread especificado em uma conversa de grupo. |
| Encaminhar postagem | Nenhum | Encaminhe uma postagem para um destinatário. |
| Anexos | ||
| List attachments | Coleção attachment | Obtenha todos os anexos em uma postagem. |
| Add attachment | attachment | Adicione um anexo a uma postagem. |
| Extensões abertas | ||
| Criar extensão aberta | openTypeExtension | Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso. |
| Obter extensão aberta | Coleção openTypeExtension | Obtenha uma extensão aberta identificada pelo nome da extensão. |
| Propriedades estendidas | ||
| Criar uma propriedade de valor único | postagem | Criar uma ou mais propriedades estendidas de valor único em uma postagem nova ou existente. |
| Obter uma propriedade de valor único | postagem | Obtenha postagens que contenham uma propriedade estendida de valor único usando $expand ou $filter. |
| Criar propriedade com múltiplos valores | postagem | Crie uma ou mais propriedades estendidas de vários valores em uma postagem nova ou existente. |
| Obter propriedade de múltiplos valores | postagem | Obtenha uma postagem que contenha uma propriedade estendida de vários valores usando $expand. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| body | itemBody | O conteúdo da postagem. Esta é uma propriedade padrão. Esta propriedade pode ser nula. |
| categories | Coleção de cadeias de caracteres | As categorias associadas à postagem. Cada categoria corresponde à propriedade displayName de uma outlookCategory que foi definida para um utilizador. |
| changeKey | String | Identifica a versão da postagem. Toda vez que a postagem muda, ChangeKey também muda. Isso permite que o Exchange aplique alterações na versão correta do objeto. |
| conversationId | String | ID exclusiva da conversa. Somente leitura. |
| conversationThreadId | String | ID exclusiva do thread de conversa. Somente leitura. |
| createdDateTime | DateTimeOffset | Especifica quando a postagem foi criada. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| from | recipient | Usado em cenários de acesso de representante. Indica quem postou a mensagem em nome de outro usuário. Esta é uma propriedade padrão. |
| hasAttachments | Booliano | Indica se a postagem tem pelo menos um anexo. Esta é uma propriedade padrão. |
| id | String | Somente leitura. |
| importância | importância | A importância de uma publicação de grupo: low, , normalhigh. |
| lastModifiedDateTime | DateTimeOffset | Especifica quando a postagem foi modificada pela última vez. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| newParticipants | Coleção recipient | Participantes da conversa que foram adicionados ao thread como parte desta postagem. |
| receivedDateTime | DateTimeOffset | Especifica quando a postagem foi recebida. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| sender | recipient | Contém o endereço do remetente. O valor de Sender será considerado o endereço do usuário autenticado caso o remetente não seja especificado. Esta é uma propriedade padrão. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| attachments | Coleção Attachment | A coleção de anexos fileAttachment, itemAttachment e referenceAttachment da mensagem. Somente leitura. Anulável. Suporta o $expand. |
| extensions | Coleção Extension | A coleção de extensões abertas definidas para a publicação. Somente leitura. Anulável. Suporta o $expand. |
| inReplyTo | Post | A publicação anterior à qual esta mensagem está a responder na conversaçãoThread. Somente leitura. Oferece suporte para $expand. |
| multiValueExtendedProperties | Coleção multiValueLegacyExtendedProperty | A coleção de propriedades estendidas de vários valores definidas para a postagem. Somente leitura. Anulável. |
| singleValueExtendedProperties | Coleção singleValueLegacyExtendedProperty | A coleção de propriedades estendidas de valor único definidas para a postagem. Somente leitura. Anulável. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["string"],
"changeKey": "string",
"conversationId": "string",
"conversationThreadId": "string",
"createdDateTime": "String (timestamp)",
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}