Facebook API дает возможность размещать информацию на страницах или в группах FB без участия редактора. Например, автоматически публиковать в соцсети новости сайта сразу после их появления. Под катом пример интеграции самой актуальной на данный момент библиотеки FB SDK for PHP v5.0.0 и описание популярных ошибок ее использования.
В отличие от Вконтакте, методы работы с группами и страницами fb несколько отличаются, поэтому им будут посвещены отдельные разделы. В общем же виде статья содержит 4 блока:
1. создание приложения
2. получение токена
3. настройка публикации в группу
4. настройка публикации на страницу
Создание приложения
На странице My Apps нужно создать приложение типа «Веб-сайт», дать ему произвольное название и перейти в раздел «Settings»
Здесь обязательно заполняем поля «App Domains» и «Contact Email», иначе fb не даст перевести приложение из песочницы в рабочий режим и публикации будут видны только администраторам.
На странице «Status & Review» публикуем
Стоит отметить, что получать токен доступа мы планируем от имени аккаунта администратора приложения — в данном случае не нужно настраивать и обосновывать fb использование разрешений.
Теперь можно скопировать значения «App ID» и «App Secret» и переходить к следующему шагу.
Получение access token
Для работы с API понадобится библиотека FB SDK for PHP v5.0.0, скачать ее можно на официальном сайте. Там же находятся примеры и документация.
На сайте создадим страницу login.php, единственная задача которой — сформировать ссылку на страницу авторизации:
<? // старт сессии необходим библиотеке session_start(); require_once __DIR__ . '/../class/Facebook/autoload.php'; // App ID и App Secret из настроек приложения $app_id = "1057093380989633"; $app_secret = "bd4f3810d8875d"; // ссылка на страницу возврата после авторизации // домен должен совпадать с указанным в настройках приложения $callback = "http://api.alexvaleev.ru/fb/callback/"; $fb = new Facebook\Facebook([ 'app_id' => $app_id, 'app_secret' => $app_secret, 'default_graph_version' => 'v2.4', ]); $helper = $fb->getRedirectLoginHelper(); // для публикации в группах достаточно разрешения publish_actions // для публикации на страницах нужны все 3 элемента $permissions = ['publish_actions','manage_pages','publish_pages']; $loginUrl = $helper->getLoginUrl($callback, $permissions); echo '<a href="' . htmlspecialchars($loginUrl) . '">Log in with Facebook!</a>';
Также нужна страница callback.php, именно там мы поймаем токен (код практически без изменений взят из документации):
<? session_start(); require_once __DIR__ . '/../class/Facebook/autoload.php'; // App ID и App Secret из настроек приложения $app_id = "1057093380989633"; $app_secret = "bd4f3810d8875d"; $fb = new Facebook\Facebook([ 'app_id' => $app_id, 'app_secret' => $app_secret, 'default_graph_version' => 'v2.4', ]); $helper = $fb->getRedirectLoginHelper(); try { $accessToken = $helper->getAccessToken(); } catch(Facebook\Exceptions\FacebookResponseException $e) { // When Graph returns an error echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(Facebook\Exceptions\FacebookSDKException $e) { // When validation fails or other local issues echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } if (! isset($accessToken)) { if ($helper->getError()) { header('HTTP/1.0 401 Unauthorized'); echo "Error: " . $helper->getError() . "\n"; echo "Error Code: " . $helper->getErrorCode() . "\n"; echo "Error Reason: " . $helper->getErrorReason() . "\n"; echo "Error Description: " . $helper->getErrorDescription() . "\n"; } else { header('HTTP/1.0 400 Bad Request'); echo 'Bad request'; } exit; } // Logged in echo '<h3>Access Token</h3>'; var_dump($accessToken->getValue()); // The OAuth 2.0 client handler helps us manage access tokens $oAuth2Client = $fb->getOAuth2Client(); // Get the access token metadata from /debug_token $tokenMetadata = $oAuth2Client->debugToken($accessToken); echo '<h3>Metadata</h3>'; var_dump($tokenMetadata); // Validation (these will throw FacebookSDKException's when they fail) $tokenMetadata->validateAppId($app_id); // If you know the user ID this access token belongs to, you can validate it here //$tokenMetadata->validateUserId('123'); $tokenMetadata->validateExpiration(); if (! $accessToken->isLongLived()) { // Exchanges a short-lived access token for a long-lived one try { $accessToken = $oAuth2Client->getLongLivedAccessToken($accessToken); } catch (Facebook\Exceptions\FacebookSDKException $e) { echo "<p>Error getting long-lived access token: " . $helper->getMessage() . "</p>\n\n"; exit; } echo '<h3>Long-lived</h3>'; var_dump($accessToken->getValue()); }
Переходим на страницу авторизации и разрешаем приложению все, что оно запрашивает.
В диалоге определения области видимости публикаций важно отметить «Доступно всем», в противном случае будет выбрасываться ошибка
(#200) Insufficient permission to post to target on behalf of the viewerИспользуя полученный токен можно размещать контент в группы или себе в ленту. Время его жизни всего 60 дней, т.е. каждые 2 месяца придется получать новый. Это не относится к токенам страниц (они вечные).
Настройка публикации в группу
Единственное требование при настройке группы — сделать ее видимой. При попытке разместить что-либо в «секретной» группе FB API вернет ошибку
Unsupported post request.
Скрипт публикации:
<? require_once __DIR__ . '/../class/Facebook/autoload.php'; // App ID и App Secret из настроек приложения $app_id = "1057093380989633"; $app_secret = "bd4f3810d8875d"; // ID группы и токен $group_id = "169341013404224"; $token = "CAAPBa7t34sEBAGqXsKyPO7hDgRBcfj0Ma3saPxV7WiHttKIQrZCgLmJf4xJZCUO1PUgxQ"; $fb = new Facebook\Facebook([ 'app_id' => $app_id, 'app_secret' => $app_secret, 'default_graph_version' => 'v2.4', ]); // описание параметров есть в документации $linkData = [ 'link' => 'http://alexvaleev.ru', 'message' => 'It works!', ]; try { // Returns a `Facebook\FacebookResponse` object $response = $fb->post("/{$group_id}/feed", $linkData, $token); } catch(Facebook\Exceptions\FacebookResponseException $e) { echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(Facebook\Exceptions\FacebookSDKException $e) { echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } $graphNode = $response->getGraphNode(); echo 'Posted with id: ' . $graphNode['id'];
В случае успешного выполнения пост появится в ленте группы
Настройка публикации на страницу
Страницы имеют 2 важных отличия от групп:
1. публикация в основную ленту возможна только с отдельным токеном страницы, но он является вечным и его не нужно получать заново.
2. посты в группу возможны только от имени пользователя, на страницу — от имени страницы.
Получить токен страницы проще всего в Graph API Explorer. Вставляем полученный на прошлом шаге «пользовательский» токен, жмем submit и получаем токены всех своих страниц.
Теперь можно публиковать:
<? require_once __DIR__ . '/../class/Facebook/autoload.php'; // App ID и App Secret из настроек приложения $app_id = "1057093380989633"; $app_secret = "bd4f3810d8875d"; // ID страницы и токен $page_id = "497620137079453"; $token = "CAAPBa7t34sEBANjFScsnaF7j4Fg9RlXE3rZC7Rsqz5smbkzxwPIOF5B0ZApZAlcZAW"; $fb = new Facebook\Facebook([ 'app_id' => $app_id, 'app_secret' => $app_secret, 'default_graph_version' => 'v2.4', ]); // описание параметров есть в документации $linkData = [ 'link' => 'http://alexvaleev.ru', 'message' => 'It works!', ]; try { // Returns a `Facebook\FacebookResponse` object $response = $fb->post("/{$page_id}/feed", $linkData, $token); } catch(Facebook\Exceptions\FacebookResponseException $e) { echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(Facebook\Exceptions\FacebookSDKException $e) { echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } $graphNode = $response->getGraphNode(); echo 'Posted with id: ' . $graphNode['id'];
Лайвхак — токен страницы можно получить без создания login.php и callback.php, используя исключительно Graph API Explorer.