Google Universal Cart: как принять корзину в своём магазине

Какой участок пути вы подключаете

В текущем UCP Cart API предусмотрено одностороннее создание и передача корзины через CreateCart. Обновление, удаление и синхронизация её содержимого между Google и магазином не поддерживаются. Для этой передачи не нужны отдельный Native checkout API, обработчики платежей и жизненный цикл заказа. Требуются UCP версии 2026-04-08 и профиль с объявленной возможностью работы с корзиной. Границы Cart API.

В задании подрядчику запишите результат обычными словами: посетитель приходит с выбранным набором в действующий магазин и продолжает оформление там. Не заменяйте эту формулировку расплывчатым «подключить AI-продажи». Она не определяет, какая часть покупки должна измениться и кто принимает работу.

Нативное оформление является отдельным вариантом: Google управляет сеансом checkout через API продавца, а покупатель вводит необходимые данные и подтверждает заказ в интерфейсе Google. У этого подключения собственные операции и требования. Как устроен Native checkout.

Поэтому сравнивайте предложения с одинаковой границей. Если задача состоит только в приёме готового набора, полноценное оформление внутри Google нельзя незаметно включать в обязательный первый этап. Оно может понадобиться позже, но требует отдельного решения. Общая ответственность за заказ и обслуживание уже разобрана в статье «Кто отвечает за AI-заказ».

Передаётся набор в момент перехода

Google накапливает товары у себя и не вызывает API магазина при каждом добавлении. Когда пользователь выбирает переход в магазин, отправляется один POST /carts со всеми накопленными позициями. В ответ магазин возвращает созданную корзину и continue_url: адрес, открывающий её на собственном сайте. Официальная последовательность передачи.

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

Отдельно договоритесь о ситуации, когда в браузере уже есть корзина. Будет ли создана самостоятельная корзина, предложено объединение или выбран другой понятный путь? В приведённой инструкции Google нет готовой политики объединения со всеми существующими корзинами вашего сайта. Это вопрос конкретной реализации, который нужно согласовать и показать, а не выводить из слова «универсальная».

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

Учебный пилот: входящий набор и прежняя корзина

Представим вымышленный магазин одежды. В Google выбраны две синие футболки размера M и одна белая кепка. В браузере магазина заранее лежит красная футболка размера L. Следующие проверки предлагаются редакцией; это не отчёт о проведённом нами тесте Google или готовой интеграции SABSUS.

1. Зафиксируйте исходные записи. Каталожный сотрудник указывает точные идентификаторы трёх вариантов, а проверяющий сохраняет исходные количества. Одного названия «футболка» недостаточно: одинаковая модель с другим размером является другим выбором.
2. Начните с пустой корзины. В разрешённой тестовой среде передайте две синие M и одну кепку. На полученной странице должны быть обе позиции и соответствующие количества. Проверка только карточки последнего товара пропустит потерю первой строки.
3. Повторите с прежним товаром. Восстановите красную L в браузере и выполните такой же переход. Если согласовано объединение, ожидается набор из двух синих M, одной кепки и одной красной L. Если выбрана отдельная корзина, проверяющий должен понимать, где осталась прежняя. Не принимайте молчаливую потерю товара за согласованное поведение.
4. Проверьте совпадающий вариант. Теперь в браузере заранее находится одна синяя M. При согласованном сложении количеств входящие две дают три, а не две и не четыре. Если реализация использует иную политику, запишите её заранее и проверьте понятность покупателю. Пример не устанавливает обязательный алгоритм Google.
5. Измените набор после перехода. На сайте магазина уменьшите две синие футболки до одной. Зафиксируйте итог именно в корзине магазина и на следующем шаге его оформления. Не записывайте обратное изменение в Google как ожидаемый результат этого подключения.
6. Разберите отказ. В согласованном тесте сделайте один вариант недоступным или используйте истёкший адрес созданной корзины, если реализация предусматривает срок. Покупатель должен увидеть понятное продолжение. Нельзя отмечать проверку пройденной, если исчезновение строки маскируется успешным переходом.

Для каждого случая сохраните исходный набор, согласованное правило, фактическую страницу и оставшуюся проблему. Результаты разрешённого тестового обмена API и реального перехода из доступного интерфейса Google фиксируйте раздельно. Работа обработчика сама по себе ещё не подтверждает, что магазин допущен в канал и покупатель может им воспользоваться.

Создание корзины также не подтверждает резерв, оплату или принятый заказ. Эти состояния проверяются дальше по собственному процессу магазина. Не дублируйте их правила в проекте передачи: используйте отдельный порядок проверки наличия, оплаты и исполнения.

Потребительский запуск и доступ магазина проверяются отдельно

Документация Merchant Center описывает постепенный запуск UCP integration hub в США и инструменты тестирования корзины и checkout. Нативное оформление доступно выбранным продавцам в ранней программе. Магазинам на сторонней платформе Google рекомендует уточнять планы интеграции у её поставщика. Текущий порядок подключения продавцов.

Перед договором попросите показать доступные возможности именно вашего аккаунта и платформы. Запишите, кто подтверждает участие, какие проверки ещё нужны и что зависит от внешней стороны. Наличие документации API или функция у покупателя не означает автоматическое подключение любого магазина. Для бизнеса вне заявленной географии сначала уточняют доступность, а затем планируют разработку.

Справка покупателя также указывает доступность Universal Cart только в США. Товары сгруппированы по продавцам; Google Pay работает у участников, для других предусмотрен переход на сайт. История и статусы заказов появляются, когда продавец передаёт соответствующие данные. По проблеме покупки покупатель обращается к продавцу. Как покупатель видит корзину и заказы.

Не обещайте общий номер заказа для всех магазинов или обязательное отслеживание каждой покупки внутри Google. Приём входящего набора и последующая передача статусов являются разными проверками. Сотрудник поддержки должен знать, по какой записи магазина искать обращение, даже если клиент начинает разговор с названия Universal Cart.

Что включить в смету и приёмку

Для POST /carts Google рекомендует ответ быстрее одной секунды, но не устанавливает обязательный SLO; превышение секунды само по себе не означает отказ передачи. Нагрузку предлагают планировать по пользовательским переходам. Рекомендации по скорости и нагрузке.

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

Открытые инструкции, приведённые здесь, не являются сметой подключения конкретной компании. Не называйте весь проект бесплатным. Запросите стоимость разработки, возможности или модуля платформы, тестирования, размещения и сопровождения; отдельно подтвердите применимые коммерческие условия канала и платёжного провайдера. Неизвестная строка остаётся неизвестной, а не нулевой.

Решение продолжать имеет смысл, когда подтверждены доступ, ответственный исполнитель и нужный покупателю переход. Итог первого этапа ограничен: согласованный набор приходит в работающую корзину, прежние позиции обрабатываются предсказуемо, ограничения понятны команде. Это не доказательство дополнительного спроса или роста конверсии. Если доступ ещё не подтверждён, разумный результат проверки — отложить внедрение, сохранив конкретный список условий.

Материал описывает возможности Google и рекомендуемую процедуру оценки. Он не подтверждает нативное подключение Universal Cart к SABSUS, не заменяет проверку выбранной конфигурации и не требует переносить действующий магазин ради нового канала.