Comunidade

Caminho /community

Caminho alternativo /company

Representa sua comunidade no Workplace. O nó /community (ou /company, que funciona como alternativa) retorna um único objeto de comunidade do tipo Grupo. Para conveniência da API, considere o objeto-raiz de comunidade como um grupo-raiz de outros grupos ou comunidades.

É possível encontrar o número de identificação da comunidade por meio de uma chamada GET da Graph API para graph.facebook.com/community com um token de acesso de integração personalizado.

Em alguns casos, uma comunidade-raiz também pode conter outras comunidades, que aparecerão na borda /groups. Por meio do campo is_community, é possível diferenciar entre comunidades subordinadas de uma comunidade-raiz e grupos subordinados.

A existência de uma ou mais comunidades em uma comunidade-raiz indica que a instância do Workplace está habilitada para comunidade.

As comunidades subordinadas podem ser consultadas na borda /groups para obter os grupos da comunidade em questão. Em todos os casos, a borda /groups mostrará somente descendentes diretos da comunidade, sem recursão.

As comunidades não podem ser criadas por meio da API. Entretanto, seus membros podem ser gerenciados da mesma forma que os membros de grupos.

Leitura

GET graph.facebook.com
  /community

Permissões

O nó da comunidade requer a permissão Ler conteúdo do grupo ou Gerenciar grupos.

Publicação

Não é possível publicar uma comunidade do Workplace usando esse nó.

Exclusão

Não é possível excluir uma comunidade do Workplace usando esse nó.

Atualização

Não é possível atualizar uma comunidade do Workplace usando esse nó.

Bordas

Exemplos

Como criar um novo grupo

É possível criar um novo grupo para uma comunidade do Workplace por meio de uma solicitação POST para a borda /community/groups. A resposta mostrará o número de identificação do grupo recém-criado. Para que o grupo apresente membros, é obrigatório adicionar e transformar pelo menos um membro em administrador.

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

Para obter uma lista de todos os grupos e comunidades de uma comunidade-raiz:

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

Para obter uma lista de todos os membros de uma comunidade-raiz:

GET graph.facebook.com
  /community/members

Para obter uma lista de todos os membros de uma comunidade-raiz, filtrando por external_id:

GET /community/members?
  external_ids=12356,abc123

Para denunciar um item de conteúdo (esta borda se tornou obsoleta em 30 de abril de 2019):

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

Para adicionar um novo grupo a uma comunidade-raiz:

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

Para adicionar um novo grupo a uma comunidade não raiz:

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

Para provisionar uma conta:

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

Para listar selos disponíveis:

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

Para listar as categorias de nível raiz:

GET graph.facebook.com
  /community/knowledge_library_categories

Para publicar uma nova categoria de nível raiz:

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

Para listar os links de ferramentas usadas com frequência e outros recursos na Biblioteca de Conhecimento:

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

Para ler um link rápido específico na Biblioteca de Conhecimento:

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

Para adicionar um novo link rápido na Biblioteca de Conhecimento:

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

Para atualizar um link rápido específico na Biblioteca de Conhecimento:

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

Para excluir um link rápido específico na Biblioteca de Conhecimento:

DELETE graph.facebook.com
        /{quick_link_id}