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

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

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