Community

Pfad /community

Alternativer Pfad /company

Stellt deine Workplace-Community dar. Der /community-Node (alternativ /company) gibt ein einzelnes Community-Objekt vom Typ Gruppe zurück. Der Einfachheit halber kannst du dir bei der Verwendung der API das Stamm-Community-Objekt als Stammgruppe für die anderen Gruppen oder Communitys vorstellen.

Du findest deine Community-ID, indem du mit einem selbstdefinierten Integrations-Zugriffstoken einen Graph API-GET-Aufruf an graph.facebook.com/community durchführst.

In manchen Fällen kann eine Stamm-Community auch andere Communitys enthalten, die dann an der /groups-Edge der Stamm-Community erscheinen. Untergeordnete Communitys einer Stamm-Community können durch das Feld is_community von untergeordneten Gruppen unterschieden werden.

Das Vorhandensein einer oder mehrerer Communitys innerhalb einer Stamm-Community weist darauf hin, dass diese Workplace-Instanz Community-fähig ist.

Diese untergeordneten Communitys können wiederum an ihrer /groups-Edge abgefragt werden, um die Gruppen innerhalb dieser Community abzurufen. In jedem Fall zeigt die /groups-Edge nur direkt untergeordnete Gruppen dieser Community an. Eine Rekursion wird nicht durchgeführt.

Communitys können nicht über die API erstellt werden, aber die Mitglieder können auf die gleiche Weise wie Gruppenmitglieder verwaltet werden.

Lesen

GET graph.facebook.com
  /community

Berechtigungen

Der Community-Node erfordert entweder die Berechtigung Gruppeninhalte lesen oder Gruppen verwalten.

Veröffentlichung

Mit diesem Node kannst du keine Workplace-Community veröffentlichen.

Löschen

Mit diesem Node kannst du keine Workplace-Community löschen.

Aktualisieren

Mit diesem Node kannst du keine Workplace-Community aktualisieren.

Edges

Beispiele

Erstellen einer neuen Gruppe

Du kannst eine neue Gruppe für eine Workplace-Community erstellen, indem du eine POST-Anfrage an die /community/groups-Edge tätigst. Die Antwort enthält die ID der neu erstellten Gruppe. Beachte, dass du mindestens ein Mitglied hinzufügen und das Mitglied zum*zur Administrator*in machen musst, damit deine Gruppe Mitglieder anzeigt.

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Eine Liste aller Gruppen und Communitys für eine Stamm-Community abrufen:

GET graph.facebook.com
  /community/groups?fields=is_community

Eine Liste aller Mitglieder einer Stamm-Community abrufen:

GET graph.facebook.com
  /community/members

Eine Liste aller Mitglieder einer Stamm-Community abrufen und nach external_id filtern:

GET /community/members?
  external_ids=12356,abc123

Einen Inhalt melden (Beachte bitte, dass diese Edge am 30. April 2019 eingestellt wurde):

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Einer Stamm-Community eine neue Gruppe hinzufügen:

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Einer Nicht-Stamm-Community eine neue Gruppe hinzufügen:

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Ein Konto bereitstellen:

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Verfügbare Abzeichen anzeigen:

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

Kategorien auf Stammebene auflisten:

GET graph.facebook.com
  /community/knowledge_library_categories

Eine neue Kategorie auf Stammebene veröffentlichen:

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

Links für häufig verwendete Tools und andere Ressourcen innerhalb der Wissensdatenbank auflisten:

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Einen bestimmten Quick Link in der Wissensdatenbank lesen:

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Einen neuen Quick Link in der Wissensdatenbank hinzufügen:

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Einen bestimmten Quick Link in der Wissensdatenbank aktualisieren:

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Einen bestimmten Quick Link in der Wissensdatenbank löschen:

DELETE graph.facebook.com
        /{quick_link_id}