Graph API
Graph API-Version

URL /?id={url}

Steht für eine URL, die in einem Kommentar oder einem Beitrag geteilt wird.

Zusätzliche Details findest du in unserer Dokumentation zur News Tab Indexing API.

Lesen

Sieh dir Informationen über eine URL an, die in einem Beitrag oder einem Kommentar zu einem Beitrag geteilt wird.

Anforderungen

TypBeschreibung
Zugriffsschlüssel

Für diese Anfrage kann jeder Zugriffsschlüssel verwendet werden.

Features

Nicht zutreffend.

Seitenaufgaben

Nicht zutreffend.

Berechtigungen

Nicht zutreffend.

Einschränkungen

  • Zurückgegebene Interaktionswerte sind nicht genau, spiegeln aber die Nutzer*innen-Interaktionen mit einer URL wider.
  • Für dich gilt eine Beschränkung auf 10 GET-Anfragen pro URL pro App pro Stunde.

Parameter

Schließe die folgenden Abfrage-String-Parameter ein, um die Anfrage zu erweitern.

ParameterBeschreibung

access_token

Erforderlich

String

Ein Zugriffsschlüssel.

fields

String

Eine durch Komma getrennte Liste der Felder, die du anfordern möchtest.

id

String

Die zu teilende URL.

scopes

String

Eine durch Komma getrennte Liste der Bereiche.

Felder

Eigenschaftsname Beschreibung Typ
app_links

Mit dieser URL verknüpfte AppLinks-Daten, sofern verfügbar.

AppLinks

id

Die eigentliche URL.

string

engagement

Anzahlen der unterschiedlichen Interaktionen mit der URL. Beachte, dass Interaktionswerte absichtlich nicht präzise sind, aber du kannst sicher sein, dass sie Nutzerinteraktionen mit einer URL genau wiedergeben.

object

comment_count

Anzahl der Kommentare zur URL.

int

comment_plugin_count

Anzahl der Kommentare zum Plugin, die mit dem Kommentar-Plugin auf deiner Webseite gesammelt wurden.

int

reaction_count

Anzahl der Reaktionen auf die URL.

int

share_count

Häufigkeit, mit der die URL geteilt wurde.

int

og_object

Das Open Graph-Objekt, das kanonisch mit dieser URL verknüpft ist.

OGObject

id

ID des Objekts.

string

description

Gegebenenfalls die Beschreibung des Objekts.

string

title

Gegebenenfalls der Titel des Objekts.

string

type

Der Objekttyp.

og:type

updated_time

Gibt an, wann das Objekt zuletzt aktualisiert wurde.

datetime

Beispiele

Sende zum Abrufen von Informationen über eine in einem Beitrag oder Kommentar veröffentlichte URL eine GET-Anforderung an https://graph.facebook.com, wobei der Parameter id auf Folgendes festgelegt ist: die URL, alle Felder über die URL und einen Zugriffsschlüssel, der von dem*der Nutzer*in bzw. der Seite angefordert wurde, der/die den Beitrag bzw. Kommentar veröffentlicht hat.

Das folgende Beispiel zeigt die Interaktion für die URL https://www.facebook.com, die von dem*der durch den Zugriffsschlüssel repräsentierten Nutzer*in geteilt wurde.

Für bessere Lesbarkeit formatiert.
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

Im Erfolgsfall erhält die App die folgenden Interaktionszahlen für die geteilte URL:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

Erstellen

Diesen Vorgang kannst du nicht an diesem Endpunkt ausführen.

Aktualisieren

Aktualisiere eine URL.

Anforderungen

TypBeschreibung
Zugriffsschlüssel

Für diese Anfrage kann jeder Zugriffsschlüssel verwendet werden.

Features

Nicht zutreffend.

Seitenaufgaben

Nicht zutreffend.

Berechtigungen

Nicht zutreffend.

Beispiele

Sende zur Aktualisierung von Informationen über eine in einem Beitrag oder Kommentar veröffentlichte URL eine POST-Anforderung an https://graph.facebook.com, wobei der Parameter id auf die URL und der Parameter scrape auf true festgelegt ist; darüber hinaus alle fields über die URL und einen Zugriffsschlüssel, der von dem*der Nutzer*in bzw. der Seite angefordert wurde, der/die den Beitrag bzw. Kommentar veröffentlicht hat.

Im folgenden Beispiel wird die URL https://www.facebook.com/my-update aktualisiert, die von dem*der durch den Zugriffsschlüssel repräsentierten Nutzer*in geteilt wurde.

Für bessere Lesbarkeit formatiert.
curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

Im Erfolgsfall erhält die App die folgenden Interaktionszahlen für die geteilte URL:

{
  "success": true
}

Abfrage-String-Parameter

Schließe die folgenden Abfrage-String-Parameter ein, um die Anfrage zu erweitern.

ParameterBeschreibung

access_token

Erforderlich

String

Ein Zugriffsschlüssel.

fields

String

Eine durch Komma getrennte Liste der Felder, die du anfordern möchtest.

id

Erforderlich

String

Die zu aktualisierende URL. Die URL muss kodiert werden, damit keine Konflikte mit dem scrape-Parameter entstehen.

scrape

Erforderlich

boolesch

Wert muss true lauten.

Beispielanfrage

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

Beispielantwort

{
  "success": true
}

Löschen

Diesen Vorgang kannst du nicht an diesem Endpunkt ausführen.