Graph API
Версия API Graph

URL /?id={url}

Представляет URL, размещенный в публикации или комментарии к публикации.

Дополнительную информацию см. в этом разделе.

Чтение

Получение информации о URL, размещенном в публикации или комментарии к публикации.

Требования

ТипОписание
Маркеры доступа

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

Функции

Неприменимо.

Задачи на Странице

Неприменимо.

Разрешения

Неприменимо.

Ограничения

  • Возвращаемые значения вовлеченности являются приблизительными, однако дают представление о взаимодействии пользователей с URL.
  • В час можно выполнять не более 10 запросов GET для одного URL и приложения.

Параметры

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

ПараметрОписание

access_token

Обязательный

Строка

Маркер доступа.

fields

строка

Список запрашиваемых полей через запятую.

id

строка

Публикуемый URL.

scopes

строка

Список областей действия через запятую.

Поля

Имя свойства Описание Тип
app_links

Ссылки AppLinks, связанные с этим URL (если они есть).

AppLinks

id

Собственно URL.

string

engagement

Различные способы взаимодействия пользователей с этим URL. Обратите внимание: количество взаимодействий намеренно сделано приблизительным, однако достоверно отражает взаимодействие пользователей с URL.

object

comment_count

Количество комментариев для URL.

int

comment_plugin_count

Количество комментариев, собранных с помощью плагина комментариев на вашем сайте.

int

reaction_count

Количество реакций на URL.

int

share_count

Сколько раз пользователи поделились этим URL.

int

og_object

Объект Open Graph, канонически связанный с этим URL.

OGObject

id

ID объекта.

string

description

Описание объекта, если оно доступно.

string

title

Название объекта, если оно есть.

string

type

Тип объекта.

og:type

updated_time

Время последнего обновления объекта.

datetime

Примеры

Чтобы получить информацию о URL, размещенном в публикации или комментарии, отправьте запрос GET к конечной точке https://graph.facebook.com и укажите этот URL в параметре id, а также другие связанные с URL поля и маркер доступа, запрошенный у пользователя или Страницы, которые разместили публикацию или комментарий.

В следующем примере показано взаимодействие с URL https://www.facebook.com, которым поделился пользователь, представленный маркером доступа пользователя.

Для удобства чтения применено форматирование.
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

В случае успеха ваше приложение получит следующие показатели вовлеченности для этого URL:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

Создание

Эта операция не поддерживается для данной конечной точки.

Обновление

Обновление URL.

Требования

ТипОписание
Маркеры доступа

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

Функции

Неприменимо.

Задачи на Странице

Неприменимо.

Разрешения

Неприменимо.

Примеры

Чтобы обновить информацию о URL, размещенном в публикации или комментарии, отправьте запрос POST к конечной точке https://graph.facebook.com, указав этот URL в параметре id, значение true в параметре scrape, другие связанные с этим URL поля fields и маркер доступа, запрошенный у пользователя или Страницы, которые разместили публикацию или комментарий.

В следующем примере показано обновление URL https://www.facebook.com/my-update, которым поделился пользователь, представленный маркером доступа пользователя.

Для удобства чтения применено форматирование.
curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

В случае успеха ваше приложение получит следующие показатели вовлеченности для этого URL:

{
  "success": true
}

Параметры строки запроса

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

ПараметрОписание

access_token

Обязательный

строка

Маркер доступа.

fields

строка

Список запрашиваемых полей через запятую.

id

Обязательный

строка

Обновляемый URL. Чтобы параметр scrape интерпретировался правильно, URL должен быть закодирован.

scrape

Обязательный

логическое значение

Должен иметь значение true.

Пример запроса

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

Пример ответа

{
  "success": true
}

Удаление

Эта операция не поддерживается для данной конечной точки.