Partage

Utilisation des objets

Articles connexes

Grâce à Facebook, vous pouvez publier des actualités riches et structurées depuis votre app en utilisant des API (Application Program Interface, Interface de programmation) fortement typées composées d’objets et d’actions. Les objets constituent les « noms » ou cibles des actions entreprises par les personnes dans votre app.

Les objets sont définis par des tags HTML Open Graph sur les pages web.

Création d’objets

Les objets sont créés en ajoutant des tags méta Open Graph à la page qui contient le contenu hébergé.

Ce sont les tags de base requises pour transformer votre page en objet. Ajoutez-les dans les balises <head> du code HTML de votre Page.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

Sur certaines plateformes d’hébergement et de développement, lorsque vous créez une page d’objet et publiez l’objet vers Open Graph simultanément, vous pouvez recevoir une erreur signalant que l’objet n’existe pas. Cela est dû à une condition de concurrence présente sur certains systèmes. Nous vous recommandons de vérifier que la page d’objet a bien été créée avant de publier une action vers Open Graph ou d’introduire un léger décalage afin de prendre en compte le retard de réplication (par exemple 15 à 30 secondes).


Tests

Vous pouvez tester votre tag à l’aide du programme de débug du partage sur une URL. Vous verrez les tags que le robot d’indexation a récupérées, ainsi que les éventuelles erreurs ou les éventuels avertissements.

Mise à jour des objets

Le robot d’indexation de Facebook va de nouveau récupérer vos objets (et par conséquent les mettre à jour) :

  • lorsque l’URL de l’objet est entrée dans le Programme de débug du partage ;
  • tous les 30 jours après la première récupération ;
  • lorsqu’une app déclenche une récupération à l’aide d’un point de terminaison d’API.

Le point de terminaison de l’API Graph est simplement un appel vers :

POST /?id={object-instance-id or object-url}&scrape=true

La réponse renvoyée depuis ce point de terminaison prend la forme d’un objet JSON qui contient toutes les informations concernant l’objet qui a été récupéré (les données renvoyées sont les mêmes lorsque l’ID de l’objet est lu à partir de l’API Graph).

Le paramètre id peut être soit l’URL réglementaire de votre objet, soit l’ID de l’instance de l’objet dans le graphe.

Vous pouvez toujours modifier les propriétés d’un objet, à deux exceptions près :

  • Titre : une fois que 50 actions (mention J’aime, partages et commentaires) ont été associées à un objet, vous ne pouvez plus mettre à jour son titre.
  • Type : un type d’objet ne peut être modifié une fois utilisé dans une story. Pour plus d’informations, consultez l’article Types d’Open Graph.

Si vous souhaitez mettre à jour l’image d’un objet, nous vous suggérons fortement de choisir pour l’URL de l’image un nom différent de celui de l’URL d’origine de l’image. Les mises en cache peuvent empêcher la mise à jour de l’image.

Migrations de page et modification d’URL

Si vous déplacez une page vers une nouvelle URL, vous pouvez utiliser l’ancienne URL comme source réglementaire pour le nouveau lien, ce qui permet de conserver les mentions J’aime, les commentaires et les partages de l’objet. Découvrez comment faire dans notre guide de partage pour les administrateurs de sites.