Comunidad

Ruta /community

Ruta alternativa /company

Representa la comunidad de tu Workplace. El nodo /community (o /company, que funciona de manera similar) devuelve un único objeto comunitario del tipo Grupo. Por conveniencia de la API, puedes considerar el objeto comunitario raíz como un grupo raíz para otros grupos o comunidades.

Puedes encontrar tu identificador de comunidad haciendo una llamada GET a la API Graph en graph.facebook.com/community con un token de acceso de integración personalizada.

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

La existencia de una o más comunidades dentro de una comunidad raíz determina que esta instancia de Workplace está habilitada para la comunidad.

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á las rutas directas que procedan de esa comunidad; no se realizará la recursión.

Las comunidades no se pueden crear a través de la API, pero los miembros se pueden administrar de la misma manera que los miembros del grupo.

Lectura

GET graph.facebook.com
  /community

Permisos

El nodo de la comunidad requiere el permiso Lectura del contenido del grupo o Administración de grupos.

Publicación

No se puedes usar este nodo para publicar una comunidad de Workplace.

Eliminación

No se puede usar este nodo para eliminar una comunidad de Workplace.

Actualización

No se puede usar este nodo para actualizar una comunidad de Workplace.

Perímetros

Ejemplos

Creación de un grupo nuevo

Puedes crear un nuevo grupo para una comunidad de Workplace enviando una solicitud POST al perímetro /community/groups. La respuesta contendrá el identificador del grupo recién creado. Ten en cuenta que para que tu grupo muestre los miembros, debes agregar al menos un miembro y hacerlo 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, filtrando por external_id:

GET /community/members?
  external_ids=12356,abc123

Reportar un elemento de contenido (Ten en cuenta que este perímetro quedó obsoleto el 30 de abril de 2019):

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

Agregar un nuevo grupo a una comunidad raíz:

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

Agregar un nuevo grupo a una comunidad no raíz:

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

Aprovisionar una cuenta:

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

Lista de 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 de 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 dentro de la biblioteca de recursos:

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

Leer un enlace rápido específico en la biblioteca de recursos:

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

Agregar un nuevo enlace rápido en la biblioteca de recursos:

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

Actualizar un enlace rápido específico en la biblioteca de recursos:

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

Eliminar un enlace rápido específico en la biblioteca de recursos:

DELETE graph.facebook.com
        /{quick_link_id}