Workplace

Publicación

Ruta /{POST-id}

Representa una publicación de Workplace. El nodo /{post-id} devuelve una única publicación.

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. Se requiere el permiso Leer biografía de usuarios para leer una publicación en el perfil de un usuario.

Campos

Nombre del campoDescripciónTipo

id

Identificador de la publicación en formato {group-id}_{id}.

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 publicación.

url

link

Enlace adjunto a la publicación.

url

message

Mensaje de estado de la publicación.

string

name

Nombre del campo link, si se ha adjuntado 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

Foto extraída de cualquier campo 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 adjunto Pregunta, de modo que se pueden consultar los valores de options y de votes de las opciones que eligen 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

Publicación

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

Eliminación

Una publicación se puede eliminar mediante una solicitud DELETE en la ruta /{post_id} a través de la API Graph.

Permisos

Para eliminar un nodo de publicación se requiere el permiso Publicar en grupos y uno de los dos siguientes: Leer todo el contenido o Leer solo el contenido abierto (en función del grupo en que se realice la publicación).

Para eliminar una publicación de la biografía de un usuario, se requiere el permiso Administrar biografía de usuarios.

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 objeto message actualizado en el cuerpo.

Perímetros

Nombre del perímetroDescripción

/attachments

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

/comments

Comentarios de la publicación. Admite un campo summary para obtener un recuento total.

/reactions

Las personas que reaccionaron a esta publicación. Admite un campo summary para obtener un recuento total. Admite los campos since=unix_timstamp y until=unix_timestamp para obtener el número de reacciones en un intervalo de tiempo.

/seen

Las personas que vieron esta publicación. Admite un campo summary para obtener un recuento total. Admite los campos since=unix_timstamp y until=unix_timestamp para obtener el número de personas que han visto la publicación en un intervalo de tiempo.


Ten en cuenta que este perímetro está sujeto a las mismas limitaciones que se describen aquí.

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)

Inline code

`Inline code`
code block
``` code block ```
  • Lista
* List
  1. Lista numerada
1. Numbered list

Cita

> Quote

Encabezado 1

# Heading 1

Encabezado 2

## Heading 2

Ejemplos

Obtener los valores de 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
  /{group-id}_{post-id}/seen?
  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}}

Eliminar una publicación

DELETE graph.facebook.com
  /{post-id}

Reacciones o personas que han visto una publicación en un período de tiempo

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600