Получение разрешений

Чтобы использовать конечные точки API Marketing, приложение должно получить разрешения для API Graph на нескольких уровнях.

Уровень 1. Типы приложений

Создавая приложение для Facebook, укажите, как вы планируете его использовать. Есть три варианта ответа, которые определяют тип вашего приложения: бизнес, игры и не указан. Подробнее о типах приложений см. в этом разделе.

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

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

Уровень 2. Разрешения, функции и уровни доступа

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

Уровни доступа к функциям

Уровень доступа к функциям	Описание
Стандартный доступ	Бизнес-приложения автоматически получают стандартный уровень доступа ко всем разрешениям и функциям, доступным для этого типа приложений. Это хороший вариант, если вы только начинаете работу. Наладив непрерывный производственный цикл, вы сможете запросить полный доступ к разрешениям. Этот вариант позволяет использовать неограниченное количество рекламных аккаунтов. Некоторые вызовы API недоступны на стандартном уровне, так как они могут относиться к нескольким аккаунтам или не позволяют программно определить нужный аккаунт.
Расширенный доступ	Расширенный уровень доступа предоставляется после проверки приложения и запрашивается отдельно для каждого разрешения и функции. Чтобы запросить расширенный доступ, перейдите на панель приложений, выберите свое приложение и нажмите Проверка приложения > Разрешения и функции. В таблице выберите нужные разрешения и функции, после чего в столбце Действие нажмите Запросить расширенный доступ. Можно отправить сразу несколько запросов. Выбрав все нужные варианты, нажмите кнопку Продолжить оформление запроса. Откроется мастер подачи заявки на проверку приложения. Вскоре Facebook утвердит или отклонит ваше приложение. Если мы не сможем предоставить ему стандартный уровень доступа, то сообщим об этом. Если вам предоставят расширенный доступ, то для поддержания этого статуса должны выполняться следующие условия: приложение должно успешно выполнить не менее 1500 вызовов Marketing API за последние 15 дней; количество завершившихся ошибкой вызовов Marketing API за последние 15 дней должно быть меньше 10 %.

Уровень доступа к функциям

Описание

Стандартный доступ

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

Это хороший вариант, если вы только начинаете работу. Наладив непрерывный производственный цикл, вы сможете запросить полный доступ к разрешениям. Этот вариант позволяет использовать неограниченное количество рекламных аккаунтов.

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

Расширенный доступ

Расширенный уровень доступа предоставляется после проверки приложения и запрашивается отдельно для каждого разрешения и функции.

Чтобы запросить расширенный доступ, перейдите на панель приложений, выберите свое приложение и нажмите Проверка приложения > Разрешения и функции.

В таблице выберите нужные разрешения и функции, после чего в столбце Действие нажмите Запросить расширенный доступ. Можно отправить сразу несколько запросов. Выбрав все нужные варианты, нажмите кнопку Продолжить оформление запроса. Откроется мастер подачи заявки на проверку приложения.

Вскоре Facebook утвердит или отклонит ваше приложение. Если мы не сможем предоставить ему стандартный уровень доступа, то сообщим об этом.

Если вам предоставят расширенный доступ, то для поддержания этого статуса должны выполняться следующие условия:

приложение должно успешно выполнить не менее 1500 вызовов Marketing API за последние 15 дней;
количество завершившихся ошибкой вызовов Marketing API за последние 15 дней должно быть меньше 10 %.

Для каждого уровня доступа действуют свои ограничения. Все разработчики обязаны соблюдать Условия использования Платформы Facebook и Правила для разработчиков. При ЛЮБОМ уровне доступа вызовы выполняются к рабочим данным.

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

Доступ через Ads API и стандартный доступ к управлению рекламой: сравнение

Доступ через Marketing API	Стандартный доступ к управлению рекламой	Действие
Доступ для разработки	Стандартный доступ	По умолчанию
Стандартный доступ	Расширенный доступ	Запрос применения на панели приложений

Разрешения и функции

Разрешения, которые вам нужно запросить, зависят от того, с каким API вы хотите работать.

Если приложение будет управлять только вашим собственным рекламным аккаунтом, достаточно стандартного уровня доступа и разрешений ads_read и ads_management. Если же оно будет использоваться и для чужих рекламных аккаунтов, вам потребуется расширенный доступ к разрешениям ads_read и (или) ads_management. Полный перечень доступных разрешений для бизнес-приложений см. в этом разделе.

Функции, которые нужно запросить, зависят от того, как вы планируете использовать наши API. Для управления рекламой обычно разработчики запрашивают Ads Management Standard Access. Полный перечень доступных функций для бизнес-приложений см. в этом разделе.

Чтобы получить расширенный доступ для стандартного доступа к управлению рекламой, ваше приложение должно соответствовать следующим требованиям:

приложение должно успешно выполнить не менее 1500 вызовов Marketing API за последние 15 дней;
количество завершившихся ошибкой вызовов Marketing API за последние 15 дней должно быть меньше 10 %.

Если вы управляете чужой рекламой, используйте параметр scope, чтобы запросить у соответствующего пользователя разрешение ads_management или ads_read. Ваше приложение получит доступ, когда этот пользователь нажмет Разрешить:

https://www.facebook.com/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Указывая значение YOUR_URL, добавьте в конце символ /. Пример: http://www.facebook.com/

Примеры

Ситуация	Что запрашивать
Вам нужно управлять объявлениями из рекламных аккаунтов, которые принадлежат вам или другому лицу, предоставившему вам доступ к ним.	Разрешение: `ads_management` Функция: `Ads Management Standard Access`
Вам нужно просматривать отчеты по рекламе из аккаунтов, которые принадлежат вам или другому лицу, предоставившему вам доступ к ним.	Разрешение: `ads_read` Функция: `Ads Management Standard Access`
Вам нужно просматривать отчеты по рекламе, принадлежащей определенной группе клиентов, а также читать объявления другой группы клиентов и управлять ими.	Разрешения: `ads_management` и `ads_read` Функция: `Ads Management Standard Access`

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

В таблице ниже показано, как уровень доступа влияет на функции стандартного доступа к управлению рекламой.

	Стандартный доступ	Расширенный доступ
Ограничения количества аккаунтов	Управление неограниченным количеством рекламных аккаунтов. Администраторы или разработчики приложения могут выполнять вызовы API от имени администраторов рекламных аккаунтов или рекламодателей.	Управление неограниченным количеством рекламных аккаунтов, для которых получено разрешение `ads_read` или `ads_management`.
Ограничения числа обращений	Существенное ограничение числа обращений на рекламный аккаунт. Только для разработки. Не подходит для рабочих приложений, в которых публикуется настоящая реклама.	Незначительное ограничение числа обращений на рекламный аккаунт.
Business Manager	Ограниченный доступ к Business Manager API и Product Catalog API. Business Manager нельзя применять для управления рекламными аккаунтами, разрешениями пользователей и Страницами.	Доступ ко всем возможностям Business Manager API и Product Catalog API.
Системный пользователь	Можно создать одного обычного системного пользователя и одного — с правами администратора.	Можно создать 10 обычных системных пользователей и одного — с правами администратора.
Создание страниц	Создание страниц с помощью API не поддерживается.	Создание страниц с помощью этого API не поддерживается.

Уровни доступа и стандартный доступ к управлению рекламой

Для разрешений и функций в приложениях предусмотрено два различных уровня доступа: стандартный и расширенный. Обратите внимание: термин "стандартный доступ" здесь не связан с функцией стандартного доступа к управлению рекламой. Для получения расширенного доступа для стандартного доступа к управлению рекламой приложение должно пройти проверку.

Уровень 3. Подтверждение компании

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