API Graph
Version API du graphe

URL /?id={url}

Représente une URL partagée dans une publication ou dans un commentaire de publication.

Pour plus d’informations, reportez-vous à la documentation relative à l’API News Tab Indexing.

Lecture

Permet d’obtenir des informations sur une URL partagée dans une publication ou dans un commentaire de publication.

Conditions requises

TypeDescription
Tokens d’accès

Tous les tokens d’accès peuvent servir à effectuer cette demande.

Fonctionnalités

Non applicable.

Tâches de Page

Non applicable.

Autorisations

Non applicable.

Limites

  • Les valeurs d’interaction retournées ne sont pas précises, mais reflètent l’interaction des utilisateurs et utilisatrices avec une URL.
  • Vous êtes limité·e à dix demandes GET par URL, par application et par heure.

Paramètres

Insérez les paramètres de chaîne de requête ci-dessous pour compléter la demande.

ParamètreDescription

access_token

Obligatoire

chaîne

Token d’accès.

fields

chaîne

Liste de champs séparés par une virgule que vous souhaitez demander.

id

chaîne

URL à partager.

scopes

chaîne

Liste de champs d’application séparés par une virgule.

Champs

Nom de propriété Description Type
app_links

Données AppLinks associées à cette URL, si elles sont disponibles.

AppLinks

id

URL proprement dite.

string

engagement

Décompte des différentes manières d’interagir avec l’URL. Notez que les valeurs d’interaction sont volontairement imprécises, mais reflètent fidèlement l’interaction entre les utilisateur·trices et une URL.

object

comment_count

Nombre de commentaires dans l’URL.

int

comment_plugin_count

Nombre de commentaires sur le plugin réunis à l’aide du plugin Commentaires sur votre site.

int

reaction_count

Nombre de réactions à l’URL.

int

share_count

Nombre de fois que l’URL a été partagée.

int

og_object

L’objet Open Graph est normalement associé à cette URL.

OGObject

id

ID de l’objet.

string

description

Description de l’objet, si elle est disponible.

string

title

Titre de l’objet, s’il est disponible.

string

type

Type d’objet.

og:type

updated_time

Date de dernière mise à jour de l’objet.

datetime

Exemples

Pour obtenir des informations sur une URL publiée dans une publication ou un commentaire, envoyez une demande GET à https://graph.facebook.com avec le paramètre id défini sur l’URL, tous les champs concernant l’URL et un token d’accès demandé à l’utilisateur·ice ou à la Page qui a publié la publication ou le commentaire.

L’exemple suivant montre l’interaction pour l’URL https://www.facebook.com qui a été partagée avec l’utilisateur·ice représenté·e par le token d’accès utilisateur.

Formaté pour plus de lisibilité.
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

Lorsque la demande aboutit, votre application reçoit le compte d’interactions pour l’URL qui a été partagée :

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

Création

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Mise à jour

Mettez une URL à jour.

Conditions requises

TypeDescription
Tokens d’accès

Tous les tokens d’accès peuvent servir à effectuer cette demande.

Fonctionnalités

Non applicable.

Tâches de Page

Non applicable.

Autorisations

Non applicable.

Exemples

Pour mettre à jour les informations concernant une URL publiée dans une publication ou un commentaire, envoyez une demande POST à https://graph.facebook.com avec le paramètre id défini sur l’URL, le paramètre scrape réglé sur true, tous les paramètres fields concernant l’URL et un token d’accès demandé à l’utilisateur·ice ou à la Page qui a publié la publication ou le commentaire.

L’exemple suivant met à jour l’interaction pour l’URL https://www.facebook.com/my-update qui a été partagée avec l’utilisateur·ice représenté·e par le token d’accès utilisateur.

Formaté pour plus de lisibilité.
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}"

Lorsque la demande aboutit, votre application reçoit le compte d’interactions pour l’URL qui a été partagée :

{
  "success": true
}

Paramètres de chaîne de requête

Insérez les paramètres de chaîne de requête ci-dessous pour compléter la demande.

ParamètreDescription

access_token

Obligatoire

chaîne

Token d’accès.

fields

chaîne

Liste de champs séparés par une virgule que vous souhaitez demander.

id

Obligatoire

chaîne

URL à mettre à jour. L’URL doit être encodée de sorte qu’elle ne perturbe pas le paramètre scrape.

scrape

Obligatoire

booléen

La valeur doit être true.

Exemple de demande

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

Exemple de réponse

{
  "success": true
}

Suppression

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.