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

На этой странице вы найдете рекомендации по планированию перехода на новый 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. Вы можете отслеживать весь процесс на обзорной странице.

   Примечание. Если вам нужно перейти на новый проект Google Cloud или управлять несколькими проектами во время переноса, ознакомьтесь со статьей Как управлять проектами Google Cloud и переходить на них.

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. Монитор.

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