Ir para o conteúdo

Configurando o Facebook

App Builder não suporta nativamente a Graph API do Facebook, nem como um provedor de autenticação ou de dados. No entanto, como a Graph API do Facebook pode ser consumida como uma REST API, protegida usando o fluxo de Credencial do Cliente OAuth, é possível usar App Builder provedor de segurança HTTP genérico do para recuperar dados do Facebook.

A documentação do Facebook para usar o fluxo de credenciais do cliente OAuth pode ser encontrada aqui:

https://developers.facebook.com/docs/facebook-login/access-tokens#apptokens

As principais tarefas envolvidas incluem:

  1. Registrar App Builder como um aplicativo do Facebook.
  2. Crie um provedor de segurança HTTP do Facebook
  3. Crie uma fonte de dados do Facebook.

Presume-se que sua organização já tenha uma conta existente no Facebook. Além disso, presume-se que a organização tenha se registrado como um desenvolvedor de aplicativos do Facebook.

Registrar App Builder como um Aplicativo do Facebook

Comece fazendo login no Painel do aplicativo do Facebook.

https://developers.facebook.com/apps/

  1. Clique no botão Adicionar um novo aplicativo.

  2. Forneça as seguintes informações:

    • Nome de exibição: Um nome lógico para o App Builder ambiente ou aplicação.

      Exemplo: App Builder

    • Email de contato: Seu endereço email.

    • Categoria: Negócios

  3. Clique no botão Criar ID do aplicativo.

  4. Selecione Painel no menu.
  5. Clique no botão Mostrar abaixo de Segredo do aplicativo.

  6. Anote as seguintes propriedades:

    • App ID: Este será o valor do ClientId ao configurar o provedor de segurança HTTP dentro App Builder.
    • App Secret: Este será o valor do ClientSecret ao configurar o provedor de segurança HTTP dentro App Builder.

Crie um Provedor de Segurança HTTP do Facebook

Para criar um provedor de segurança HTTP, comece fazendo login em App Builder como administrador.

  1. Navegue até o IDE
  2. Selecione o botão Provedores de segurança
  3. No painel Autenticação da fonte de dados, clique no botão + Autenticação da fonte de dados

  4. Forneça o seguinte:

    • Nome: Facebook
    • Tipo: HTTP
    • Habilitado: Verificar
    • Tipo de autenticação: Credenciais do cliente
    • Clique no botão Salvar

  5. Defina as seguintes propriedades. No painel Propriedades, clique no botão + Propriedade → Selecione o Parâmetro → Forneça o Valor → Clique no ícone Salvar.

    • Tipo de autenticação: Credenciais do cliente
    • TokenEndpoint: https://graph.facebook.com/v2.8/oauth/access_token
    • O endpoint do token deve conter o número da versão. A versão deve ser 2.0 ou superior. No momento da escrita, 2.8 é a versão atual da API do Facebook Graph.
    • ClientId: O {App ID} fornecido pelo Facebook
    • ClientSecret: O {App Secret} fornecido pelo Facebook

Crie uma Fonte de Dados do Facebook

Para criar uma fonte de dados do Facebook, comece fazendo login App Builder como administrador.

  1. Navegue até o IDE
  2. Clique no botão Servidores de dados
  3. Clique em + Servidor

  4. Forneça o seguinte:

    • Nome do servidor: Facebook
    • Tipo: API REST
    • Subtipo: REST
    • URL: https://graph.facebook.com/
    • Tipo de conteúdo da solicitação: JSON
    • Tipo de conteúdo de resposta: JSON

  5. Expanda Configurações de segurança, defina Provedor de segurança para o valor do Facebook configurado na etapa anterior

  6. Clique em Salvar
  7. Clique no ícone Tabelas em Configurações do servidor para configurar as informações dos Endpoints
  8. No painel Endpoints, clique no botão + Endpoint

  9. Forneça o seguinte:

    • Nome: Página
    • Endpoint: {{Página}}?fields=fan_count

  10. Clique no ícone marca de seleção

  11. No painel Parâmetros de Endpoint, clique no botão + Parâmetro

  12. Forneça o seguinte:

    • Nome: Página
    • Tipo de dados: String
    • Valor de teste: zudysoftware

  13. Clique no botão Salvar

  14. No painel Endpoints, clique no botão Descobrir e clique em Descobrir novamente

    Este processo de importação preencherá o painel Resultados SQL.

  15. No painel Resultados SQL, localize a tabela Página e clique no ícone Resultados.

Supondo que tudo tenha sido configurado corretamente, você deverá ver a contagem de seguidores da conta do zudysoftware no Facebook.

Solução de Problemas

Erro: "Caractere inesperado encontrado ao analisar o valor: a. Caminho '', linha 0, posição 0."

Isso indica que o corpo da resposta não foi serializado como JSON. Certifique-se de que o endpoint do token contenha um número de versão em que a versão seja maior que 2.0.