Leitfäden

Dieser Leitfaden beschreibt die häufigsten Anwendungsfälle der Groups API.

Beiträge für eine Gruppe abrufen

Du kannst einen GET-Vorgang auf der /{group-id}/feed-Edge ausführen, um Beiträge für eine Gruppe abzurufen.

Standardmäßig werden die personenbezogenen Informationen nicht in die Antwort übernommen. Um die öffentlich verfügbaren Informationen zum Autor des Beitrags in die Antwort zu übernehmen, muss der Autor des Beitrags deiner App die groups_access_member_info-Berechtigung erteilen.

Beispielanfrage

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/feed?limit=5&access_token=EAACEdEos0..."

Beispielantwort

Beispielantwort ohne personenbezogene Informationen.

{
  "data": [
    {
      "message": "I love this group!",
      "updated_time": "2018-06-28T23:31:49+0000",
      "id": "554611227955614_1708186035931455"  //Post ID
    },
    {
      "message": "I like how linked groups look on mobile!",
      "updated_time": "2018-06-14T23:19:02+0000",
      "id": "554611227955614_1687969857953073"  //Post ID
    }
  ]
}

Beispielantwort

Beispielantworten, bei denen der*die Autor*in des Beitrags deiner App die groups_access_member_info-Berechtigung erteilt hat.

{
  "data": [
    {
      "from": {
        "name": "Himanshu Sharma",
        "id": "512130107215"
      },
      "message": "I love this group!",
      "id": "554611227955614_1708186035931455"
    },
    {
      "from": {
        "name": "Ronak Patel",
        "id": "512130107214"
      },
      "message": "Just testing how linked groups look like on mobile!",
      "id": "554611227955614_1687969857953073"
    }
  ]
}

Einschränkungen

• Aufrufe geben nur Daten zu Beiträgen zurück, die in den letzten 90 Tagen erstellt wurden.

Abrufen von Benutzer*innen, die öffentliche Felder teilen

Du kannst einen GET-Vorgang auf der /{group-id}/opted_in_members-Edge ausführen, um eine Liste mit Gruppenmitglieder-Benutzer*innen abzurufen die deiner App die groups_access_member_info-Berechtigung erteilt haben. Das sind Gruppenmitglieder, die angegeben haben, dass ihre öffentlichen Daten mit in der Gruppe installierten Apps geteilt werden dürfen.

Beispielanfrage

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/opted_in_members&access_token=EAACEdEos0..."

Beispielantwort

{
  "data": [
    {
      "name": "Himanshu Sharma",
      "id": "510765591715"
    },
    {
      "name": "Ronak Patel",
      "id": "410662391314"
    }
  ]
}

Webhooks für Gruppen erhalten, die deine App installieren oder deinstallieren

Du kannst das group_install-Feld für das Application-Objekt abonnieren, um eine Webhook-Benachrichtigung zu erhalten, wenn ein Gruppenmitglied deine App für eine Gruppe installiert oder deinstalliert.

Beispielbenachrichtigung

{
  "field": "group_install",
  "value": {
    "group_id": "954704787945183",
    "update_time": "1527459824",
    "verb": "add",
    "actor_id": "499619301"
  }
}