Présentation

L’API Pages est un ensemble de points de terminaison de l’API Facebook Graph que les applications peuvent utiliser pour créer et gérer les paramètres et le contenu d’une Page.

Composants

Tokens d’accès

L’authentification de l’API est gérée par des tokens d’accès. La plupart des points de terminaison nécessitent des tokens d'accès de Page, qui sont uniques à chaque Page, utilisateur ou utilisatrice d'application et application, et qui ont une date d’expiration. Si vous souhaitez obtenir un token par l’intermédiaire d’un utilisateur ou d’une utilisatrice d’application, ce dernier ou cette dernière doit détenir ou être capable de réaliser une tâche sur la Page.

Vous pouvez obtenir des tokens d’accès par l’intermédiaire de vos utilisateurs et utilisatrices d’application en implémentant Facebook Login.

Pour les Pages qui sont passées à la nouvelle expérience Page, un token d’accès de Page est désormais requis pour tous les points de terminaison disponibles, à l’exception de ceux qui suivent :

API Graph

Si vous ne maîtrisez pas l’API Graph, consultez notre documentation API Graph avant de poursuivre pour en savoir plus sur notre graphe social Meta.

Facebook Login

Facebook Login permet aux utilisateurs et utilisatrices de l’application de se connecter à votre application, et à votre application de demander aux utilisateurs et utilisatrices des autorisations d’accès aux données.

Facebook Login for Business

Facebook Login for Business est la solution d’authentification et d’autorisation recommandée pour les fournisseurs de technologies et les équipes de développement d’applications d’entreprise qui ont besoin d’accéder aux éléments de leur clientèle professionnelle.

Fonctionnalités

Certains points de terminaison nécessitent une fonctionnalité qui doit être approuvée via le processus de Contrôle app avant que votre application ne puisse les utiliser en mode en ligne. Les fonctionnalités vous permettent d’accéder aux données d’une Page publique sans autorisation ou de réaliser une tâche sur la Page. Reportez-vous à chacune des références de point de terminaison pour connaître la fonctionnalité de Page requise.

Mentions

@mentions permet à votre Page de répondre publiquement à une personne spécifique, qui a publié sur votre Page ou commenté la publication de votre Page, dans un commentaire ou une réponse.

ID utilisateur·ice spécifiques à une Page

Les utilisateurs et utilisatrices qui interagissent avec les Pages sont identifié·es par des ID utilisateur·ice spécifiques à une Page (PSID). Les PSID sont des identifiants propres à chaque paire Utilisateur·ice-Page. L’API Pages et les points de terminaison de la plateforme Messenger reposent sur les PSID. Vous pouvez donc utiliser un PSID pour identifier les interactions de l’utilisateur ou l’utilisatrice avec une Page, ainsi que les conversations Messenger publiques de l’utilisateur ou l’utilisatrice avec cette même Page.

Autorisations

La majorité des points de terminaison nécessitent une ou plusieurs autorisations qui doivent être accordées à votre application par ses utilisateurs et utilisatrices. Cette opération est généralement effectuée via Facebook Login, mais peut aussi l’être par le biais de Business Manager, si votre application a été revendiquée par une entreprise.

Toutes les autorisations nécessitent de passer le Contrôle app avant qu’un utilisateur ou une utilisatrice puisse les accorder à votre application lorsqu’elle est en mode en ligne. Concernant les applications d’entreprise qui sont dépourvues de mode d’application, les autorisations doivent être approuvées pour les accès avancés avant qu’un utilisateur ou une utilisatrice sans rôle dans l’application ou dans une entreprise ayant revendiqué l’application puisse les accorder à votre application.

Recherche de page

Trouvez des informations sur les Pages Facebook, y compris les noms, les lieux, ainsi que des Pages vers @Mention, des emplacements de Page et identifiez une Page afin d’afficher le contenu de marque.

Plafonds

Toutes les requêtes de points de terminaison de Pages font l’objet de plafonds. Pour connaître la consommation actuelle de votre application en matière de nombre d’appels, accédez à l’Espace App.

Tâches

Les tâches permettent aux utilisateurs et utilisatrices d’effectuer des actions spécifiques sur une Page. Lorsqu’un utilisateur ou une utilisatrice se sert d’une application pour interagir avec une Page, et en fonction de l’action prévue, nous vérifions d’abord s’il ou elle bénéficie d’une approbation pour une tâche autorisant ce type d’action.

Vous pouvez accorder une approbation pour les tâches suivantes :

Tâche	Actions autorisées
`ADVERTISE`	Créer des publicités Créer des publications de Page non publiées Créer des publicités lorsqu’un compte Instagram est connecté à la Page
`ANALYZE`	Consulter les statistiques de la Page Identifier l’admin de Page qui a créé une publication ou un commentaire
`CREATE_CONTENT`	Publier du contenu au nom de la Page sur la Page
`MANAGE`	Affecter et gérer les tâches de Page
`MANAGE_LEADS`	Voir et gérer les prospects
`MESSAGING`	Envoyer des messages au nom de la Page
`MODERATE`	Répondre à des commentaires sur les publications de Page au nom de la Page Supprimer des commentaires sur les publications de Page Lorsqu’un compte Instagram est connecté à la Page, publier du contenu sur Instagram depuis Facebook, répondre à des commentaires et en supprimer, envoyer des messages directs, synchroniser les coordonnées de l’entreprise et créer des publicités
`VIEW_MONETIZATION_INSIGHTS`	Voir les statistiques de monétisation

Si une personne reçoit un accès admin à une Page dans l’interface, cette personne est en mesure d’exécuter toutes les tâches sur cette Page.

Plateforme Messenger

Engagez des conversations Messenger avec votre clientèle ou avec les personnes intéressées par votre Page.

Webhooks Meta pour les Pages

Recevez des notifications en temps réel lorsqu’un utilisateur ou une utilisatrice commente une publication de Page ou réagit à la publication de votre Page.

Contrôle app

Toutes les autorisations et fonctionnalités liées aux Pages nécessitent une approbation via le processus de Contrôle app avant que votre application ne puisse les utiliser en mode en ligne.

Les applications en mode développement peuvent demander n’importe quelle autorisation de la part d’un utilisateur ou d’une utilisatrice d’application qui dispose d’un rôle sur l’application en question.

Fonctionnement

Voici le processus habituel pour accéder à l’API Pages :

Obtenez un token d’accès utilisateur·ice de la part de l’utilisateur ou de l’utilisatrice d’application via Facebook Login.
Interrogez le point de terminaison /me/accounts pour obtenir l’ID et le token d’accès de Page pour la Page dont l’utilisateur ou l’utilisatrice d’application a autorisé l’accès à votre application.
Enregistrez l’ID de Page et le token d’accès de Page renvoyés.
Utilisez l’ID et le token pour demander le nœud de Page.

Veuillez noter que, dans certains cas, l’utilisateur ou l’utilisatrice d’application peut autoriser l’application à accéder à plusieurs Pages, auquel cas vous devez enregistrer chaque ID de Page et le token correspondant, puis permettre à l’utilisateur ou l’utilisatrice d’application de cibler chacune de ces Pages.

Prochaines étapes

Consultez notre Guide de démarrage pour savoir comment effectuer une publication en utilisant l’API Pages.