Начните перенос

На этой странице вы найдете рекомендации по планированию перехода на новый API и описание необходимых шагов.

Планирование переноса

1. Сопоставьте методы Content API for Shopping с методами Merchant API.

   Изучите новые методы и ресурсы, необходимые для работы с Merchant API.

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

   Ознакомьтесь со следующими ресурсами, которые помогут вам выполнить перенос:

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

3. Определите, какие вспомогательные API вы планируете перенести и реализовать.

   Определите две вещи:

   • Функции Merchant API, на которые нужно перейти
   • новые функции, которые вы хотите реализовать;

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

   Если вы не можете сразу перейти на Content API, сначала перенесите следующие вспомогательные API, учитывая их важность и сложность.

   • Аккаунты
   • Продукты
   • Что такое источники данных
   • Отчеты

Этапы перехода

1. Зарегистрируйтесь как разработчик Чтобы использовать Merchant API, необходимо связать облачный проект Google Cloud с основным аккаунтом Merchant Center. Эту процедуру нужно пройти один раз для каждого проекта Google Cloud, который вы используете с Merchant API. Вы можете отслеживать весь процесс на обзорной странице.

2. Пробуйте разные методы, чтобы быстрее освоиться. Для базового тестирования рекомендуем использовать Google APIs Explorer.

   URL запросов в Merchant API имеют следующий формат:

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. Используйте наши примеры кода и клиентские библиотеки.

   Чтобы сократить время реализации и воспользоваться преимуществами gRPC, используйте клиентские библиотеки и примеры кода.

   В руководствах есть фрагменты кода. Например, ознакомьтесь с разделом Добавление товара.

4. Протестируйте простые пути пользователя.

   Протестируйте путь пользователя для всех дочерних API и функций, которые вы планируете перенести. Цели тестирования:

   • У перенесенных ресурсов и вызовов правильные результаты ответов.
   • Доля ошибок остается низкой.

Планирование развертывания

Мы рекомендуем следующий подход:

• Реализуйте по одному дополнительному API или методу за раз.
• Внедряйте изменения постепенно, начиная с небольших сегментов бизнеса.
• Постоянно отслеживайте проблемы.

Выполните перенос

1. Начните работу с кодом, используя новые ресурсы и конечные точки.

   После первоначального тестирования и разработки плана выпуска интегрируйте Merchant API в свои рабочие процессы.

2. Монитор.

   Подготовьтесь к возможным проблемам.