Feed-Dialog

Du kannst den Feed-Dialog zu deiner App hinzufügen, damit Nutzer individuelle Stories mit Kommentaren in ihrer Chronik veröffentlichen können.

Für das Teilen von Meldungen über den Feed-Dialog sind keine erweiterten Berechtigungen erforderlich.

Integration

Dieser Dialog kann mit den Facebook-SDKs für JavaScript, iOS und Android sowie durch Durchführen einer vollständigen URL-Umleitung verwendet werden. Im Folgenden findest du einige beispielhafte Codeausschnitte, die zum Auslösen dieses Dialogs verwendet werden können.

JavaScript

Um einen Feed-Dialog auszulösen, rufe die Funktion FB.ui auf und gib für den method-Parameter den Wert feed ein.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Lies unseren Leitfaden zum Dialog „Teilen“ unter iOS, der es dir ermöglicht, Open Graph-Meldungen zu veröffentlichen.

Android

Lies unseren Leitfaden zum Dialog „Teilen“ unter Android, der es dir ermöglicht, Open Graph-Meldungen zu veröffentlichen.

URL-Umleitung

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Hinweis

Wenn eine Person die Einstellung „Wer kann in deiner Chronik posten?“ auf „Nur ich“ festgelegt hat und eine andere Person versucht, über den Feed-Dialog in der Chronik der ersten Person einen Beitrag zu veröffentlichen, wird der Fehler angezeigt, dass kein Posten möglich ist.

Parameter

Hinweis: Wenn deine App Links zu den App Stores von iTunes oder Google Play bzw. zu einem Facebook-Profil oder einer Facebook-Seite teilt, posten wir keine Bilder oder Beschreibungen, die du im Teilvorgang mit den unten stehenden Parametern angegeben hast. Stattdessen posten wir einige App-Informationen, die wir mit dem Webcrawler direkt aus dem App Store oder von der Facebook-Seite auslesen. Hierbei sind möglicherweise keine Bilder enthalten. Um eine Vorschau des geteilten Links zu iTunes oder Google Play anzuzeigen, gib deine URL in den Sharing Debugger ein.

Parameter	Beschreibung
`app_id`	Die eindeutige ID deiner App. Erforderlich
`redirect_uri`	Die URL, an die eine Person umgeleitet wird, wenn sie auf einen Button im Dialog klickt. Bei der URL-Umleitung erforderlich.
`display`	Legt fest, wie der Dialog dargestellt wird. Wenn du die URL-Umleitung zur Dialogimplementierung verwendest, erfolgt die Anzeige als ganze Seite auf Facebook.com. Dieser Anzeigetyp wird als `page` bezeichnet. Wenn du das Facebook-SDK für iOS oder Android zum Aufrufen des Dialogs verwendest, wird dies automatisch angegeben und ein geeigneter Anzeigetyp für das Gerät ausgewählt. Wenn du das Facebook-SDK für JavaScript verwendest, wird standardmäßig ein modaler `iframe`-Typ für Personen verwendet, die sich bei deiner App anmelden. Bei Verwendung in einem Spiel auf Facebook.com wird `async` verwendet, für alle anderen Personen ein `popup`-Fenster. Du kannst bei Bedarf auch die `popup`- oder `page`-Typen erzwingen, wenn du das Facebook-SDK für JavaScript verwendest. Mobile Web-Apps verwenden standardmäßig immer den Anzeigetyp `touch`.
`from`	Die ID der Person, die die Nachricht postet. Wird dieser Wert nicht angegeben, wird standardmäßig die aktuelle Person verwendet. Wird der Wert angegeben, muss es sich um die ID der Person handeln oder aber um die ID der Seite, die die Person verwaltet.
`to`	Die ID des Profils, in dem diese Meldung veröffentlicht werden soll. Wird dieser Wert nicht angegeben, wird standardmäßig der Wert von `from` verwendet. Bei der ID muss es sich um einen Freund handeln, der die App ebenfalls verwendet.
`link`	Der Link, der mit diesem Beitrag verknüpft ist.
`source`	Die URL der Mediendatei (SWF oder MP3), die mit diesem Beitrag verknüpft ist. Bei SWF musst du auch `picture` angeben, um ein Miniaturbild für das Video bereitzustellen.
`ref`	Bei diesem Argument handelt es sich um eine durch Kommas getrennte Liste, die aus maximal fünf unterschiedlichen Elementen besteht, von denen jedes eine Länge von mindestens einem und maximal 15 Zeichen (0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_) aufweist. Jede Kategorie wird in Facebook-Statistiken verwendet, um dich bei der Messung der Performance verschiedener Arten von Beiträgen zu unterstützen.

Veraltete Parameter

Parameter	Beschreibung
`post_id`	Die ID der geposteten Meldung, wenn die Person diese in ihrer Chronik veröffentlicht.
`properties`	Ein JSON-Objekt eines Schlüssel/Wert-Paares, das im Stream-Anhang unterhalb der Beschreibung angezeigt wird (mit jeder Eigenschaft in einer eigenen Zeile). Bei Schlüsseln muss es sich um Strings und bei den Werten um Strings oder JSON-Objekte mit den Schlüsseln `text` und `href` handeln.
`actions`	Ein JSON-Array, das ein einzelnes Objekt enthält, das den Handlungslink beschreibt. Dieser wird neben den Links „Kommentieren“ und „Gefällt mir“ unter Beiträgen angezeigt. Das enthaltene Objekt muss über die Schlüssel `name` und `link` verfügen.
`picture`	Die URL eines Bildes, das mit diesem Beitrag verknüpft ist. Das Bild muss mindestens 200 x 200 Pixel groß sein. Weitere Informationen zu Größen findest du in unseren Best Practices zum Teilen.
`name`	Der Name des Linkanhangs.
`caption`	Die Linkunterschrift (wird unter dem Linknamen angezeigt). Wenn nicht angegeben, wird dieses Feld automatisch mit der URL des Links ausgefüllt.
`description`	Die Beschreibung des Links (wird unter der Linkunterschrift angezeigt). Wenn nicht angegeben, wird dieses Feld automatisch mit Informationen befüllt, die von dem Link ausgelesen werden – für gewöhnlich der Titel der Seite.
`thumbnail`	Die hochgeladene lokale Bilddatei (`.jpg`, `.jpeg`, `.gif` oder `.png`).