Partage pour les appareils
Ce point de terminaison a été abandonné le 2 novembre 2020.
La fonctionnalité Partage pour les appareils permet aux utilisateurs et utilisatrices de partager facilement du contenu sur Facebook depuis leurs appareils. Ces appareils comprennent les smart TV, les cadres photo numériques ou tout autre appareil connecté (Internet des objets).
Lors de ce processus de partage, votre appareil affiche un code alphanumérique que les utilisateurs et utilisatrices doivent ensuite saisir sur une page web depuis leur ordinateur de bureau ou leur smartphone. Les utilisateurs et utilisatrices de votre application ou de votre service peuvent alors partager du contenu sur Facebook à l’aide de la boîte de dialogue Partager associée au code.
Si vous créez une application pour des appareils Apple TV ou Android, vous devez utiliser le SDK pour tvOS ou le SDK pour Android, respectivement.
Ce guide aborde les points suivants :
Expérience d’utilisation
1. Call-to-action
Tout d’abord, déterminez à quel moment vous souhaitez proposer aux utilisateurs et utilisatrices de partager du contenu sur Facebook. Pour garantir une expérience optimale, créez un bouton ressemblant autant que possible au bouton Partager officiel de Facebook. En règle générale, le bouton doit se trouver à côté du contenu à partager.
En ce qui concerne le visuel, nos recommandations sont les suivantes :
- Appliquez le texte Partager ou Partager sur Facebook au bouton.
- Utilisez du blanc et le bleu officiel de Facebook : #3B5998.
- Intégrez le logo officiel « f » si votre appareil prend en charge l’affichage graphique. Conformément aux directives sur la marque Facebook, le logo doit toujours être blanc ou de la couleur bleue officielle de Facebook (#3B5998).
2. Afficher le code
Lorsqu’un utilisateur ou une utilisatrice clique sur le call-to-action, votre appareil passe un appel vers l’API de Facebook et celle-ci renvoie un code.
Ensuite, dans votre interface, indiquez à l’utilisateur ou l’utilisatrice, à l’aide du message suivant, qu’il/elle doit se rendre sur un site web et saisir un code : À présent, rendez-vous sur facebook.com/device (http://facebook.com/device) sur votre ordinateur ou votre smartphone pour saisir le code ci-dessous. Affichez le code complet que l’API Device Share de Facebook vous a envoyé. Le code doit contenir entre 6 et 12 caractères.
Intégrez un bouton Close ou Done afin que les utilisateurs et utilisatrices puissent finaliser le processus de partage avec des appareils.
3. Partage
C’est le processus qui s’affiche lorsque l’utilisateur ou l’utilisatrice saisit facebook.com/device dans son navigateur de bureau ou mobile. Il/elle voit d’abord apparaître un champ de texte dans lequel il/elle doit saisir son code :
Une fois que l’utilisateur ou l’utilisatrice a saisi le code et cliqué sur Continue, la boîte de dialogue Partager s’affiche :
Un message de confirmation indique ensuite à l’utilisateur ou l’utilisatrice que le partage a abouti :
Implémenter Partage pour les appareils
La fonctionnalité Partage pour les appareils de Facebook est destinée aux appareils qui passent des appels HTTP sur Internet. Vous trouverez ci-dessous les appels et réponses d’API que votre appareil peut envoyer/recevoir.
1. Activer Facebook Login pour appareils
Chargez votre Espace App, puis, dans Paramètres > Avancé > Paramètres OAuth > Connexion à partir des appareils, sélectionnez Oui.
2. Générer un code
Lorsque l’utilisateur ou l’utilisatrice clique sur le call-to-action Share, votre appareil doit envoyer une demande HTTP POST vers :
POST https://graph.facebook.com/device/share
access_token=<APPID|CLIENT_TOKEN>
href=<LINK_TO_SHARE>Vous trouverez le CLIENT_TOKEN sous Paramètres de l’application > Avancé. Vous devrez l’associer à l’ID de votre application (en les séparant par une barre verticale |) pour former le access_token complet.
L’API prend également en charge action_type et action_properties au lieu de href si vous souhaitez partager une actualité Open Graph (de la même manière que les actions Open Graph dans la boîte de dialogue Partager).
L’API prend également en charge les paramètres quote et hashtag (de la même manière que les paramètres de la boîte de dialogue Partager).
La réponse se présente sous la forme suivante :
{
"user_code": "A1NWZ9",
"verification_uri": "https://www.facebook.com/device",
"expires_in": 420,
}Elle signifie :
- Affichez la chaîne A1NWZ9 sur votre appareil.
- Dites à l’utilisateur ou l’utilisatrice d’accéder à « facebook.com/device » et de saisir ce code.
- Le code expire dans 420 secondes. Passé ce délai, vous devrez fermer la fenêtre d’affichage du code.
3. Afficher le code
Votre appareil doit afficher le user_code et inviter l’utilisateur ou l’utilisatrice à accéder à l’URI verification_uri, telle que facebook.com/device, depuis son ordinateur ou son smartphone. Consultez la section Expérience d’utilisation.
Résolution des problèmes
Puis-je envoyer des demandes de processus depuis un appareil via le protocole HTTP ?
L’API Graph avec des tokens requiert TLS/HTTPS.
Puis-je envoyer des demandes de processus depuis un appareil avec la méthode GET ?
Toutes les demandes de processus depuis un appareil doivent être des demandes POST.
Puis-je savoir quand un partage est terminé ?
Non.
Puis-je publier des contenus au nom d’une personne de manière automatisée ?
Non. Pour cela, vous devez demander à cet utilisateur/cette utilisatrice de se connecter et de vous autoriser à publier des contenus en son nom. Pour en savoir plus, consultez la page concernant la publication de contenus à l’aide de l’API Graph.