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.
