Grupo

Caminho /{group-id}

Representa um grupo do Workplace. O nó /{group-id} retorna um único grupo.

Grupos multiempresariais

Há algumas considerações que devem ser levadas em conta ao acessar grupos multiempresariais:

• O conteúdo do grupo pode ser lido por qualquer app de integração instalado em uma empresa que faz parte de um grupo multiempresarial.
• Os grupos multiempresariais são listados em comunidades ou grupos, com os grupos comuns.

  • O campo purpose pode ser usado para identificar os grupos multiempresariais. Esse valor deve ser configurado como WORK_MULTI_COMPANY.
• Os membros do grupo podem ser consultados, mas apenas os campos id, name e picture serão visíveis quando o app for de uma empresa diferente da empresa do usuário.
• As integrações com a permissão Gerenciar grupo podem adicionar ou remover membros de grupos multiempresariais.

  • Uma integração só pode adicionar ou remover usuários que são membros da comunidade em que a integração foi instalada.
  • Uma integração só pode adicionar ou remover usuários quando um dos administradores do grupo é membro da comunidade em que a integração foi instalada.
• Uma integração com a permissão Gerenciar o conteúdo do grupo pode excluir o conteúdo de um grupo multiempresarial nos seguintes casos:

  • O conteúdo pertença a um membro da comunidade do app
  • Um membro da comunidade do app seja um administrador do grupo
• A publicação em grupos multiempresariais está indisponível no momento.
• Os grupos multiempresariais podem ser selecionados nas configurações de escopo do grupo para integrações.
• Os bots não podem ser mencionados nos grupos multiempresariais.

Leitura

É possível ler informações sobre um grupo fazendo uma solicitação GET da Graph API à /{group-id}.

Permissões

A leitura do nó Grupo requer a permissão Ler o conteúdo do grupo.

Campos

Publicação

Não é possível fazer uma publicação com esta borda. Para criar um grupo, publique na borda /community/groups.

Exclusão

Não é possível excluir um grupo com esse nó. O grupo será excluído automaticamente se o último membro for removido.

Atualização

É possível atualizar um grupo fazendo uma solicitação POST da Graph API para /{group-id} e passando os valores dos campos a serem atualizados no corpo da solicitação.

Permissões

Para atualizar um nó de grupo, é necessário ter a permissão Gerenciar grupos.

Bordas

Exemplos

Obter ID do grupo, nome, status do arquivo e privacidade:

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

Arquivar um grupo:

POST graph.facebook.com
  /{group-id}?archive=true

Obter membros do grupo com nome, ID e data de entrada:

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

Obter os moderadores e administradores de um grupo em uma única chamada:

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

Obter documentos do grupo:

GET graph.facebook.com
  /{group-id}/docs

Obter publicações do grupo:

GET graph.facebook.com
  /{group-id}/feed

Obter publicações do grupo começando pelas últimas atualizadas:

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

Parâmetros

sorting_setting

Quando definido como RECENT_ACTIVITY, permite ordenar as publicações de acordo com a última atualização, em vez da criação. O comportamento-padrão pode ser configurado explicitamente usando CHRONOLOGICAL como valor. As atualizações podem incluir edições à publicação, bem como comentários ou reações adicionados.

Obter publicações do grupo incluindo anexos adicionais, como vídeos, imagens, arquivos ou enquetes:

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

Obter uma lista de membros do grupo e as respectivas datas de entrada:

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

Adicionar um membro a um grupo por ID:

POST graph.facebook.com
  /{group-id}/members/{member-id}

Adicionar um membro a um grupo por email:

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Remover um membro de um grupo por ID:

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

Remover um membro de um grupo por email:

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Promover um membro a administrador do grupo:

POST graph.facebook.com
  /{group-id}/admins/{user-id}

Rebaixar um administrador a membro do grupo:

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

Criar um novo evento em um grupo:

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

Carregar uma nova foto (via binário) em um grupo:

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

Carregar uma nova foto (via URL) em um grupo:

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

Criar publicações de grupo com anexos de vídeo e imagem:

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

Parâmetros

attached_media

Usado para fotos e vídeo, uma matriz de media_fbids entre chaves. Estes são os formatos de imagem compatíveis: .jpeg, .bmp, .png, .gif, .tiff. Para mais informações sobre formatos de imagem, acesse aqui. Para ver os arquivos de vídeo compatíveis, acesse aqui. Para obter media_fbids para as imagens, publique fotos não publicadas primeiro em https://graph.facebook.com/me/photos, conforme descrito na documentação aqui. Para obter media_fbids para vídeos (incluindo GIFs animados), publique vídeos primeiro em https://graph.facebook.com/me/videos?no_story=true.

Criar publicações de grupo com arquivos de anexo:

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

Parâmetros

files

Usado para arquivos, uma matriz de file_ids (sem chaves). No momento, as versões de arquivo não são compatíveis. Para atualizar arquivos, remova o original dos anexos da publicação e carregue um novo arquivo de anexo. Estes são os formatos de arquivo compatíveis:

• Documentos: .pdf, .csv, .tsv, .docx, .pptx, .xlsx
• Imagens: .jpeg, .png
• Vídeos: .mp4
• Arquivos: .rar, .zip

Para obter file_ids, publique arquivos primeiro em https://graph.facebook.com/group_file_revisions. É possível publicar arquivos que estejam em seu computador.

Atualizar as configurações de aprovação de publicação, as configurações de finalidade e de participação, bem como as permissões de publicação

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

Obter reações e comentários de publicações fixadas

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

Identificar se um grupo também é uma comunidade

GET graph.facebook.com
  /{group-id}?fields=is_community

Obter as regras dos membros de um grupo

GET graph.facebook.com
  /{group-id}/auto_membership_rules

Exemplo de Resposta (JSON):

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

Excluir uma regra de participação automática de um grupo

DELETE graph.facebook.com
  /RULE_ID

Aplicar uma regra de participação a um grupo

POST graph.facebook.com
  /{group-id}/auto_membership_rules

Exemplo de carga:

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

Obter o ID do grupo e o status do grupo oficial:

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

Atualizar o status do grupo oficial:

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}