Mitglied

Pfad /{member-id}

Repräsentiert ein Nutzer*innenobjekt als Mitglied einer Workplace-Community oder -Gruppe.

Pfad /community/members

Gibt eine Liste aller aktuellen Nutzer*innenkonten zurück. Erfordert die Berechtigung Arbeitsprofile verwalten.

Filterung anhand von external_id

Um Nutzer*innen nach einer externen ID zu filtern, kannst du den Parameter external_ids verwenden und eine kommagetrennte Liste der externen IDs der gewünschten Nutzer*innen übergeben.

Pfad /community/organization_members

Gibt eine Liste der Nutzer*innen zurück. Erfordert die Berechtigung Gruppenmitgliedschaft lesen. Standardmäßig werden aktive Nutzer*innenkonten aufgelistet. Verwende den URL-Parameter inactive=1, um stattdessen deaktivierte Nutzer*innenkonten anzuzeigen.

Lesen

Gibt ein einzelnes User-Objekt zurück, das eine*n Workplace-Nutzer*in repräsentiert. Kann entweder über die Workplace-ID des Mitglieds oder über die E-Mail-Adresse abgerufen werden, mit der sich das Mitglied beim Workplace anmeldet.

• /{member_id}
• /{email_address}

Berechtigungen

Um Informationen über Mitglieder lesen zu können, brauchst du eine der Berechtigungen Arbeitsprofil lesen oder Konten verwalten. Wenn eine Integration die Berechtigung Konten verwalten verwendet und auf bestimmte Gruppen beschränkt ist, hat sie keinen Zugriff auf bestimmte Mitgliedsfelder.

Felder

Veröffentlichen

Siehe Account Management API (Graph)

Löschen

Siehe Account Management API (Graph)

Aktualisieren

Siehe Account Management API (Graph)

Edges

Beispiele

Informationen über ein Community-Mitglied abrufen

Name und E-Mail-Adresse eines Mitglieds abrufen

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

Mitglieds-ID über die E-Mail-Adresse abrufen

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

Unternehmensmitglieder über die externen IDs der Nutzer*innen abrufen

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

Unternehmensmitglieder inklusive deaktivierter Konten abrufen

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

Events eines Mitglieds abrufen:

GET graph.facebook.com
      /{member-id}/events

Informationen über den*die Manager*in und die Berichte eines*einer Nutzer*in abrufen

Berichte eines Mitglieds abrufen

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

Manager*in eines Mitglieds abrufen

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

Nachrichten für ein Mitglied abrufen

Unterhaltungen für ein Mitglied abrufen, inklusive Nachrichten, Absender*innen und Anhänge

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Alle Nachrichten lesen:

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

Unterhaltungs-Thread-IDs für ein Mitglied nach Thread abrufen

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Alle Nachrichten lesen:

GET graph.facebook.com
      /{member-id}/conversations

Nachrichten für eine bestimmte Thread-ID für eine*n Nutzer*in abrufen

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Alle Nachrichten lesen:

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

Unterhaltungen für eine Bot-Seite abrufen, inklusive Nachrichten und Anhänge

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

Eine bestimmte Nachricht im Postfach eines Mitglieds mit einem selbstdefinierten Integrationstoken löschen:

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Chat-Nachrichten löschen:

DELETE graph.facebook.com
      /{message-id}?user={user-id}

Datum und Uhrzeit abrufen, zu denen ein Mitglied eingeladen wurde und das Konto beansprucht hat:

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Konten verwalten:

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

Datum und Uhrzeit abrufen, zu denen ein Mitglied eingeladen wurde und das Konto beansprucht hat:

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Konten verwalten:

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

Nutzer*in aus Workplace abmelden

Erfordert ein Zugriffstoken mit der Berechtigung Abmeldung:

POST graph.facebook.com
      /{member-id}/logout

Profilbild festlegen

Erfordert ein Zugriffstoken mit der Berechtigung Arbeitsprofile verwalten. Unterstützt sowohl eine Datei-URL als auch einen Datei-Upload in der Anfrage.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

Telefon eines Mitglieds hinzufügen

Erfordert ein Zugriffstoken mit der Berechtigung Arbeitsprofile verwalten.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

Fähigkeiten eines Mitglieds abrufen

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Arbeitsprofil lesen.

GET graph.facebook.com
      /{member-id}/skills

Fähigkeit hinzufügen

Erfordert ein Zugriffstoken mit der Berechtigung Arbeitsprofil verwalten.

POST graph.facebook.com
      /{member-id}/skills?name={...}

Fähigkeit entfernen

Erfordert ein Zugriffstoken mit der Berechtigung Arbeitsprofil verwalten.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

Abzeichen eines Mitglieds abrufen

Erfordert ein selbstdefiniertes Integrationstoken mit der Berechtigung Arbeitsprofil lesen.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

Nutzer*in ein integriertes Abzeichen verleihen

Erfordert ein Zugriffstoken mit der Berechtigung Abzeichen verwalten. Unter Community findest du eine Liste der verfügbaren Abzeichen und deren IDs.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

Nutzer*in ein selbstdefiniertes Abzeichen verleihen

Erfordert ein Zugriffstoken mit der Berechtigung Abzeichen verwalten. Unter Community findest du eine Liste der verfügbaren Abzeichen und deren IDs. Beachte, dass das # in der URL für URLs codiert werden muss.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

Mitglied deaktivieren

Erfordert ein Integrationstoken mit der Berechtigung Nutzerkonten bereitstellen.

POST graph.facebook.com
      /{member-id}?active=false

Mitglied löschen

Erfordert ein Integrationstoken mit der Berechtigung Nutzerkonten bereitstellen.

DELETE graph.facebook.com
      /{member-id}

Frontline-Status einer Person abrufen

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }