Версия 8.0

API Graph

Выпуск: 4 августа 2020 г. | Доступно до: 1 ноября 2022 г. | Запись в блоге

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

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /token_deprecation_check

Альбомы

Восстановленные конечные точки

Относится ко всем версиям.

• GET /{album-id}/likes

Конфигурация приложения

Типы приложений

Это изменение относится ко всем версиям.

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

Бизнес-приложения

Для бизнес-приложений используется новый механизм авторизации — уровни доступа. Они заменяют режим разработки и рабочий режим, которые были упразднены для бизнес-приложений, и упрощают процесс проверки приложения. Кроме того, появилась функция доступа к профилю пользователя объектов компании, которая позволяет бизнес-приложениям считывать некоторые общедоступные поля пользователей. Более подробные описания этих изменений приведены ниже.

Уровни доступа

Относится ко всем версиям.

Уровни доступа — это новый механизм авторизации API Graph для бизнес-приложений, который применяется к отдельным разрешениям и функциям. Стандартный уровень предоставляет доступ только к данным пользователей, имеющих роль в приложении или в компании, выступающей владельцем приложения. Расширенный уровень дает доступ к данным, принадлежащим любому пользователю приложения, но для его получения приложение должно пройти проверку. Бизнес-приложения автоматически получают стандартный уровень доступа для всех разрешений и функций, доступных для их типа.

Упразднение режима разработки и рабочего режима

Относится ко всем версиям.

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

Функция доступа к профилю пользователя объектов компании

Относится ко всем версиям.

Эта новая функция позволяет бизнес-приложениям просматривать некоторые общедоступные поля пользователя, который взаимодействовал с объектами компании, выступающей владельцем приложения. Список доступных для просмотра полей см. в справке по функции.

Комментарии

Восстановленные конечные точки

Относится ко всем версиям.

• GET /{comment-id}/likes

Устройства

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• POST /device/share

Группы

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{group-id}/posts

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /{group-post-id}/likes

Instagram

Новая конечная точка oEmbed для Instagram

Относится ко всем версиям.

Добавлена новая конечная точка GET /instagram_oembed. Она дает те же возможности, что и устаревшие конечные точки oEmbed для Instagram, которые будут упразднены 24 октября 2020 г. Для новой конечной точки требуется маркер доступа, поэтому вам понадобятся аккаунт разработчика Facebook и зарегистрированное приложение. Инструкции по использованию и дополнительную информацию см. в этом документе.

События из жизни

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Ссылки

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{link-id}/reactions

Видео в прямом эфире

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{live-video-id}/likes

Чтобы получить отметки "Нравится" для видео в прямом эфире, используйте конечную точку GET /{live-video-id}/reactions.

Параметр save_vod

Действует начиная с версии 8.0. Начнет действовать для всех версий со 2 ноября 2020 г.

Параметр save_vod упразднен для следующих границ контекста:

• POST /{user_id}/live_videos;
• POST /{group_id}/live_videos;
• POST /{page_id}/live_videos;
• POST /{event_id}/live_videos.

Платформа Messenger

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Проверка приложения

Относится ко всем версиям.

Чтобы запросить проверку приложения для Messenger, теперь нужно выбрать не Продукты > Messenger > Настройки, а Проверка приложения на панели приложений. Чтобы запросить относящиеся к Messenger разрешения pages_messaging, pages_user_gender, pages_user_locale и pages_user_timezone, выберите Проверка приложения > Разрешения и функции. Подробные сведения см. в этом документе.

Граница контекста профиля Messenger

Действует начиная с версии 8.0.

Тип "вложенное постоянное меню" упразднен для POST /{page-id}/messenger_profile.

Новая функция: Messenger для Магазинов

Действует начиная с версии 8.0.

В Messenger для Магазинов появилась возможность отправлять и получать данные о товарах. Теперь можно использовать шаблон товара для отправки данных о нем в сообщениях, применять Webhooks для сообщений с шаблоном товара и сообщений со страниц с описанием товаров из Facebook Магазинов, а также использовать Webhooks типа echo для сообщений с данными о товарах.

• GET /{message_id}/access_requests
• POST {page_id}/message
• Webhook message_echo
• Webhook messages

Нативные предложения

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Страницы

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Публикация Страницы

Упразднено во всех версиях.

Прежний формат ID комментария к публикации Страницы ({page-id}_{post_id}_{comment-id}) упразднен. Используйте формат {pagepost-id}_{comment-id}.

Фото

Упраздненные конечные точки

Упразднено во всех версиях.

• GET /{photo-id}/sharedposts

Места

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{place-information-id} (см. раздел Исправления)

Публикации

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /{post-id}/likes

Чтобы получить отметки "Нравится" для публикации, используйте конечную точку GET /post/reactions.

Поиск

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /search?type=place
• GET /search?type=audience_interest

Настройки безопасности

Упраздненные поля

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях в ноябре 2020 г.

• secure_browsing

Социальные плагины

Конечные точки Facebook oEmbed

Это изменение вступит в силу для всех версий 24 октября 2020 г.

Конечные точки oEmbed для Facebook, которые позволяют приложениям получать HTML-код для встраивания общедоступных публикаций и видео с Facebook, будут упразднены 24 октября 2020 г. Вместо них вводятся три новые конечные точки:

• GET /oembed_page;
• GET /oembed_post;
• GET /oembed_video.

Для них будет требоваться маркер доступа, а число обращений к ним будет ограничиваться. Инструкции об использовании и дополнительную информацию см. в новой документации по конечным точкам oEmbed.

Пользователи

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{user-id}/taggable_friends

Упраздненные поля

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях в ноябре 2020 г.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Упразднено во всех версиях.

• can_review_measurement_request
• is_famedeeplinkinguser

Повторная авторизация

Это изменение относится ко всем версиям.

С 24 октября 2020 г. для доступа к следующим полям будет требоваться повторная авторизация в случае отсутствия активности в течение 90 дней:

• is_eligible_promo;
• payment_mobile_pricepoint;
• payment_pricepoints.

Фото пользователя

Относится ко всем версиям с 24 октября 2020 г.

С 24 октября 2020 г. для запросов к конечной точке GET /{user-id}/picture (GET /{user-id}?fields=picture) без маркера будет требоваться ID пользователя внутри приложения. Если вы не указываете его, в запрос необходимо добавить маркер доступа приложения, клиента или пользователя. Подробные сведения см. в справке по фото пользователя.

Вопросы в видео

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Упраздненные конечные точки

Упразднено начиная с версии 8.0. Будет упразднено во всех версиях 2 ноября 2020 г.

• GET /{company-id}/access_requests
• GET /access_requests

API Marketing

Выпуск: 4 августа 2020 г. | Доступно до: 4 мая 2021 г. | Запись в блоге

Рекламные аккаунты

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Разрешения

Действует начиная с версии 8.0. Начнет действовать для всех версий со 2 ноября 2020 г.

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

Правила кастомизации креативов

Проверка

Действует начиная с версии 8.0.

Для всех объявлений, в которых используется параметр asset_feed_spec, нужно указать не менее двух правил кастомизации. Если креатив содержит поле asset_feed_specи менее двух правил, вы не сможете создать объявление.

Это изменение касается кастомизации креативов для мест размещения, многоязычных объявлений и сегментированной кастомизации креативов.

Сегментированная кастомизация креативов

Действует начиная с версии 8.0. Начнет действовать для всех версий со 2 ноября 2020 г.

Для пользователей сегментированной кастомизации креативов упразднены все сценарии использования, не связанные с геолокацией. Теперь все правила таргетинга должны содержать информацию о геолокации в параметрах кастомизации. Исключение — правило по умолчанию, для которого не требуется геолокация.

Ставки

Стратегия назначения ставок по целевой цене

Действует начиная с версии 8.0.

Стратегия назначения ставок TARGET_COST упразднена. Чтобы и далее контролировать расходы, мы рекомендуем использовать стратегию предельной цены. См. сведения обо всех доступных стратегиях назначения ставок.

Business Manager

Упраздненные конечные точки

Упразднено начиная с версии 8.0.

• GET{system-user-id}/updated_by

Восстановлены конечные точки соглашений о совместном доступе

Относится ко всем версиям.

Следующие конечные точки восстановлены:

• /{business-id}/received_sharing_agreements;
• /{business-id}/initiated_sharing_agreements.

Они были упразднены ранее с выпуском API Graph версии 6.0.

Холст

Упраздненные конечные точки

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API Catalog

Разрешения

Действует начиная с версии 8.0. Начнет действовать для всех версий с 31 января 2021 г.

Для доступа к конечным точкам каталога товаров разрешение ads_management больше не требуется. В дальнейшем для их вызова будет требоваться разрешение catalog_management. Если в течение последних 90 дней разработчик обращался к конечным точкам каталога с помощью разрешения ads_management, то до 14 августа 2020 г. он будет автоматически переведен на разрешение catalog_management.

До 28 февраля 2021 г. разработчики, использующие предыдущие версии API, смогут обращаться к конечным точкам каталога товаров с разрешением ads_management. При использовании версии 8.0 необходимо разрешение catalog_management.

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

Аутентификация

Действует начиная с версии 8.0. Начнет действовать для всех версий со 2 ноября 2020 г.

[ОБНОВЛЕНО] Перечисленные ниже конечные точки API Catalog теперь учитывают настройки двухфакторной аутентификации для компании. Если компания, которой принадлежит каталог, требует двухфакторной аутентификации для текущего пользователя приложения, но он не прошел ее, вызов любой из этих конечных точек вернет ошибку.

Когда пользователь обращается к каталогу через компанию-партнера, мы учитываем настройки аутентификации из аккаунта Business Manager партнера. Системным пользователям проходить двухфакторную аутентификацию не нужно.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Отчеты

Упраздненные элементы

Действует начиная с версии 8.0.

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Таргетинг

Упраздненный элемент

Действует начиная с версии 8.0.

• GET /search?type=adzipcode

Исправления

• 28 сентября 2020 г. были внесены уточнения в раздел, посвященный аутентификации при доступе к API Catalog.
• 23 октября 2020 г. были внесены уточнения в раздел, посвященный API Catalog.

  • Продлен срок, до которого разработчики, использующие предыдущие версии API, смогут обращаться к конечным точкам каталога товаров с разрешением ads_management. Новая дата — 28 февраля 2021 г.
  • Внесено уточнение, связанное с аутентификацией системных пользователей.
• 17 мая 2021 г. вместо конечной точки GET /{place-id} была упразднена точка GET /{place-information-id}. Точка GET /{place-id} осталась активной.