Facebook API: публикация записей в ленту групп и страниц

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.