Graph API Explorer-Leitfaden

Häufige Anwendungsfälle

• Erstelle schnell Zugriffsschlüssel.
• Rufe Codebeispiele für deine Abfragen ab.
• Erstelle Informationen zum Debuggen, die du in Support-Anfragen integrieren kannst.
• Teste API-Abfragen mit den Einstellungen deiner Produktions-App einschließlich der Berechtigungen, Features und Einstellungen für deine Anwendungsfälle.
• Teste API-Abfragen mit deiner Test- oder Entwicklungs-App, indem du Berechtigungen und Features mit einem Testnutzer oder Testdaten verwendest.

Anforderungen

• Ein Facebook-Entwicklerkonto
• Eine App,für die du eine Rolle hast, wie zum Beispiel eine Administrator-, Entwickler- oder Testerrolle.

Komponenten

Zugriffsschlüssel

Wenn du einen Zugriffsschlüssel erhältst, wird er oben rechts im Tool angezeigt. Dies ist der Zugriffsschlüssel, der für deine Graph API-Abfrage verwendet wird. Du kannst diesen Schlüssel kopieren und ihn in deiner App verwenden, um deinen Code zu testen.

Klicke auf das Informationssymbol, um Informationen über den aktuellen Zugriffsschlüssel einschließlich der damit verbundenen App zu erhalten und alle Berechtigungen zu sehen, die von dem*der Nutzer*in der App (also dir) erteilt wurden.

Du kannst einen neuen Zugriffsschlüssel generieren, wenn der Schlüssel abgelaufen ist oder du neue Berechtigungen hinzufügst.

Meta-App

Das Meta-App-Dropdown-Menü oben rechts zeigt alle Apps an, bei denen du eine Administrator-, Entwickler- oder Testerrolle hast. Verwende das Dropdown-Menü, um die App-Einstellungen, die du testen möchtest, auszuwählen.

Nutzer*in oder Seite

Über das Dropdown-Menü „Nutzer*in oder Seite“ kannst du App-, Nutzer*innen- und Seiten-Zugriffsschlüssel für die ausgewählte App abrufen und austauschen. Außerdem kannst du darüber deine App von deinem User-Node deinstallieren, wodurch der aktuelle Zugriffsschlüssel vernichtet wird.

Berechtigungen

Jedes Mal, wenn du einen Nutzer*innen-Zugriffsschlüssel anforderst,wird standardmäßig nur eine Berechtigung erteilt (public_profile). Mit dem Dropdown-Menü „Berechtigung“ kannst du Folgendes auswählen: Nutzerdaten-Berechtigungen, wie email und user_photos, Events, Gruppen und Seiten-Berechtigungen, wie manage_pages und ads_management sowie andere Berechtigungen wie instagram_basic- und publish_video-Berechtigungen. Dies ermöglicht es dem aktuellen App-Nutzer (also dir), der App spezifische Berechtigungen zu erteilen. Erteile nur solche Berechtigungen, die deine App auch tatsächlich benötigt.

Wenn sich deine App in der Entwicklung befindet, kannst du deiner App jede beliebige Berechtigung erteilen und deine Abfragen werden diese in Bezug auf Daten von Personen, die eine Rolle in deiner App haben, berücksichtigen. Wenn deine App jedoch live geschaltet ist, wird das Senden deiner Abfrage fehlschlagen, wenn du eine Berechtigung erteilst, für die deine App nicht durch den App-Review-Prozess genehmigt wurde.

Abfrage-String-Feld

Wenn du das Tool zum ersten Mal öffnest, wird eine Standardabfrage angezeigt. Du kannst die Abfrage bearbeiten, indem du eine neue eintippst oder indem du im Feld-Viewer nach Feldern suchst und diese auswählst, nachdem du die Abfrage durchgeführt hast. Alternativ kannst du auch die Dropdown-Menüs verwenden, um zwischen den Vorgangsmethoden zu wechseln und verschiedene Graph API-Versionen anzusprechen.

Um die Abfrage als Favorit zu speichern, klicke auf das Sternsymbol am Ende des Abfragefelds. Du kannst dir die als Favorit gespeicherten Abfragen durch Klicken auf das Buchsymbol anzeigen lassen.

Node-Feld-Viewer

Wenn du eine GET-Abfrage über einen Node sendest, werden im Feld-Viewer auf der linken Seite des Fensters der Node-Name und die von der Graph API zurückgegebenen Felder angezeigt. Du kannst deine Abfrage ändern, indem du nach neuen Feldern suchst und diese auswählst, indem du auf das Plussymbol klickst und aus den verfügbaren Feldern auswählst oder indem du unnötige Felder durch Aufheben der Markierung deaktivierst. Mit diesen Handlungen wird deine Abfrage im Abfrage-String-Feld dynamisch aktualisiert.

Antwortfenster

Die Antwort, die du unter dem Abfragestring findest, zeigt die zurückgegebenen Ergebnisse für deine zuletzt übermittelte Abfrage an.

Code abrufen

Wenn du mit deiner Abfrage zufrieden bist, klicke auf den Button „Code abrufen“ unten in der Mitte unter der Antwort, um einen auf der Abfrage basierenden Beispielcode zu erstellen. Normalerweise kannst du den Beispielcode nicht einfach durch Kopieren und Einfügen zu deiner Codebasis hinzufügen, aber er liefert dir einen hilfreichen Ausgangspunkt.

Debug-Informationen kopieren

Wenn deine Abfrage weiterhin fehlschlägt und du den Grund dafür nicht herausfindest, kannst du dich an das Support-Team für Entwickler*innen wenden; klicke auf diesen Button unten in der Mitte, um deine Abfrage- und Antwort-Details in die Zwischenablage zu kopieren. Sende diese Details in deiner Support-Anfrage mit. Dies hilft uns herauszufinden, was los ist.

Sitzung speichern

Klicke auf den Button „Sitzung speichern“ unten in der Mitte, um den aktuellen Stand deiner Abfrage zu speichern. Der Zugriffsschlüssel wird dabei entfernt. Den Link zu dieser Sitzung kannst du bei einer Anfrage an das Support-Team für Entwickler*innen mitsenden.

Beispielabfrage

Versuche, die Standardabfrage auszuführen, die beim ersten Laden des Graph API Explorers erscheint. Wenn du dies nicht bereits getan hast, öffne den Graph API Explorer in einem neuen Fenster, wähle aus dem Application Dropdown-Menü die App aus, die du testen möchtest, und rufe einen Nutzer-Zugriffsschlüssel ab.

Die Standardabfrage erscheint dann im Abfrage-String-Feld:

GET https://developers.facebook.com/v21.0/me?fields=id,name

Die Standardabfrage fragt die Felder id und name über den /me-Node ab. Dies ist ein spezieller Node, der entweder dem /User- oder dem /Page-Node, der vom Zugriffsschlüssel identifiziert wurde, zugeordnet wird. Da du einen Nutzer-Zugriffsschlüssel verwendest, wird er deinem User-Node zugeordnet.

Die Felder id und name sind öffentlich verfügbar und können zurückgegeben werden, wenn der Nutzer deiner App die default- oder public_profile-Berechtigungen erteilt hat. Diese Berechtigungen sind für alle Apps vorab genehmigt (du kannst dies durch Klicken auf das Informationssymbol im Zugriffsschlüssel-Feld bestätigen). Auf diese Weise musst du deiner App keine zusätzlichen Berechtigungen erteilen, damit deine Abfrage funktioniert. Klicke auf Zugriffsschlüssel abrufen und bestätige, dass du deiner App Zugriff auf deine öffentlich verfügbaren Nutzerinformationen gewähren möchtest.

Sende deine Abfrage, und deine App-spezifische Nutzer*innen-ID und dein Nutzer*innen-Name werden im Antwortfenster angezeigt.