Riferimento

Post

Percorso /{POST-id}

Rappresenta un post di Workplace. Il nodo /{post-id} restituisce un singolo post.

Lettura

Restituisce un singolo oggetto Post che rappresenta un post in un gruppo, un evento o sul profilo di un utente.

Autorizzazioni

Per leggere un nodo Post, è necessaria l'autorizzazione Read group content.

Campi

Nome del campoDescrizioneTipo

id

L'ID del post.

string

created_time

L'ora in cui il post è stato inizialmente pubblicato.

datetime

formatting

Indica se il post è stato creato utilizzando un linguaggio di markup di formattazione. Il valore restituito indica quale linguaggio di markup è stato utilizzato. Workplace supporta Markdown e testo semplice.

enum {MARKDOWN|PLAINTEXT}

from

Le informazioni sulla persona o sul profilo che ha pubblicato il messaggio.

Profile

icon

Un link a un'icona che rappresenta la tipologia di questo post.

url

link

Il link allegato a questo post.

url

message

Il messaggio di stato nel post.

string

name

Il nome del link, se allegato al post.

string

object_id

L'ID di eventuali foto o video caricati allegati al post.

string

permalink_url

L'URL alla pagina del permalink del post.

url

picture

L'immagine sottoposta a scraping di qualsiasi link incluso con il post.

url

place

Qualsiasi informazione sul luogo allegata al post.

Place

poll

Se il post è un sondaggio, questo campo restituirà l'oggetto Question allegato, consentendoti di vedere le options e i votes dell'opzione scelta dagli utenti.

Question

properties

Una lista di proprietà per l'eventuale video allegato, ad esempio la durata del video.

object[]

status_type

Descrizione del tipo di aggiornamento di uno stato.

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

Testo di storie non intenzionalmente generate dagli utenti.

string

to

Profili menzionati o targetizzati in questo post.

Profile[]

type

Una stringa che indica il tipo di oggetto di questo post.

enum{link, status, photo, video}

updated_time

L'ora in cui il post è stato creato, l'ultima modifica o l'ora dell'ultimo commento lasciato sul post.

datetime

with_tags

Profili taggati di utenti che si trovano "con" l'editore del post.

L'oggetto JSON con un campo data che contiene una lista di oggetti Profile.

Pubblicazione

Non puoi pubblicare usando questo segmento. Per creare un nuovo post in un gruppo, utilizza il segmento /group/feed.

Eliminazione

Un post può essere eliminato tramite l'API Graph effettuando una richiesta DELETE sul percorso /{post_id}.

Autorizzazioni

Per l'eliminazione del nodo di un post sono necessarie le autorizzazioni Post to groups e Read all content o Read only open content, a seconda del gruppo in cui il post è stato creato.

Aggiornamento

Possono essere aggiornati solo i post creati da un bot, non quelli creati per conto di un utente con un impersonate_token. Un post può essere modificato effettuando una richiesta POST sul segmento /{post-id} con un message aggiornato nel corpo.

Segmenti

Nome del segmentoDescrizione

/attachments

Tutti gli allegati multimediali associati a questo post.

/comments

I commenti su questo post. Supporta un campo summary per ottenere il numero totale.

/likes

Le persone che hanno messo "Mi piace" a questo post. Supporta un campo summary per ottenere il numero totale.

/reactions

Le persone che hanno aggiunto una reazione a questo post. Supporta un campo summary per ottenere il numero totale.

/seen

Le persone che hanno visto questo post. Supporta un campo summary per ottenere il numero totale.

Sintassi Markdown supportata

Quando si pubblica un post su Workplace, è supportata la seguente sintassi Markdown:

FormattazioneSintassi

Grassetto

**Bold**

Sottolineatura

*Emphasize*

Link

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

Inline code

`Inline code`
code block
``` code block ```
  • Lista
* List
  1. Elenco numerato
1. Numbered list

Citazione

> Quote

Intestazione 1

# Heading 1

Intestazione 2

## Heading 2

Esempi

Per ottenere ID, source e story di un post

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

Per ottenere i commenti di un post

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

Per ottenere lo stato di visualizzazione per un post, incluso un riepilogo del numero totale

GET graph.facebook.com
  /{post-id}/comments?
  summary=true

Per pubblicare in un gruppo

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

Per taggare un utente nel post di un gruppo

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

Per pubblicare in un gruppo con la formattazione Markdown

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

Per leggere le opzioni delle domande del sondaggio e i voti sul sondaggio, utilizzando l'espansione dei campi

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