Обновление до последней версии API Graph
В этом руководстве описано, как подготовить приложение к тестированию различных версий API Graph и переходу на последнюю версию.
Инструмент обновления API показывает, на какие вызовы API в приложении могут повлиять изменения в новых версиях API. Вы сможете быстро узнать, какие изменения требуются для обновления до новой версии.
Влияние изменений на приложение
Инструмент обновления API показывает, как именно обновление до определенной версии API повлияет на ваше приложение. С его помощью можно посмотреть все актуальные изменения, сделанные в новой версии по сравнению с исходной.
Шаг 1. В инструменте обновления выберите приложение в раскрывающемся меню или введите его имя.
В раскрывающемся меню отображается до десяти приложений. Чтобы посмотреть приложения, которых нет в этом списке, воспользуйтесь строкой поиска в раскрывающемся меню.
Шаг 2. В раскрывающихся меню справа выберите текущую и желаемую версии.
Чтение результатов
Инструмент показывает, сколько изменений нужно внести, чтобы обновить приложение до выбранной версии. Если новая версия не повлияет на вызовы API вашего приложения, данные не возвращаются.
Методы отмечены цветом версии, которая влияет на вызов. Наведите курсор на гистограмму, чтобы просмотреть, сколько изменений есть в каждой версии. Даты, связанные с каждой версией, указывают на время, когда изменения вступят в силу во всех приложениях.
В таблице показан тип изменения (упразднение, новая функция или изменение), какие методы будут затронуты, количество вызовов, выполненных за последние семь дней, а также доля вызовов API, на которые влияет это изменение.
Ограничения
- Увидеть приложение в инструменте может только его администратор или разработчик.
- Если из текущей версии приложения не было выполнено ни одного вызова API или их было слишком мало, данные не возвращаются.
- Количество вызовов может отображаться неправильно. Вызовы API регистрируются выборочно, а затем суммируются за предыдущую неделю. Полученный результат сопоставляется с общим количеством вызовов, чтобы понять, на сколько вызовов может повлиять изменение версии.
Примечание. Не все изменения могут влиять на каждый вызов API. Постарайтесь сами понять, насколько то или иное изменение влияет на работу вашего приложения. Не забудьте протестировать вызовы API в новой версии, чтобы убедиться в ее работоспособности.
Внедрение новой версии
На Панели приложений выберите Настройки > Дополнительно и прокрутите страницу до раздела Повысить версию API.
Обновление для разработчиков и администраторов
Переводит всех разработчиков и администраторов приложения на следующую версию. Это позволяет протестировать изменения на небольшом подмножестве реальных пользователей, прежде чем делать новую версию общедоступной.
Обновление всех вызовов
Переводит все вызовы из приложения на следующую версию. Преимущество раннего обновления заключается в том, что в случае непредвиденных ошибок и проблем можно будет вернуться к исходной версии.
Статьи по теме
- Журнал изменений API Graph — узнайте об изменениях в последней версии.
- Управление версиями — узнайте об управлении версиями API Graph, запросах к различным версиям и не только.
- Тестовые приложения — узнайте, как создавать приложения для тестирования изменений, прежде чем делать приложение общедоступным.
- Тестовые пользователи — узнайте, как создавать пользователей для тестирования изменений в приложении, прежде чем делать его общедоступным.