Workplace

Publicação

Caminho /{POST-id}

Representa uma publicação do Workplace. O nó /{post-id} retorna uma publicação única.

Leitura

Retorna um objeto Post único que representa uma publicação em grupo, em evento ou no perfil de um usuário.

Permissões

A leitura de um nó de publicação requer a permissão Ler o conteúdo do grupo. Por outro lado, a leitura de uma publicação no perfil de um usuário requer a permissão Ler a linha do tempo do usuário.

Campos

Nome do campoDescriçãoTipo

id

A identificação da publicação com o formato {group-id}_{id}.

string

created_time

O horário em que a publicação foi feita inicialmente.

datetime

formatting

Indica se a publicação foi criada com uma linguagem de marcação de formatação. O valor de retorno informa qual linguagem foi usada. O Workplace é compatível com Markdown e com texto sem formatação.

enum {MARKDOWN|PLAINTEXT}

from

Informações sobre a pessoa ou perfil que publicou a mensagem.

Profile

icon

Link para um ícone que representa o tipo da publicação.

url

link

O link anexado à publicação.

url

message

A mensagem de status na publicação.

string

name

O nome do link, se estiver anexado à publicação.

string

object_id

O ID de qualquer foto ou vídeo carregado e anexado à publicação.

string

permalink_url

A URL da página de link permanente da publicação.

url

picture

A foto extraída de qualquer link incluído na publicação.

url

place

Quaisquer informações de localização anexadas à publicação.

Place

poll

Se a publicação for uma enquete, o campo retornará o objeto Question anexado. Com isso, você poderá ver as options e os votes de opção feitos pelos usuários.

Question

properties

Uma lista de propriedades para qualquer vídeo anexado, por exemplo, a duração.

object[]

status_type

Descrição do tipo de uma atualização de status.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

Texto de stories que não foi gerado intencionalmente pelos usuários.

string

to

Perfis mencionados ou direcionados na publicação.

Profile[]

type

Uma cadeia de caracteres que indica o tipo de objeto da publicação.

enum{link, status, photo, video}

updated_time

O horário da criação, da última edição ou do comentário mais recente na publicação.

datetime

Publicação

Não é possível publicar com essa borda. Para fazer uma nova publicação em um grupo, use a borda /group/feed.

Exclusão

É possível excluir uma publicação via Graph API ao fazer a solicitação DELETE no caminho /{post_id}.

Permissões

A exclusão de um nó de publicação requer a permissão Publicar em grupos, bem como a permissão Ler todo o conteúdo ou Ler somente o conteúdo aberto, a depender do grupo em que a publicação foi feita.

A exclusão de uma publicação na linha do tempo de um usuário requer a permissão Gerenciar a linha do tempo do usuário.

Atualização

Somente as publicações criadas por um bot poderão ser atualizadas. Em publicações feitas em nome de usuário com um impersonate_token, isso não será possível. Para editar uma publicação, você pode fazer uma solicitação POST na borda /{post-id} com uma message atualizada no corpo.

Bordas

Nome da bordaDescrição

/attachments

Todos os anexos de mídia associados à publicação.

/comments

Os comentários na publicação. Há compatibilidade com um campo summary para obter a contagem total.

/reactions

As pessoas que reagiram à publicação. Há compatibilidade com um campo summary para obter a contagem total. Aceita campos since=unix_timstamp e until=unix_timestamp para obter o número de reações em determinado intervalo de tempo.

/seen

As pessoas que viram a publicação. Há compatibilidade com um campo summary para obter a contagem total. Aceita campos since=unix_timstamp e until=unix_timestamp para obter o número de visualizações em determinado intervalo de tempo.


Observe que existem as mesmas limitações descritas aqui.

Sintaxe do Markdown compatível

Há compatibilidade com a seguinte sintaxe do Markdown ao fazer uma publicação no Workplace:

FormataçãoSintaxe

Negrito

**Bold**

Ênfase

*Emphasize*

Link

[Link](https://workplace.fb.com)

Inline code

`Inline code`
Bloco de código
``` code block ```
  • Lista
* List
  1. Lista numerada
1. Numbered list

Citação

> Quote

Título 1

# Heading 1

Título 2

## Heading 2

Exemplos

Obter ID, source e story de uma publicação

GET graph.facebook.com
  /{post-id}?fields=id,source,story

Obter os comentários de uma publicação

GET graph.facebook.com
  /{post-id}/comments

Obter o estado "seen" ("visto") de uma publicação, incluindo resumo de contagem total

GET graph.facebook.com
  /{group-id}_{post-id}/seen?
  summary=true

Publicar em um grupo

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

Marcar um usuário em uma publicação de grupo

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

Publicar em um grupo com formatação Markdown

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

Ler as opções de pergunta e os votos em uma publicação de enquete usando expansão de campo

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}

Excluir uma publicação

DELETE graph.facebook.com
  /{post-id}

Reações/visualizações em determinado intervalo de tempo

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600