Создание и настройка собственного приложения для авторизации в Facebook API

Подробно о приложениях, их регистрации и настройке можно узнать в официальной справке.

Для создания своего приложения необходимо выполнить следующие действия:

1. Перейти на страниц приложений.
2. Нажать кнопку “Добавьте новое приложение”.
3. В появившемся диалоговом окне ввести название приложения и ваш email, и нажать “Создать ID приложения”.
4. Далее в панели приложение добавьте продукт “Вход через Facebook”, нажав на нём кнопку “Настроить”
5. Выберите из предложенных платформ “Веб”.
6. В блоке “Укажите URL вашего сайта” введите https://selesnow.github.io, и нажмите “Save”, а затем “Продолжить” > “Далее” > “Далее” > “Далее”.
7. В меню вашего приложения в области “Продукты” вы увидите “Вход через Faceook”, перейдите в раздел настройки.

Настройки Вход через Facebook

8. В настройках найдите “Действительные URI перенаправления для OAuth” и введите следующий URL: https://selesnow.github.io/rfacebookstat/getToken/get_token.html
9. В нижней части экрана настройки “Вход через Facebook” нажмите “Сохранить изменения”.
10. В основном меню приложения перейдите в раздел “Панель”.
11. В окне “Панель” спуститесь в область “Добавьте продукты” и нажмите в продукте “API Marketing” кнопку “настроить”.
12. Теперь можете вернуться в основном меню приложения в раздел Настройки > Основное.
13. В разделе Настройки > Основное вы найдёте Идентификатор приложения и секрет приложения, далее вы будете использовать эти параметры для авторизации через собственное приложение.

Важно! Не выводите своё приложение из статуса “в разработке”, т.к. для этого требуется проверка приложения со стороны поддержки API Facebook, процесс проверки длительный и сложный. Но вы можете работать со своими рекламными кампаниями даже если ваше приложение имеет статус “в разработке”

Аргументы функции fbAuth()

• app_id - Идентификатор приложения
• app_secret - Секрет приложения
• username - Ваш логин на Facebook
• token_path - Путь к папке в которой вы хотите создать файл для хранения учётных данных
• reauth - Переавторизоваться под указанным в username пользователем, если вы уже ранее запрашивали для него учётные данные
• skip_option - Игнорировать опции и переменные окружения при авторизации (будет рассмотрено ниже)

Соответственно авторизоваться с помощью собственного приложения можно передав в аргументы app_id и app_secret идентификатор и секрет созданного вами приложения.

fbAuth(app_id      = 556970798471513, 
       app_secret  = "10fbc64e0c426feb4e774395c97237fa",
       username    = "seleznev_a",
       skip_option = TRUE, 
       reauth      = FALSE,
       token_path  = "D:/fb_auth_store")

 Facebook access token
 Access token:  <hidden> 
 App id:        556970798471513 
 App name:      MyAPP 
 User id:       2834875706531386 
 User name:     Алексей Селезнёв 
 Expires at:    2019-12-31 09:32:15

При авторизации через собственное приложение с минимальным уровнем доступа к API срок действия вашего токена будет ограничен. В сообщение приведённом выше видно, что полученный токен действителен до 31 декабря 2019 года 09:32:15.

На самом деле пакет rfacebookstat сам автоматически будет продлевать ваш токен по мере необходимости в случае если до завершена срока действия остаётся менее 10 дней.

Переменные среды

Это наиболее удобный способ работы с учётными данными в rfacebookstat, к тому же его преимущество заключается в том, что не будет необходимости хранить ваш токен в виде текстовой строки в скрипте.

Создать переменные среды можно несколькими способами:

1. Прописать их в файл .Renviron;
2. Настроить переменные окружения (для пользователей Windows):
3. Задать в начале скрипта с помощью команды Sys.setenv().

path.expand("~")

[1] "C:/Users/username/Documents"

RFB_API_TOKEN="abcdef788dsydsy9dcy"

RFB_USER="seleznev_a"
RFB_TOKEN_PATH="D:/fb_auth_store"

Настройка переменных среды в Windows

В Windows можно создать переменные среды следующем способом:

1. В строке “Поиск” выполните поиск: Система (Панель управления)
2. Нажмите на ссылку Дополнительные параметры системы.
3. Нажмите Переменные среды.
4. Нажмите кнопку “Создать…”
5. Создайте нужные вам переменные, перечисленные в прошлом пункте.

Переменная среды в Windows

Sys.setenv(RFB_USER="seleznev_a", 
           RFB_TOKEN_PATH="D:/fb_auth_store")

library(rfacebookstat)

rfacebookstat presets:
...Set rfacebookstat token_path: success
...Set rfacebookstat username: success
...Set rfacebookstat access_token: none
...Set Facebook Marketing API Version: v5.0

Опции

Ещё один вариант инициализации учётных данных задать их с помощью опций. Также опции позволяют избежать дублирования аргументов без необходимости. Все опции вы можете задать в начале скрипта после подключения пакета. В rfacebookstat доступны следующие опции:

• rfacebookstat.api_version - Версия API к которой пакет будет направлять запросы, не рекомендуется изменять эту опцию;
• rfacebookstat.access_token - Ваш токен доступа, также не рекомендуется хранить его текстом в ваших скриптах;
• rfacebookstat.accounts_id - ID аккаунтов которые вы используете в скрипте по умолчанию, можно задавать вектором;
• rfacebookstat.business_id - ID бизнес менеджера который вы планируете использовать в скрипте по умолчанию
• rfacebookstat.token_path - Путь к папке, где хранятся файлы с учётными данными;
• rfacebookstat.username - Имя пользователя facebook;
• rfacebookstat.app_id - ID созданного вами приложения в Facebook для авторизации;
• rfacebookstat.app_secret - Секрет созданного вами приложения в Facebook.

Пример использования опций:

library(rfacebookstat)

options(rfacebookstat.username = "seleznev_a",
        rfacebookstat.token_path = ""D:/fb_auth_store")

После установки опций каждая из функций пакета будет запрашивать значения большинства аргументов именно из опций, что избавит вам от излишнего дублирования этих значений в коде.

Так же для установки опций в пакете реализован набор функций с префиксом fbSet*().

• fbSetUsername(username) - установка имя пользователя
• fbSetAccount(accounts_ids) - установка идентификатор аккаунтов
• fbSetBusinessId(business_ids) - установка идентификаторов бизнес менеджеров
• fbSetTokenPath(token_path) - установка пути к папке для работы с токенами
• fbSetApiVersion(api_version) - установка версии API

Приоритет переменных для авторизации

В каждом запросе к API необходимо передавать учётные данные, при этом каждая из функций пакета осуществляет поиск учётных данных по следующему пути.

1. Заданные в функции аргументы;
2. Опции;
3. Переменные среды.

Соответственно аргументы функции имеют максимальный приоритет.

Получить список логинов под которыми была пройдена автоизация

С помощью функции fbGetLogins() вы можете запрашивать список логинов, под которыми вы уже успешно прошли авторизацию, и переключаться между ними.