Представляем Graph API 26.0 и Marketing API 26.0

В этой статье представлены новые функции, упраздненные элементы и важные изменения в Graph API и Marketing API 26.0. Ознакомьтесь с основными сведениями ниже и перейдите к журналу изменений версии 26.0, чтобы увидеть полный список изменений и подробные сведения о них.

Важные даты и изменения

• Graph API — управление коммерческими заказами: с 29 июля 2026 года блокируются вызовы к затронутым конечным точкам в версии 26.0 и более поздних. Эти конечные точки будут удалены из всех оставшихся версий Graph API 27 октября 2026 года. После этого вызовы будут возвращать ошибки. Альтернативный API не предусмотрен.
• Graph API — поля владельца в Rights Manager: начиная с версии 26.0 от 29 июля 2026 года доступны поля-заменители, возвращающие тип RightsHolderOwner. Устаревшие поля владельца больше не возвращаются. Упраздненные поля будут доступны в версии 25.0 и более ранних в течение двух лет после запуска версии 26.0.
• Graph API — функции устаревшего протокола: с 29 июля 2026 года 5 устаревших вариантов поведения будут удалены из вызовов версии 26.0. С 27 октября 2026 года это изменение будет также распространяться на все поддерживаемые версии Graph API.
• Marketing API — реклама в статусе WhatsApp: с 29 июля 2026 года в версии 26.0 будут расширены функции, связанные с идентификатором, таргетингом, оптимизацией и креативом.
• Marketing API — аудитория Advantage+ для кампаний с рекламой жилья, трудоустройства, а также финансовых продуктов и услуг. Начиная с версии 26.0 от 29 июля 2026 года для новых или скопированных групп объявлений с ограниченным таргетингом необходимо явно установить для параметра advantage_audience значение 1 или 0. При стандартных и упрощенных настройках по умолчанию будет по-прежнему использоваться значение 1. Это не повлияет на существующие изменения в группах объявлений.
• Marketing API — лента "Интересное" в Instagram: с 29 июля 2026 года это место размещения станет недоступно в версии 26.0. Разработчикам нужно удалить "Интересное" из конфигурации мест размещения.
• Marketing API — место назначения только на сайте для кампаний с местами назначения "Сайт и приложение". Начиная с версии 26.0 от 29 июля 2026 года в кампаниях с местами получения конверсий "Сайт и приложение" нельзя использовать креативы, в которых для параметра applink_treatment установлено значение web_only. Ограничение распространяется на все версии Marketing API и вступит в силу 27 октября 2026 года.
• Marketing API — истории в Messenger: начиная с 29 июля 2026 года для вызовов версии 26.0 значение story будет автоматически и безвозвратно исключено из списка messenger_positions при создании или обновлении групп объявлений. 27 октября 2026 года будет прекращена поддержка всех версий Marketing API, в том числе вызовов без указания версии.
• Marketing API — создание рекламы с опросом. Начиная с версии 26.0 от 29 июля 2026 года запросы на создание креатива с опросом или на изменение рекламы для использования такого креатива будут отклоняться. Вы по-прежнему можете обновлять существующую рекламу, не меняя ее креатив. 27 октября 2026 года будут упразднены все версии Marketing API.
• Graph API и Marketing API — поля прогнозируемого показа: с 29 июля 2026 года поля ответов daily_outcomes_curve, budget_guardrail и estimate_dau будут удаляться из вызовов в версии 26.0. Для всех остальных поддерживаемых версий изменение вступит в силу с 27 октября 2026 года. Альтернативный API не предусмотрен.
• Упразднение версий Graph API: версия Graph API 20.0 будет упразднена и удалена 24 сентября 2026 года. Версия Graph API 21.0 устаревает и будет удалена 21 января 2027 года.

Общие обновления

Marketing API: расширенная поддержка рекламы в статусе WhatsApp

Начиная с Marketing API версии 26.0 от 29 июля 2026 года реклама в статусе WhatsApp будет поддерживать дополнительные функции, связанные с идентификатором, таргетингом, оптимизацией и креативом.

• Источник в WhatsApp: при вызове Marketing API сторонними сервисами нужно явно указывать параметр wamo_whatsapp_identity_spec в рекламных креативах, предназначенных для показа в статусе WhatsApp. Идентификатор WhatsApp для таких сторонних вызовов не подставляется автоматически по умолчанию.
• Таргетинг на людей с неизвестным возрастом. Если при выборе места размещения "Статус WhatsApp" не задать значение user_age_unknown, то в поле по умолчанию будет установлено значение true. Это означает, что кампания может охватывать людей в WhatsApp, чей возраст неизвестен.
• Оптимизация: оптимизация для конверсий вне сайта поддерживается целями "Продажи", "Лиды" и "Вовлеченность". Также поддерживается цель оптимизации "Просмотры целевой страницы".
• Формат креатива: реклама с кольцевой галереей поддерживает до 10 карточек.

Узнать больше можно в документации по таргетингу по местам размещения и базовому таргетингу.

Упраздненные элементы и важные изменения

Graph API и Marketing API: удаление поля в Delivery Estimate

Поля daily_outcomes_curve, budget_guardrail и estimate_dau будут удалены из ответа конечной точки Delivery Estimate, поскольку сервис, предоставлявший эти значения, больше не поддерживается. Начиная с 29 июля 2026 года эти поля перестанут возвращаться в Graph API и Marketing API версии 26.0. Изменение применится ко всем оставшимся поддерживаемым версиям Graph API и Marketing API с 27 октября 2026 года. Альтернативный API не предусмотрен.

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

Некоторые затронутые конечные точки:

• GET /{ad-account-id}/delivery_estimate — прогноз показов для рекламного аккаунта.
• GET /{adset-id}/delivery_estimate — прогноз показов для группы объявлений.

Полный список полей и конечных точек будет доступен в журнале изменений для версии 26.0.

Graph API: прекращение поддержки Commerce Order Management API

С 29 июля 2026 года вызовы этих конечных точек будут блокироваться в Graph API 26.0 и более поздних версиях. Конечные точки будут удалены для всех оставшихся версий Graph API 27 октября 2026 года. После этого вызовы будут возвращать ошибки.

Мы прекратили поддержку функции оформления заказа на Facebook и в Instagram для магазинов. Commerce Order Management API позволял сторонним платформам получать список заказов, просматривать информацию о заказе, управлять отправкой, обрабатывать отмены и возвраты средств, а также отслеживать возвраты товаров. Поскольку мы прекращаем поддержку базовой инфраструктуры заказов, эти конечные точки больше не будут доступны.

Разработчикам нужно прекратить вызывать эти конечные точки и удалить зависимость. Альтернативный API не предусмотрен.

Некоторые затронутые конечные точки:

• GET /{commerce-order-id} — сведения о заказе
• GET /{commerce-order-id}/items — позиции заказа
• GET /{commerce-order-id}/payments — платежи по заказу
• GET /{commerce-order-id}/payment_transaction_details — сведения о платежной транзакции
• GET /{commerce-order-id}/refunds — возврат средств за заказ.
• GET /{commerce-order-id}/shipments — отправка заказов.
• GET /{commerce-order-shipment-id}/items — позиции в отправлении
• GET /{commerce-return-id} - Сведения о возврате
• GET /{commerce-order-cancellation-id}/items — позиции отмены
• GET /{page-id}/commerce_orders — список заказов по Странице
• GET /{commerce-merchant-settings-id}/commerce_orders — список заказов в соответствии с настройками продавца.
• GET /{commerce-merchant-settings-id}/commerce_returns — список возвратов согласно настройкам продавца.
• GET /{commerce-merchant-settings-id}/tax_settings - Настройки налогов

Полный список всех 47 затронутых конечных точек будет доступен в журнале изменений Graph API 26.0.

Graph API: поля владельца в Rights Manager перенесены в RightsHolderOwner

Поля reference_owner и matched_reference_owner в AudioVisualReferenceMatch и ImageReferenceMatch, а также поля sending_rights_holder и receiving_rights_holder в CopyrightOwnershipTransfer будут упразднены. Начиная с Graph API 26.0, новые поля возвращают специальный тип RightsHolderOwner, который лучше отражает модель права собственности, используемую в Rights Manager. Устаревшие поля больше не возвращаются в ответах Graph API 26.0 и более поздних версиях.

Устаревшие поля будут работать в версии 25.0 и более ранних в течение двух лет после выпуска версии 26.0, а затем будут удалены. В течение этого двухлетнего периода разработчики должны перейти на новые поля.

Используйте следующие поля:

• Используйте reference_owner_rh_owner вместо reference_owner.
• Используйте matched_reference_owner_rh_owner вместо matched_reference_owner.
• Используйте sending_rights_holder_owner вместо sending_rights_holder.
• Используйте receiving_rights_holder_owner вместо receiving_rights_holder.

Некоторые затронутые конечные точки:

• GET /{audio-visual-reference-match-id} — получение информации о совпадении контрольного файла
• GET /{image-reference-match-id} — получение информации о совпадении контрольного изображения
• GET /{copyright-ownership-transfer-id} — получение информации о передаче права собственности.

Полный список полей будет доступен в журнале изменений Graph API 26.0.

Graph API: устаревшие функции протокола упразднены

Начиная с 29 июля 2026 года Graph API 26.0 и более поздних версий перестанет поддерживать пять устаревших вариантов поведения протокола: pretty, debug, date_format, корневые запросы GET /?ids=... и устаревшую обработку If-None-Match / ETag.

Поддержка этих вариантов поведения протокола будет прекращена, чтобы упростить ответы Graph API и сделать обработку запросов более последовательной.

Для Graph API 26.0 и более поздних версий:

• Параметр pretty игнорируется, а ответы JSON используют компактное форматирование. Отформатируйте JSON в инструментах или коде клиента.
• debug игнорируется, и отладочная обертка не добавляется. Используйте стандартные инструменты отладки. Это не повлияет на конечную точку debug_token.
• Запросы, которые включают в себя date_format, вернут ошибку параметра. Используйте формат даты по умолчанию и при необходимости конвертируйте значения в местные.
• Корневые запросы с GET /?ids=... вернут ошибку параметра. Используйте запросы для каждого объекта или поддерживаемый пакетный запрос.
• Параметр If-None-Match игнорируется. Устаревшие варианты поведения заголовков ответов ETag и 304 Not Modified удалены, а запросы возвращают полные ответы.

С 27 октября 2026 года эти изменения будут применены ко всем оставшимся поддерживаемым версиям Graph API. Чтобы узнать больше о переносе, ознакомьтесь с журналами запросов во время выполнения и журналом изменений в Graph API версии 26.0.

Прекращение поддержки устаревших полей Страницы для новой версии Страниц (Graph API 26.0)

Черновик записи в блоге для разработчиков. Целевая версия: Graph API 26.0. Тип изменения: прекращение поддержки (90 дней).

Обзор:

Начиная с Graph API 26.0, для Страниц в новой версии будет прекращена поддержка 5 устаревших полей узлов Страницы (current_location, genre, network, parking, start_info) и настройки Страницы auto_publish_page_info_updates. Эти поля больше не поддерживаются, поэтому их не следует использовать для новых версий Страниц.

Сроки:

• 29 июля 2026 года. Поля заблокированы, а начиная с версии 26.0, для новой версии Страниц удалена настройка.
• Приблизительно через 90 дней после запуска: Такое же изменение применяется ко всем оставшимся версиям. Точная дата в конце октября 2026 года будет объявлена позже.

Что изменится?

В версии 26.0 и более поздних при запросе любого из этих пяти полей на Странице в новой версии будет возвращена ошибка версии, а настройка auto_publish_page_info_updates перестанет появляться в ответе на настройки Страницы. В более ранних версиях изменения не коснутся пользователей до окончания 90-дневного периода переноса. Затем изменения начнут распространяться на все версии.

Затронутые конечные точки:

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings — настройка auto_publish_page_info_updates удаляется из возвращаемого списка настроек.

Дальнейшие действия разработчиков:

• Удалите эти поля и параметр auto_publish_page_info_updates из запросов Страницы.
• Проверьте журналы запросов, интеграции клиентов и панели для использования этих полей на Страницах в новой версии.
• Актуальный список всех изменений можно найти в журнале изменений Graph API для версии 26.0.

Справка:

• Справка по узлу Страницы

Marketing API: требования к аудитории Advantage+ для кампаний с рекламой жилья, трудоустройства, а также финансовых продуктов и услуг

Начиная с 29 июля 2026 года с выпуском Marketing API v26.0 для параметра advantage_audience в targeting_automation будет автоматически установлено значение 1 при настройке аудитории по умолчанию или с менее строгими ограничениями. Если настройки аудитории ограничены, разработчикам нужно явно установить для параметра advantage_audience значение 1 или 0. Это касается кампаний, которые относятся к особым категориям рекламы (продвигают жилье, трудоустройство либо финансовые продукты и услуги).

Это правило действует только при создании новой группы объявлений. При обновлении существующей группы объявлений это не происходит ни в одной из версий API.

Такое изменение уже распространяется на кампании, не относящиеся к особым категориям рекламы, в Marketing API 23.0. Узнать больше можно в документации по устранению проблем с аудиторией Advantage+.

Затронутые конечные точки API:

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

Marketing API: место размещения рекламы "Интересное" больше не доступно

Начиная с Marketing API v26.0, которое будет выпущено 29 июля 2026 года, место размещения "Лента "Интересное" Instagram" больше не будет доступно. Показ рекламы в разделе "Интересное" прекратится, а средства кампании будут автоматически перенаправляться на другие подходящие места размещения.

При попытке создать или обновить группу объявлений с местом размещения "Интересное" возникнет ошибка. Разработчикам нужно удалить вариант "Интересное" из конфигураций мест размещения и использовать другие доступные места.

Затронутые конечные точки:

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

Marketing API: прекращение поддержки места назначения "Сайт" для кампаний с местом назначения "Сайт и приложение"

Начиная с 29 июля 2026 года с выпуском Marketing API v26.0 разработчики больше не смогут прикреплять к объявлениям в кампаниях, использующих в качестве места получения конверсий "Сайт и приложение", рекламные креативы с параметром applink_treatment, для которого установлено значение web_only. Это влияет на создание и обновление объявлений с помощью конечных точек POST /act_{ad-account-id}/ads и POST /{ad-id}.

Конечная точка рекламного креатива остается прежней, но значение applink_treatment теперь настраивается с помощью запроса POST /act_{ad-account-id}/adcreatives. Разработчики должны проверить свои интеграции с параметром applink_treatment=web_only и использовать автоматический выбор мест назначения или другой совместимый вариант, выбранный вручную, для кампаний с местом назначения "Сайт и приложение".

27 октября 2026 года, через 90 дней после выпуска версии 26.0, это ограничение будет применяться ко всем версиям Marketing API. Узнать больше можно в документации по объявлению и рекламному креативу.

Marketing API: прекращение поддержки места размещения "Истории в Messenger"

Начиная с Marketing API версии 26.0 от 29 июля 2026 года, значение story станет недоступным в списке messenger_positions при создании или обновлении групп объявлений через вызовы версии 26.0 или более поздних.

Для этих вызовов параметр story будет безвозвратно удален из параметров таргетинга и больше не будет появляться в фактических местах размещения для новых или существующих групп объявлений. Данные о прошлых настройках таргетинга могут по-прежнему включать в себя story, если они запрашиваются с помощью GET /{ad_set-id}?fields=targeting. Система не вернет специальную ошибку, но могут возникнуть стандартные ошибки проверки места размещения, если после удаления story конфигурация места размещения будет недействительной.

Затронутые конечные точки:

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Разработчики, которые используют выбор мест размещения вручную, должны удалить story из messenger_positions. Если это единственное значение, полностью удалите поле messenger_positions. Также рассмотрите возможность удаления messenger из списка publisher_platforms, если вы не используете другие места размещения в Messenger (например, marketing_messages). При использовании мест размещения Advantage+ дополнительные действия не требуются.

Это изменение касается только API, но не Ads Manager. Вызовы без указания версии и вызовы версий до 26.0 не будут затронуты. 27 октября 2026 года, через 90 дней после выпуска версии 26.0, изменение коснется всех версий Marketing API, в том числе вызовов без указания версии.

Marketing API: поддержка создания рекламы с опросом прекращена

Начиная с Marketing API версии 26.0 от 29 июля 2026 года, компоненты опросов больше не будут поддерживаться при создании и обновлении объявлений и рекламных креативов. Поле poll_spec и значение "poll" для поля type больше не будут доступны в разделе interactive_components_spec.

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

Затронутые конечные точки:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Разработчикам нужно удалить поля, связанные с опросами, из характеристик креативов и использовать креативы без этого компонента. Вызовы более ранних версий (до 26.0) и вызовы без указания версии не будут затронуты.

27 октября 2026 года, через 90 дней после выпуска версии 26.0, изменение коснется всех версий Marketing API.

Выпуск Meta Business SDK 26

Meta Business SDK 26 будет выпущен вскоре после Graph API 26. В этот выпуск войдут обновления зависимости, интеграция конструктора параметров Conversions API, новые функции API, а также прекращение поддержки Commerce Order Management API и ряда устаревших функций протокола.

Business SDK теперь интегрирован с конструктором параметров Conversions API с открытым исходным кодом. Эта новая интеграция позволит вам улучшить качество интеграции Conversions API. Основные функции: автоматическая генерация (с ограничением согласно настройкам рекламодателей) и улучшение параметров fbc, fbp, event_source_url, referrer_url, client_ip_address, а также автоматическая нормализация/хэширование персональных данных для поддерживаемых языков. Узнать больше можно здесь. Commerce Order Management API (47 конечных точек) полностью упразднен без замены. Место размещения рекламы "Лента 'Интересное' Instagram" удалено. При его выборе будет возникать ошибка. Место размещения "Истории в Messenger" безвозвратно удалено из списка messenger_positions. Реклама в статусе WhatsApp получила новые возможности, в том числе указание идентификационных данных, кольцевую галерею с поддержкой до 10 карточек и оптимизацию для конверсий вне сайта.

Обратите внимание на предстоящие упразднения и прекращение поддержки в рамках нашего 2-летнего графика упразднения SDK платформы:

• Сентябрь 2026 года. Будет прекращена поддержка Facebook SDK версии 20.0.
• Январь 2027 года. Будет прекращена поддержка Facebook SDK версии 21.0.

Упразднение версий API

Обратите внимание на следующие упразднения в рамках графика управления версиями Graph API для Facebook:

Graph API

• 24 сентября 2026 года будет упразднена и удалена с платформы версия Graph API 20.0.
• 21 января 2027 года будет упразднена и удалена с платформы версия Graph API 21.0.

Чтобы избежать проблем, перенесите все вызовы на последнюю версию API.