Graph API-Version

Gruppe

Eine Facebook-Gruppe.

Lesen

Gibt Informationen zu einem einzelnen Gruppenobjekt zurück. Verwende zum Abruf einer Liste der Gruppen, die ein Nutzer verwaltet, stattdessen das /user/groups-Edge.

Graph API Explorer
GET /v21.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Berechtigungen

  • groups_access_member_info: Damit kann deine App mitgliedsbezogene Daten zum Gruppeninhalt erhalten.
  • publish_to_groups: Damit kann deine App für einen Nutzer Inhalte in einer Gruppe veröffentlichen.

Für öffentliche und geschlossene Gruppen

Ein Zugriffsschlüssel für Nutzer

Für geheime Gruppen

Ein Zugriffsschlüssel für einen Administrator der Gruppe

Warnungen

  • Felder, die Nutzerinformationen enthalten, werden in Antworten nicht berücksichtigt, es sei denn, die Anfrage erfolgt mit einem Zugriffsschlüssel eines Administrators der Gruppe.

Felder

Eigenschaftsname Beschreibung Typ

id

Die Gruppen-ID

string

cover

Informationen zum Titelbild der Gruppe.

CoverPhoto

id

ID des Fotos dieses Titelbilds.

string

source

URL des Fotos dieses Titelbilds.

string

offset_y

Der vertikale Versatz des Fotos vom unteren Rand in Pixeln.

int

offset_x

Der horizontale Versatz des Fotos vom linken Rand in Pixeln.

int

description

Eine kurze Beschreibung der Gruppe.

string

email

Die E-Mail-Adresse für das Hochladen von Inhalten in die Gruppe. Diese kann nur von aktuellen Mitgliedern der Gruppe verwendet werden.

string

icon

Die URL für das Symbol der Gruppe.

string

member_count

Die Anzahl der Mitglieder in der Gruppe.

int

member_request_count

Die Anzahl der ausstehenden Mitgliederanfragen. Erfordert einen Zugriffsschlüssel eines Administrators der Gruppe. Die Anzahl wird nur zurückgegeben, wenn die Anzahl der ausstehenden Mitgliederanfragen größer als 50 ist.

int

name

Der Name der Gruppe.

string

owner

Ab Version 9.0 veraltet. Ist in allen Versionen ab 9. Februar 2021 veraltet.

User | Page

parent

Das übergeordnete Element dieser Gruppe, sofern vorhanden.

Group | Page

permissions

Die Berechtigungen, die ein Benutzer für eine in der Gruppe installierte App gewährt hat.

string

privacy

Die Privatsphäre-Einstellungen der Gruppe. Mögliche Werte sind CLOSED, OPEN und SECRET. Erfordert einen Zugriffsschlüssel eines Administrators der Gruppe.

string

updated_time

Der Zeitpunkt der letzten Aktualisierung der Gruppe (einschließlich Änderungen von Gruppeneigenschaften, Beiträgen und Kommentaren). Erfordert einen Zugriffsschlüssel eines Administrators der Gruppe.

datetime

Erstellen

Dieser Vorgang wird nicht unterstützt.

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.

Edges

Name Beschreibung

/admins

Dieses Edge ist seit dem 4. April 2018 veraltet.

/albums

Fotoalben im Besitz der Gruppe.

/docs

Dokumente im Besitz der Gruppe.

/events

Veranstaltungen im Besitz der Gruppe.

/feed

Beitrags-Feed im Besitz der Gruppe.

/files

Dateien im Besitz der Gruppe.

/live_videos

Live-Videos im Besitz der Gruppe.

/members

Dieses Edge ist seit dem 4. April 2018 veraltet.

/photos

Fotos im Besitz der Gruppe.

/videos

Videos im Besitz der Gruppe.