Zum Inhalt springen

Facebook in Jitterbit App Builder konfigurieren

App Builder unterstützt Facebooks Graph API nicht nativ, weder als Authentifizierungs- noch als Datenprovider. Da die Facebook Graph API jedoch als REST API verwendet werden kann und durch den OAuth Client Credential Flow gesichert ist, lässt sich Facebooks Graph API über App Builders generischen HTTP-Sicherheitsprovider nutzen, um Daten von Facebook abzurufen.

Die Dokumentation von Facebook zur Verwendung des OAuth Client Credentials Flow findest du hier:

https://developers.facebook.com/docs/facebook-login/access-tokens#apptokens

Die wichtigsten Aufgaben sind:

  1. App Builder als Facebook-Anwendung registrieren.
  2. Einen Facebook HTTP-Sicherheitsprovider erstellen
  3. Eine Facebook-Datenquelle erstellen.

Es wird davon ausgegangen, dass deine Organisation bereits über ein bestehendes Facebook-Konto verfügt. Darüber hinaus wird davon ausgegangen, dass sich die Organisation als Facebook-Anwendungsentwickler registriert hat.

App Builder als Facebook-Anwendung registrieren

Melde dich zunächst im Facebook App Dashboard an.

https://developers.facebook.com/apps/

  1. Klicke auf die Schaltfläche Add a New App (Neue App hinzufügen).

  2. Gib die folgenden Informationen ein:

    • Display Name: Ein aussagekräftiger Name für die App Builder-Umgebung oder Anwendung.

      Beispiel: App Builder

    • Contact Email: Deine E-Mail-Adresse.

    • Category: Business

  3. Klicke auf die Schaltfläche Create App ID (App-ID erstellen).

  4. Wähle Dashboard aus dem Menü.
  5. Klicke auf die Schaltfläche Show (Anzeigen) unter App Secret.

  6. Notiere dir die folgenden Eigenschaften:

    • App ID: Dies wird der Wert von ClientId beim Konfigurieren des HTTP-Sicherheitsproviders in App Builder.
    • App Secret: Dies wird der Wert von ClientSecret beim Konfigurieren des HTTP-Sicherheitsproviders in App Builder.

Einen Facebook HTTP-Sicherheitsprovider erstellen

Um einen HTTP-Sicherheitsprovider zu erstellen, meldest du dich zunächst als Administrator in App Builder an.

  1. Navigiere zur IDE
  2. Wähle die Schaltfläche Security Providers (Sicherheitsprovider)
  3. Klicke auf die Schaltfläche + Security Provider (+ Sicherheitsprovider)

  4. Gib Folgendes ein:

    • Name: Facebook
    • Type: HTTP
    • Enabled: Aktiviert
    • Authentication Type: Client Credentials
    • Klicke auf die Schaltfläche Save (Speichern)

  5. Lege die folgenden Eigenschaften fest. Klicke im Properties-Panel auf die Schaltfläche + Property (+ Eigenschaft) → Wähle den Parameter → Gib den Value (Wert) ein → Klicke auf das Save-Symbol (Speichern).

    • AuthenticationType: ClientCredentials
    • TokenEndpoint: https://graph.facebook.com/v2.8/oauth/access_token
    • Der Token-Endpunkt muss die Versionsnummer enthalten. Die Version muss 2.0 oder höher sein. Zum Zeitpunkt dieser Dokumentation ist 2.8 die aktuelle Version der Facebook Graph API.
    • ClientId: Die {App ID} von Facebook
    • ClientSecret: Das {App Secret} von Facebook

Eine Facebook-Datenquelle erstellen

Um eine Facebook-Datenquelle zu erstellen, meldest du dich zunächst als Administrator in App Builder an.

  1. Navigiere zur IDE
  2. Klicke auf die Schaltfläche Data Servers (Datenserver)
  3. Klicke auf + Server

  4. Gib Folgendes ein:

    • Server Name: Facebook
    • Type: REST API
    • Sub Type: REST
    • URL: https://graph.facebook.com/
    • Request Content Type: JSON
    • Response Content Type: JSON

  5. Erweitere Security Settings (Sicherheitseinstellungen) und setze Security Provider (Sicherheitsprovider) auf den im vorherigen Schritt konfigurierten Facebook-Wert

  6. Klicke auf Save (Speichern)
  7. Klicke auf das Tables-Symbol (Tabellen) unter Server Settings (Servereinstellungen), um die Endpoints-Informationen zu konfigurieren
  8. Klicke im Endpoints-Panel auf die Schaltfläche + Endpoint (+ Endpunkt)

  9. Gib Folgendes ein:

    • Name: Page
    • Endpoint: {{Page}}?fields=fan_count

  10. Klicke auf das checkmark-Symbol (Häkchen)

  11. Klicke im Endpoint Parameters-Panel auf die Schaltfläche + Parameter (+ Parameter)

  12. Gib Folgendes ein:

    • Name: Page
    • Data type: String
    • Test value: zudysoftware

  13. Klicke auf die Schaltfläche Save (Speichern)

  14. Klicke im Endpoints-Panel auf die Schaltfläche Discover (Entdecken) und klicke erneut auf Discover (Entdecken)

Dieser Importvorgang füllt den Panel SQL Results aus.

  1. Im Panel SQL Results suchen Sie die Tabelle Page und klicken Sie auf das Symbol Results.

Sofern alles korrekt konfiguriert wurde, sollten Sie die Follower-Anzahl für das Facebook-Konto von zudysoftware sehen.

Fehlerbehebung

Fehler: "Unexpected character encountered while parsing value: a. Path '', line 0, position 0."

Das bedeutet, dass der Response-Text nicht als JSON serialisiert wurde. Stellen Sie sicher, dass der Token-Endpoint eine Versionsnummer enthält und die Version größer als 2.0 ist.