Teilen

Verwenden von Objekten

Verwandte Themen

Mit Facebook kannst du mithilfe einer stark typisierten API aus Objekten und Handlungen detaillierte, strukturierte Meldungen aus deiner App posten. Objekte sind die „Nomen“ oder Ziele für Handlungen, die Personen in deiner App ausführen.

Objekte werden durch Open Graph-HTML-Markup auf Webseiten definiert.

Erstellen von Objekten

Objekte werden erstellt, indem du Open Graph-Meta-Tags auf der Seite hinzufügst, auf der dein Inhalt gehostet wird.

Dies sind die grundlegenden Tags, die benötigt werden, um deine Seite zu einem Objekt zu machen. Füge sie zum <head> des HTML-Codes deiner Seite hinzu.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

In einigen Host- und Entwicklungsplattformen, bei denen du gleichzeitig eine Objektseite erstellst und das Objekt in Open Graph veröffentlichst, wird möglicherweise ein Fehler angezeigt, der besagt, dass das Objekt nicht vorhanden ist. Dies geschieht aufgrund einer Wettlaufsituation, einer Race Condition, die in einigen Systemen vorliegt. Wir empfehlen, dass du entweder vor dem Veröffentlichen einer Handlung in Open Graph überprüfst, ob die Objektseite erstellt wurde, oder dass du eine kurze Verzögerung einführst, um die Replikationslatenz zu berücksichtigen (z. B. 15 bis 30 Sekunden).


Testen

Du kannst dein Markup testen, indem du die entsprechende URL in den Sharing Debugger eingibst. Auf diese Weise werden die Tags angezeigt, die der Crawler ausgelesen hat, und es werden Fehler oder Warnungen ausgegeben.

Aktualisieren von Objekten

Der Facebook-Crawler liest die Objekte in diesen Fällen erneut aus (und aktualisiert sie somit):

  • Wenn die Objekt-URL im Sharing Debugger eingegeben wird
  • Alle 30 Tage nach dem ersten Auslesen
  • Wenn eine App einen Auslesevorgang mithilfe eines API-Endpunkts auslöst

Dieser Graph API-Endpunkt ist einfach ein Aufruf von:

POST /?id={object-instance-id or object-url}&scrape=true

Die Antwort von diesem Endpunkt ist ein JSON-Objekt, das alle Informationen zum ausgelesenen Objekt enthält (dies sind dieselben Daten wie diejenigen, die beim Lesen der Objekt-ID aus der Graph API zurückgegeben werden).

Der id-Parameter kann entweder die kanonische URL deines Objekts oder die ID der Objektinstanz in Graph sein.

Du kann die Eigenschaften eines Objekts jederzeit bearbeiten, mit zwei Ausnahmen:

  • Titel: Sobald 50 Handlungen („Gefällt mir“, Teilen, Kommentare) mit einem Objekt verknüpft sind, kannst du seinen Titel nicht mehr aktualisieren.
  • Typ: Der Typ eines Objekts kann nicht mehr geändert werden, sobald das Objekt in einer Meldung verwendet wurde. Weitere Informationen findest du unter Open Graph-Typen.

Wenn du ein Bild für ein Objekt aktualisieren möchtest, empfehlen wir dringend, für das Bild eine andere URL zu verwenden als für das ursprüngliche Bild. Durch die Zwischenspeicherung wird möglicherweise verhindert, dass das Bild aktualisiert wird.

Seitenmigrationen und Ändern von URLs

Wenn du eine Seite zu einer neuen URL verschiebst, kannst du die alte URL als kanonische Quelle für die neue URL verwenden, sodass „Gefällt mir“-Angaben, Teilvorgänge und Kommentare für das Objekt erhalten bleiben. In unserem Leitfaden Teilen für Webmaster erfährst du, wie das funktioniert.