Referenz

Beitrag

Pfad /{POST-id}

Steht für einen Workplace-Beitrag. Der /{post-id}-Node gibt einen einzelnen Beitrag zurück.

Lesen

Gibt ein einzelnes Beitrags-Objekt zurück, das einen Beitrag in einer Gruppe, in einer Veranstaltung oder auf einem Nutzerprofil darstellt.

Berechtigungen

Für das Lesen von einem Beitrags-Node ist die Berechtigung Gruppeninhalte lesen erforderlich.

Felder

FeldnameBeschreibungTyp

id

Die Beitrags-ID.

string

created_time

Der Zeitpunkt, zu dem der Beitrag ursprünglich veröffentlicht wurde.

datetime

formatting

Gibt an, ob der Beitrag mit einer Markup Language für die Formatierung verfasst wurde. Der zurückgegebene Wert gibt an, welche Markup Language verwendet wurde. Workplace unterstützt Markdown und Klartext.

enum {MARKDOWN|PLAINTEXT}

from

Informationen über die Person oder das Profil, das die Nachricht gepostet hat.

Profile

icon

Ein Link zu einem Symbol, das für den Beitragstyp steht.

url

link

Der Link, der mit diesem Beitrag verknüpft ist.

url

message

Die Statusnachricht im Beitrag.

string

name

Der Name des link, falls dieser dem Beitrag angehängt wurde.

string

object_id

Die ID von hochgeladenen Fotos oder Videos, die an den Beitrag angehängt sind.

string

permalink_url

URL zur Permalink-Seite des Beitrags.

url

picture

Das Bild, das vom jeweiligen im Beitrag enthaltenen link gescraped wurde.

url

place

Alle Standortinformationen, die dem Beitrag angehängt wurden.

Place

poll

Falls der Beitrag eine Umfrage ist, gibt dieses Feld das angehängte Frage-Objekt zurück. Somit kannst du die options und die votes der Nutzer für die Option sehen.

Question

properties

Eine Liste der Eigenschaften von angehängten Videos, z. B. die Dauer.

object[]

status_type

Beschreibung des Typs eines Status-Updates.

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

Text von Stories, der nicht absichtlich von Nutzern generiert wurde.

string

to

In diesem Beitrag erwähnte oder in den Fokus genommene Profile.

Profile[]

type

Ein String, der den Objekttyp dieses Beitrags angibt.

enum{link, status, photo, video}

updated_time

Der Zeitpunkt, zu dem der Beitrag erstellt oder zuletzt bearbeitet wurde oder der Zeitpunkt des letzten Beitragskommentars.

datetime

with_tags

Profile, die so markiert sind, dass sie zum Herausgeber des Beitrags gehören.

JSON-Objekt mit einem data-Feld, das eine Liste von Profile-Objekten enthält.

Veröffentlichen

Mit dieser Edge ist das Veröffentlichen nicht möglich. Um einen neuen Beitrag in einer Gruppe zu erstellen, verwendest du die Edge /group/feed.

Löschen

Ein Beitrag kann über die Graph API gelöscht werden, indem eine DELETE-Anfrage an den Pfad /{post_id} gestellt wird.

Berechtigungen

Das Löschen eines Beitrags-Nodes erfordert sowohl die Berechtigung In Gruppen posten und entweder die Berechtigung Alle Inhalte lesen oder Nur offene Inhalte lesen, je nachdem, in welcher Gruppe der Beitrag erstellt wurde.

Aktualisieren

Nur Beiträge, die von einem Bot erstellt wurden, können aktualisiert werden. Beiträge, die mit einem impersonate_token im Auftrag eines Nutzers erstellt wurden, können nicht aktualisiert werden. Ein Beitrag kann bearbeitet werden, indem eine POST-Anfrage an der Edge /{post-id} mit einer aktualisierten message im Textkörper gestellt wird.

Edges

Edge-NameBeschreibung

/attachments

Alle mit diesem Beitrag verknüpften Medien-Anhänge.

/comments

Kommentare zu diesem Beitrag. Unterstützt ein summary-Feld, um eine Gesamtzahl zu erhalten.

/likes

Personen, denen dieser Beitrag gefällt. Unterstützt ein summary-Feld, um eine Gesamtzahl zu erhalten.

/reactions

Personen, die auf diesen Beitrag reagiert haben. Unterstützt ein summary-Feld, um eine Gesamtzahl zu erhalten.

/seen

Personen, die diesen Beitrag gesehen haben. Unterstützt ein summary-Feld, um eine Gesamtzahl zu erhalten.

Unterstützte Markdown-Syntax

Die folgende Markdown-Syntax wird beim Veröffentlichen eines Beitrags auf Workplace unterstützt:

FormatierungSyntax

Fett

**Bold**

Hervorheben

*Emphasize*

Link

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

Inline code

`Inline code`
code block
``` code block ```
  • Liste
* List
  1. Nummerierte Liste
1. Numbered list

Zitat

> Quote

Überschrift 1

# Heading 1

Überschrift 2

## Heading 2

Beispiele

Rufe die ID, source und story eines Beitrags ab.

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

Rufe die Kommentare eines Beitrags ab.

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

Rufe den „Gesehen“-Status eines Beitrags ab, einschließlich einer Zusammenfassung mit der Gesamtzahl.

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

Poste in einer Gruppe.

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

Markiere einen Nutzer in einem Gruppenbeitrag.

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

Poste in einer Gruppe mit Markdown-Formatierung.

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

Lies mithilfe der Felderweiterung die Umfrageoptionen und Stimmen eines Umfragebeitrags.

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