Руководство по Graph API Explorer

Стандартное использование

• Быстрое генерирование маркеров доступа
• Получение образцов кода для запросов
• Генерирование отладочной информации для добавления в запросы поддержки
• Тестирование запросов API с использованием настроек рабочего приложения, включая разрешения, функции и параметров в соответствии с целями использования
• Тестирование запросов API с задействованием тестового или разрабатываемого приложения, используя разрешения и функции для тестовых пользователей или тестовых данных

Требования

• Аккаунт разработчика Facebook
• Приложение, в котором вам назначена какая-либо роль, например администратора, разработчика или тестировщика

Компоненты

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

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

Чтобы получить сведения о текущем маркере, в том числе о приложении, к которому он привязан, а также обо всех разрешениях, предоставленных пользователем приложения (то есть вами), нажмите значок информации.

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

Приложение Meta

В раскрывающемся меню "Приложение Meta" в верхнем правом углу отображаются все приложения, в которых у вас имеется какая-либо роль. Выберите в нем настройки приложения, которые необходимо протестировать.

Пользователь или Страница

Раскрывающееся меню "Пользователь" или "Страница" позволяет получать и обменивать маркеры доступа приложения, пользователя или Страницы для выбранного приложения. Кроме того, с его помощью можно удалить приложение из узла пользователя, в результате чего текущий маркер доступа будет уничтожен.

Разрешения

При запросе маркера доступа пользователя по умолчанию предоставляется только одно разрешение: public_profile. В раскрывающемся меню разрешений можно выбрать разрешения для работы с данными пользователя (например, email и user_photos), Мероприятий, Групп и Страниц, например manage_pages и ads_management, а также другие разрешения, например instagram_basic и publish_video. С его помощью текущий пользователь приложения (то есть вы) может предоставить приложению те или иные разрешения. Предоставляйте только те разрешения, которые действительно нужны приложению.

Если ваше приложение все еще находится в стадии разработки, вы можете предоставить ему любые разрешения, и ваши запросы будут учитывать их для данных, которыми владеют пользователи с ролью в вашем приложении. Если же ваше приложение уже опубликовано и вы попытаетесь предоставить ему разрешение, не одобренное в процессе проверки приложения, запрос вернет ошибку.

Поле "Строка запроса"

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

Если нажать звездочку сбоку от поля запроса, запрос будет добавлен в список избранных. Чтобы посмотреть избранные запросы, нажмите значок с изображением книги.

Средство просмотра полей узла

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

Окно ответа

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

Кнопка "Получить код"

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

Кнопка "Копировать информацию об отладке"

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

Кнопка "Сохранить сеанс"

Нажмите кнопку "Сохранить сеанс", расположенную по центру внизу, чтобы сохранить состояние своего запроса, убрав из него маркер доступа. Добавьте ссылку на этот сеанс в свое обращение в службу поддержки разработчиков.

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

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

В поле строки запроса появится запрос по умолчанию:

GET https://developers.facebook.com/v19.0/me?fields=id,name

В нем запрашиваются поля id и name узла /me. Это специальный узел, который соответствует узлу /User или /Page, определяемому маркером. Поскольку вы используете маркер доступа пользователя, этот узел связан с вашим узлом пользователя.

Поля id и name являются общедоступными и возвращаются, если пользователь предоставил приложению разрешения default или public_profile. Эти разрешения заранее одобрены для всех приложений (чтобы проверить это, нажмите значок информации в поле маркера доступа), поэтому для работы этого запроса приложению не нужно предоставлять никаких дополнительных разрешений. Нажмите Получить маркер доступа и подтвердите, что хотите предоставить приложению доступ к своей общедоступной информации о пользователе.

Отправьте запрос, и в окне ответа отобразятся ваши ID пользователя внутри приложения и ваше имя.