Workplace

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. Per leggere un post sul profilo di un utente è necessaria l'autorizzazione Read user timeline.

Campi

Nome del campoDescrizioneTipo

id

L'ID del post, con il formato {group-id}_{id}.

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 al 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

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 eliminare un nodo post sono necessarie l'autorizzazione Post to groups e una tra le autorizzazioni Read all content e Read only open content, a seconda del gruppo in cui è pubblicato il post.

Per eliminare un post dal diario di un utente, è necessaria l'autorizzazione Manage user timeline.

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.

/reactions

Le persone che hanno aggiunto una reazione a questo post. Supporta un campo summary per ottenere il numero totale. Supporta i campi since=unix_timstamp e until=unix_timestamp per ottenere il numero di reazioni entro un dato intervallo di tempo.

/seen

Le persone che hanno visto questo post. Supporta un campo summary per ottenere il numero totale. Supporta i campi since=unix_timstamp e until=unix_timestamp per ottenere il numero di visualizzazioni entro un dato intervallo di tempo.


Tieni presente che questo campo è soggetto alle stesse limitazioni descritte qui.

Sintassi di 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
  /{group-id}_{post-id}/seen?
  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 su un post con sondaggio, usando l'espansione dei campi

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

Per eliminare un post

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

Reazioni/Visualizzazioni in un dato intervallo di tempo

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