Contenido compartido para dispositivos
Este punto de conexión quedó obsoleto el 2 de noviembre de 2020.
Mediante "Contenido compartido para dispositivos", las personas pueden compartir fácilmente contenido de sus dispositivo en Facebook. Esto incluye Smart TV, marcos de fotos digitales o dispositivos de Internet de las cosas.
Con el contenido compartido para dispositivos, verás en tu dispositivo un código alfanumérico e indicaciones para que las personas ingresen a una página web desde su computadora o smartphone. De esta manera, las personas que utilizan tu app o servicio pueden compartir contenido en Facebook mediante un cuadro de diálogo de contenido compartido que está asociado al código.
Si creas una app para Apple TV o los dispositivos Android, te recomendamos utilizar nuestro SDK para tvOS o SDK para Android, según corresponda.
En esta guía se describe lo siguiente:
Experiencia del usuario
1. Llamada a la acción
Primero, piensa en qué fase de la experiencia del usuario deseas solicitar a las personas que compartan contenido en Facebook. Para asegurarte de brindar la mejor experiencia, diseña un botón lo más parecido posible al botón oficial "Compartir" de Facebook. El botón suele estar junto al contenido que se va a compartir.
Desde la perspectiva del diseño visual, esto significa que deberías:
- Etiquetar el botón como "Compartir" o "Compartir en Facebook".
- Utilizar el blanco y el azul oficial de la marca de Facebook: #3B5998.
- Si el dispositivo permite la visualización gráfica, también puedes incorporar el logotipo "f" oficial. Según las normas de marca de Facebook, el logotipo siempre deber ser de color blanco o azul de Facebook (#3B5998).
2. Presentar el código
Cuando alguien hace clic en la llamada a la acción, el dispositivo realiza una llamada a la API de Facebook que devuelve un código.
En tu interfaz, usa el siguiente mensaje para indicarles a las personas que necesitan visitar un sitio web e ingresar el código: "A continuación, ingresa a facebook.com/device (http://facebook.com/device) desde tu computadora o smartphone e ingresa este código". Ingresa el código completo que recibiste de la API de compartir para dispositivos de Facebook. El código tiene entre 6 y 12 caracteres de longitud.
Puedes incluir un botón Close o Done para que las personas puedan finalizar el proceso de compartir para dispositivos.
3. Contenido compartido
Este es el proceso que las personas ven cuando visitan facebook.com/device con el navegador de su computadora o smartphone. Primero aparece un campo de texto donde pueden ingresar el código:
Luego de ingresar el código y hacer clic en Continue, aparecerá un cuadro de diálogo de contenido compartido:
De este modo, las personas sabrán que la acción de compartir se realizó correctamente y verán un mensaje de confirmación:
Implementación del contenido compartido para dispositivos
El contenido compartido para dispositivos está diseñado para dispositivos desde los que se pueden realizar llamadas HTTP a través de Internet. A continuación encontrarás una lista con las llamadas a la API y las respuestas que el dispositivo puede realizar.
1. Activar el inicio de sesión para dispositivos
Carga el panel de apps. Dirígete a "Configuración > Avanzados > Configuración OAuth > Iniciar sesión desde dispositivos" y cambia esta última opción a "Sí".
2. Generar un código
Cuando la persona hace clic en la llamada a la acción Share, el dispositivo debe realizar una acción HTTP POST en:
POST https://graph.facebook.com/device/share
access_token=<APPID|CLIENT_TOKEN>
href=<LINK_TO_SHARE>El parámetro CLIENT_TOKEN se encuentra en "Configuración > Avanzada" y se debe combinar con el identificador de la app (separado por una barra vertical, |) para formar el access_token completo.
Además, la API admite action_type y action_properties en lugar de href si deseas compartir una historia de Open Graph (de la misma manera que ocurre con las acciones de Open Graph en cuadro de diálogo de contenido compartido).
La API también admite parámetros quote y hashtag (de la misma manera que ocurre con los parámetros del cuadro de diálogo de contenido compartido).
La respuesta tiene esta forma:
{
"user_code": "A1NWZ9",
"verification_uri": "https://www.facebook.com/device",
"expires_in": 420,
}Esta respuesta significa:
- Muestra la cadena "A1NWZ9" en tu dispositivo.
- Indica a la persona que vaya a "facebook.com/device" e ingrese el código.
- El código caduca en 420 segundos. Luego de ese período, deberías cerrar la visualización del código.
3. Presentar el código
El dispositivo debe mostrar el user_code e indicar a la persona que debe visitar la verification_uri, por ejemplo, facebook.com/device, con su computadora o smartphone. Consulta Experiencia del usuario.
Solución de problemas
¿Puedo hacer solicitudes de proceso de dispositivo a través de HTTP?
La API Graph con tokens requiere TLS/HTTPS.
¿Puedo realizar solicitudes de proceso de dispositivo con el método GET?
Todas las solicitudes de proceso de dispositivo deben ser POST.
¿Hay alguna forma de saber si la persona completó el proceso de compartir?
No.
¿Puedo publicar en nombre de la persona de forma programática?
No. Para poder hacerlo, debes solicitarle al usuario que inicie sesión y te otorgue los permisos para publicar en su nombre. Para obtener más información, consulte publicaciones con API Graph.