Referencia

Publicación

Ruta /{POST-id}

Muestra una publicación de Workplace. El nodo /{post-id} devuelve una publicación simple.

Lectura

Devuelve un único objeto Publicación que representa una publicación en un grupo, un evento o el perfil de un usuario.

Permisos

Se requiere el permiso Leer contenido del grupo para leer un nodo de publicación.

Campos

Nombre del campoDescripciónTipo

id

El identificador de la publicación.

string

created_time

El momento en que se hizo originalmente la publicación.

datetime

formatting

Indica si la publicación se creó mediante un lenguaje de marcado de formato. El valor devuelto indica el lenguaje de marcado utilizado. Workplace admite Markdown y texto sin formato.

enum {MARKDOWN|PLAINTEXT}

from

Información sobre la persona o el perfil que publicó el mensaje.

Profile

icon

Enlace a un icono que representa el tipo de esta publicación.

url

link

El enlace adjunto a la publicación.

url

message

El mensaje de estado de la publicación.

string

name

El nombre del link si se adjuntó a la publicación.

string

object_id

Identificador de la foto o el video subidos que se adjuntaron a la publicación.

string

permalink_url

URL de la página del enlace permanente de la publicación.

url

picture

La imagen extraída de algún link incluido en la publicación.

url

place

Información de cualquier ubicación adjunta a la publicación.

Place

poll

Si la publicación es una encuesta, este campo devolverá el objeto "Pregunta" adjunto, que te permite ver las opciones y los votos sobre las opciones de respuesta de los usuarios.

Question

properties

Lista de propiedades de un video adjunto, por ejemplo, la longitud del video.

object[]

status_type

Descripción del tipo de actualización de estado.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

Texto de las historias que no generan los usuarios de forma intencionada.

string

to

Perfiles mencionados o segmentados en esta publicación.

Profile[]

type

Cadena que indica el tipo de objeto de la publicación.

enum{link, status, photo, video}

updated_time

Hora en que se creó o editó por última vez la publicación, o bien, hora del último comentario que hayan dejado en ella.

datetime

with_tags

Perfiles etiquetados para indicar que están "con" la persona que hace esta publicación.

Objeto JSON con un campo data que contiene una lista de objetos Profile.

Publicación

No puedes publicar con este perímetro. Para realizar una nueva publicación en un grupo, usa el perímetro /group/feed .

Eliminación

Una publicación puede eliminarse mediante la API Graph haciendo una solicitud DELETE en la ruta /{post_id}.

Permisos

Para eliminar un nodo de publicación, se requiere el permiso Publicar en grupos y alguno de los dos siguientes: Leer todo el contenido o Leer solo el contenido abierto, según el grupo en el que se realice la publicación.

Actualización

Solo se pueden actualizar las publicaciones que haya creado un bot; las realizadas en nombre de un usuario mediante un objeto impersonate_token no pueden recibir actualizaciones. Se puede editar una publicación mediante una solicitud POST en el perímetro /{post-id} con un message actualizado incluido en el cuerpo.

Perímetros

Nombre del perímetroDescripción

/attachments

Todos los archivos multimedia adjuntos asociados con esta publicación.

/comments

Comentarios de esta publicación. Admite un campo resumen para obtener un recuento total.

/likes

Las personas que indican que les gusta esta publicación. Admite un campo resumen para obtener un recuento total.

/reactions

Las personas que reaccionaron a esta publicación. Admite un campo resumen para obtener un recuento total.

/seen

Las personas que vieron esta publicación. Admite un campo resumen para obtener un recuento total.

Sintaxis de Markdown admitida

Al realizar una publicación en Workplace, se admite la siguiente sintaxis de Markdown:

FormatoSintaxis

Negrita

**Bold**

Énfasis

*Emphasize*

Enlace

[Link](https://workplace.fb.com)

Código alineado

`Inline code`
Bloque de código
``` code block ```
  • Lista
* List
  1. Numbered list
1. Numbered list

Cita

> Quote

Encabezado 1

# Heading 1

Encabezado 2

## Heading 2

Ejemplos

Obtén el ID, source y story de una publicación

GET graph.facebook.com
  /{post-id}?fields=id,source,story

Obtener los comentarios de una publicación

GET graph.facebook.com
  /{post-id}/comments

Obtener el estado de visualización de una publicación, incluido un resumen del recuento total

GET graph.facebook.com
  /{post-id}/comments?
  summary=true

Realizar una publicación en un grupo

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

Etiquetar a un usuario en la publicación de un grupo

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

Realizar una publicación en un grupo con formato de Markdown

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

Leer los votos y las opciones de las preguntas de una encuesta de una publicación con encuesta mediante la expansión de campos

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}