Teilen

Teilen für Geräte

Dieser Endpunkt wurde am 2. November 2020 eingestellt.

Mit der Funktion Teilen für Geräte können Personen ganz einfach Content von Geräten auf Facebook teilen. Dazu zählen Smart-TVs, digitale Fotorahmen oder Internet-of-Things-Geräte.

Bei der Geräteteilung wird auf deinem Gerät ein alphanumerischer Code angezeigt, den*die Nutzer*in auf einer Webseite oder über ihren Desktop-PC oder ihr Smartphone eingeben sollen. Personen, die deine App oder deinen Service nutzen, können dann mit einem dem Code zugewiesenen „Teilen“-Dialog Content auf Facebook teilen.

Wenn du eine App für Apple TV oder Android-Geräte entwickelst, solltest du dazu das Facebook-SDK für tvOS oder das Facebook-SDK für Android verwenden.

In diesem Leitfaden wird Folgendes beschrieben:

Benutzererfahrung

1. Call to Action

Überlege dir zuerst, wann du eine*n Nutzer*in dazu auffordern möchtest, Content auf Facebook zu teilen. Um die am besten geeignete Nutzererfahrung zu gewährleisten, sollte der Button dem offiziellen „Teilen“-Button von Facebook möglichst ähnlich sehen. Grundsätzlich sollte der Button neben dem zu teilenden Content angezeigt werden.

Das bedeutet designtechnisch Folgendes:

  1. Benenne den Button mit „Teilen“ oder „Auf Facebook teilen“.
  2. Verwende Weiß und das offizielle Facebook-Blau: #3B5998.
  3. Wenn deine App eine graphische Anzeige unterstützt, kannst du auch das offizielle „f“-Logo einbinden. Gemäß der Facebook-Markenrichtlinien sollte das Logo immer entweder weiß oder Facebook-blau (#3B5998) sein.

2. Zeige den Code an

Wenn ein*e Nutzer*in auf den „Call to Action“-Button klickt, ruft dein Gerät die Facebook-API auf, die einen Code zurücksendet.

Informiere Nutzer*innen über die UI mit der folgenden Nachricht, dass sie eine Webseite aufrufen und dort den Code eingeben müssen: „Besuche als Nächstes facebook.com/device (http://facebook.com/device) über deinen Desktop-PC oder dein Smartphone und gib diesen Code ein.“ Zeige den vollständigen Code an, den du von der Device Share API von Facebook erhalten hast. Der Code ist zwischen 6 und 12 Zeichen lang.

Füge einen Close- oder Done-Button hinzu, damit Nutzer*innen den Ablauf zum Teilen von Geräten abschließen können.

3. Teilen

Nutzer*innen sehen diesen Vorgang, wenn sie facebook.com/device über ihren Desktop- oder Mobilgerät-Browser aufrufen. Ihnen wird zuerst ein Textfeld angezeigt, in das sie den Code eingeben können:

Nachdem sie den Code eingegeben und auf Continue geklickt haben, wird der „Teilen“-Dialog angezeigt:

Damit Nutzer*innen wissen, dass der Teilvorgang erfolgreich war, erhalten sie daraufhin eine Bestätigungsnachricht:

Implementierung von Teilen für Geräte

Facebook Teilen für Geräte ist für Geräte gedacht, die HTTP-Aufrufe über das Internet durchführen können. Dein Gerät kann folgende API-Aufrufe und -Antworten durchführen und erhalten:

1. Aktiviere die Anmeldung für Geräte

Lade dein App-Dashboard und ändere unter „Einstellungen > Erweitert > OAuth-Einstellungen > Anmeldung an Geräten“ die Auswahl in „Ja“.

2. Generiere einen Code

Wenn ein*e Nutzer*in auf den „Call to Action“-Button Share klickt, sollte dein Gerät einen HTTP-POST abschicken an:

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

Der CLIENT_TOKEN befindet sich in den App-Einstellungen unter „Erweitert“ und sollte mit deiner App-ID kombiniert werden (durch ein Pipe-Zeichen | getrennt), um den vollständigen access_token zu bilden.

Die API unterstützt auch action_type und action_properties anstelle von href, wenn du eine Open Graph-Meldung teilen möchtest (genauso wie Open Graph-Handlungen im „Teilen“-Dialog).

Die API unterstützt auch quote und hashtag-Parameter (genauso wie „Teilen“-Dialog-Parameter).

Die Antwort hat folgende Form:

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

Diese Antwort bedeutet Folgendes:

  1. Zeige den String „A1NWZ9“ auf deinem Gerät an.
  2. Fordere den*die Nutzer*in auf, „facebook.com/device“ aufzurufen und diesen Code einzugeben.
  3. Der Code läuft nach 420 Sekunden ab. Nach diesem Zeitraum sollten Sie die Codeanzeige schließen.

3. Zeige den Code an

Dein Gerät sollte den user_code anzeigen und den*die Nutzer*in auffordern, die verification_uri (z. B. facebook.com/device) über den PC oder das Smartphone aufzurufen. Siehe Nutzererfahrung.

Problembehebung

Kann ich Gerätevorgangsanfragen über HTTP durchführen?
Graph API mit Schlüsseln erfordert TLS/HTTPS.

Kann ich Gerätevorgangsanfragen mit der GET-Methode durchführen?
Alle Gerätevorgangsanfragen sollten POST-Anfragen sein.

Kann ich sehen, ob eine Person einen Teilvorgang abgeschlossen hat?
Nein.

Kann ich für die Person programmgesteuert veröffentlichen?
Nein. Hierfür musst du den*die Nutzer*in auffordern sich anzumelden und dir Berechtigungen zu erteilen, in seinem*ihrem Namen zu veröffentlichen. Weitere Informationen dazu findest du unter Veröffentlichen mit der Graph API.