Sharing for devices

Avec Sharing for devices, les gens peuvent facilement partager du contenu depuis leurs appareils sur Facebook. Ces appareils comprennent les smart TV, les cadres photo numériques ou tout autre appareil connecté (Internet des objets).

Grâce à ce processus de partage, les gens voient s’afficher un code alphanumérique sur votre appareil, qu’ils doivent ensuite saisir sur une page web, depuis leur ordinateur de bureau ou leur smartphone. Les personnes qui utilisent votre app ou service peuvent ensuite partager du contenu sur Facebook avec une boîte de dialogue Partager associée à ce code.

Si vous développez une app pour Apple TV ou pour des appareils Android, vous devriez utiliser respectivement notre SDK pour tvOS ou notre SDK pour Android.

Ce guide aborde les points suivants :

Expérience utilisateur

1. Appel à l’action

Tout d’abord, déterminez à quel moment vous souhaitez proposer aux utilisateurs de partager du contenu sur Facebook. Pour garantir la meilleure expérience utilisateur, créez un appel à l’action ressemblant autant que possible au bouton Partager officiel de Facebook. En général, il vaut mieux placer ce bouton à côté du contenu à partager.

En ce qui concerne le visuel, nos recommandations sont les suivantes :

  1. Nommez ce bouton « Partager » ou « Partager sur Facebook ».
  2. Utilisez du blanc et le bleu officiel de Facebook : #3B5998.
  3. 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 clique sur l’appel à l’action, votre appareil passe un appel vers l’API de Facebook et celle-ci renvoie un code.

Ensuite, dans votre interface, indiquez à l’utilisateur qu’il doit se rendre sur un site web et saisir un code à l’aide du message suivant : « À 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 puissent terminer le processus de partage depuis un appareil.

3. Partage

L’utilisateur qui saisit facebook.com/device dans son navigateur de bureau ou mobile accède à ce processus. Il verra d’abord apparaître un champ de texte dans lequel il doit saisir son code :

Une fois qu’il a saisi son code et cliqué sur Continue, une boîte de dialogue Partager apparaît :

Un message de confirmation indique ensuite à l’utilisateur que le partage a été correctement effectué :

Implémenter Sharing for Devices

La fonctionnalité Facebook Sharing for Devices est destinée aux appareils qui peuvent passer 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 depuis des appareils, choisissez « Oui ».

2. Générer un code

Lorsque l’utilisateur clique sur l’appel à l’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>

Le CLIENT_TOKEN (token client) se trouve dans vos Paramètres de l’application > Avancé, et doit être associé à l’ID de votre app (séparée par une tige |) pour former le access_token (token d’accès) 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 :

  1. Affichez la chaîne « A1NWZ9 » sur votre appareil.
  2. Dites à l’utilisateur d’accéder à « facebook.com/device » et de saisir ce code.
  3. Le code expire dans 420 secondes. Fermez l’affichage du code une fois ce moment passé.

3. Afficher le code

Votre appareil doit afficher le user_code et inviter l’utilisateur à se rendre sur le verification_uri, comme facebook.com/device, depuis son ordinateur ou son smartphone. Consultez la rubrique Expérience utilisateur.

Dépannage

Puis-je envoyer des demandes de processus depuis un appareil sur le protocole HTTP ?
L’API Graph avec des tokens nécessite 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 une personne a terminé un partage ?
Non.

Puis-je publier au nom de la personne par programmation ?
Non. Pour cela, vous devez demander à l’utilisateur de se connecter et de vous autoriser à publier en son nom. Consultez la rubrique publier avec l’API Graph pour en savoir plus.