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

La lectura del nodo de publicación requiere el permiso Leer contenido del grupo. La lectura de una publicación en el perfil de un usuario requiere el permiso Leer biografía del usuario.

Campos

Nombre del campoDescripciónTipo

id

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

string

created_time

Hora en que se realizó la publicación inicialmente.

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 cualquier foto o vídeo subido y adjunto a la publicación.

string

permalink_url

URL a 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 cualquier vídeo adjunto; por ejemplo, la longitud del vídeo.

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 realizar la publicación mediante este perímetro. Para realizar una nueva publicación en un grupo, debes usar 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

La eliminación de un nodo de publicación 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).

La eliminación de una publicación de la biografía de un usuario requiere el permiso Administrar biografía del usuario.

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

/comments

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

/reactions

Personas que han reaccionado a la 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

Personas que han visto la 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 en este documento.

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 una 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