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 , , normal high . |
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"}
}