Comunidad

Ruta /community

Ruta alternativa /company

Representa tu comunidad de Workplace. El nodo /community (o /company, que se puede usar indistintamente) devuelve un objeto de comunidad único de tipo grupo. Para mayor comodidad con la API, puedes pensar en el objeto de comunidad raíz como un grupo raíz de los demás grupos o comunidades.

Para encontrar el identificador de tu comunidad, realiza una llamada GET a la API Graph a graph.facebook.com/community con un identificador de acceso de integración personalizado.

En algunos casos, una comunidad raíz también puede contener otras comunidades, que aparecerán en el perímetro /groups de la comunidad raíz. Las comunidades secundarias de una comunidad raíz se pueden diferenciar de los grupos secundarios por el campo is_community .

La existencia de una o varias comunidades en una comunidad raíz determina que dicha instancia de Workplace está activada para las comunidades.

Estas comunidades secundarias pueden consultarse a su vez en su perímetro /groups para obtener los grupos de esa comunidad. En todos los casos, el perímetro /groups solo mostrará los descendientes directos de esa comunidad; no se llevará a cabo la recursividad.

Las comunidades no se pueden crear mediante la API, pero los miembros se pueden administrar del mismo modo que los miembros de un grupo.

Lectura

GET graph.facebook.com
  /community

Permisos

El nodo de comunidad requiere uno de estos permisos: Leer contenido del grupo o Administrar grupos.

Publicación

No se puede publicar una comunidad de Workplace con este nodo.

Eliminación

No se puede eliminar una comunidad de Workplace con este nodo.

Actualización

No se puede actualizar una comunidad de Workplace con este nodo.

Perímetros

Ejemplos

Crear un nuevo grupo

A fin de crear un nuevo grupo para una comunidad de Workplace, puedes realizar una solicitud POST al perímetro /community/groups . La respuesta incluirá el identificador del grupo recién creado. Ten en cuenta que, para que el grupo muestre los miembros, debes añadir al menos un miembro y convertirlo en administrador.

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Obtener una lista de todos los grupos y comunidades de una comunidad raíz

GET graph.facebook.com
  /community/groups?fields=is_community

Obtener una lista de todos los miembros de una comunidad raíz

GET graph.facebook.com
  /community/members

Obtener una lista de todos los miembros de una comunidad raíz, mediante una filtración por el parámetro external_id

GET /community/members?
  external_ids=12356,abc123

Denunciar un elemento de contenido (ten en cuenta que este perímetro se retiró el 30 de abril de 2019)

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Añadir un nuevo grupo a una comunidad raíz

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Añadir un nuevo grupo a una comunidad diferente a la raíz

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Crear una cuenta:

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Enumerar las insignias disponibles:

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

Enumerar las categorías del nivel raíz

GET graph.facebook.com
  /community/knowledge_library_categories

Publicar una nueva categoría del nivel raíz

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

Enumerar los enlaces de las herramientas y otros recursos de uso frecuente en la Biblioteca de conocimiento

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Leer un enlace rápido concreto en la Biblioteca de conocimiento

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Agregar un nuevo enlace rápido en la Biblioteca de conocimiento

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Actualizar un enlace rápido concreto en la Biblioteca de conocimiento

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Eliminar un enlace rápido concreto de la Biblioteca de conocimiento

DELETE graph.facebook.com
        /{quick_link_id}