API

---

Аутентификация

Чтобы использовать Merchant API для покупок с определенной учетной записью Merchant Center, необходимо настроить проект консоли API . Проекты Google Cloud Console помогают вам управлять доступом к API и аутентификацией для вашего решения Merchant API.

В зависимости от варианта использования существует два способа доступа к Merchant API:

• OAuth 2.0 рекомендуется для получения доступа к определенной учетной записи Merchant Center через приложение, которое вы разработали для своих пользователей. Пользователю необходимо будет предоставить доступ к вашей учетной записи, чтобы отправлять данные от своего имени.
• Учетная запись службы — это особый тип учетной записи, обычно используемый приложением, а не человеком. Учетная запись службы идентифицируется по адресу электронной почты, который является уникальным для этой учетной записи.

Узнайте, как пройти аутентификацию с помощью OAuth 2.0 или учетной записи службы .

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

Включить настройки страны

Важно: перед отправкой данных предложений вам необходимо активировать конкретную локальную программу.

Вызовите liasettings.update чтобы указать страны, в которых вы планируете работать локально.

Дополнительную информацию можно найти на странице «Целевые настройки страны».

Отправить данные предложений

Существует два типа данных: данные о продукте и данные о запасах.

Отправляйте данные о продуктах и ​​запасах одновременно

Данные о продуктах и ​​запасах можно отправить сразу, используя account.lfpInventories.insert.

Поле «GTIN» фактически будет работать как идентификатор продукта в каталоге Google, и фид продуктов будет создан автоматически.

Этот автоматически созданный фид будет отображаться в целевом Merchant Center как фид «Местный поставщик фидов» со связанными с ним соответствующими предложениями.

Этот метод хорошо работает, если все товары продавца имеют GTIN и дополнительные функции не будут включены (например, базовая витрина локального магазина, размещенная продавцом). Если вы планируете включить MHLSF для своих продавцов, рекомендуется отправлять специальный фид товаров.

Та же процедура может работать с использованием account.lfpSales.insert.

В этом случае данные относятся к событию продажи конкретного продукта в определенное время.

Отправляйте данные о продукте и запасах отдельно

Если номера GTIN не широко доступны или вы предпочитаете воспользоваться существующим фидом товаров в целевой учетной записи Merchant Center или хотите включить MHLSF для своих продавцов, вам необходимо иметь специальный фид местных товаров.

Это можно включить, сначала вызвав account.productInputs.insert и вставив все статические значения продукта. Не забудьте установить для атрибута Channel значение «local».

Узнайте больше об основных данных о товарах в этой статье и общих рекомендациях API по вставке товаров .

Поток данных следующий:

• Сначала позвонитеaccounts.productInputs.insert , чтобы начать загрузку продуктов для ваших продавцов.
• Затем вызовите account.lfpInventories.insert , чтобы отправить данные инвентаризации.

Альтернативно данные о запасах можно отправить через account.lfpSales.insert . Затем модель машинного обучения будет прогнозировать цену и количество предложений на основе этих данных.

Пример обзора для account.lfpInventories.insert,accounts.lfpSales.insertaccounts.lfpStores.insert

Важно: идентификатор OfferId, отправленный вaccounts.productInputs.insert, должен совпадать с OfferId вaccounts.lfpInventories.insert , чтобы предложения отображались правильно.

Важно: account.lfpInventories.insert имеет родительский параметр в URL-адресе. Это ваша учетная запись поставщика LFP, активированная службой поддержки. Аккаунт торгового центра вашего розничного торговца указан в полезных данных запроса, а не обозначен как TargetMerchant . Это идентификатор продавца в Merchant Center, для которого необходимо отправить инвентарь.

Ключевой момент: срок действия данных о продуктах истекает через 30 дней, а срок действия данных о запасах — через 14 дней. Это эффективно удаляет нежелательные продукты. Данные о продуктах и ​​запасах можно отправить сразу с помощью account.lfpInventories.insert , если GTIN известны для всех предложений. В качестве альтернативы вы можете использовать account.productInputs.insert для данных о продуктах иaccounts.lfpInventories.insert ( илиaccounts.lfpSales.insert ) для данных о запасах.

Отправить данные бизнес-профиля

Если невозможно получить доступ к учетной записи бизнес-профиля Google Продавца для получения кодов магазинов, данные магазина можно отправить через account.lfpStores.insert с вашими собственными кодами магазинов.

Обратите внимание, что при вызове account.lfpinventories.insert илиaccounts.lfpSales.insert Код магазина должен совпадать с Кодом магазина, указанным в запросах магазинов lfp.

Важно! Если подходящий магазин не найден, данные о запасах или продажах, представленные с кодом магазина, использоваться не будут. Для более высокого уровня соответствия предоставленная информация должна точно соответствовать информации, доступной в Картах Google для этого конкретного магазина.

Ответ account.lfpStores.insert также предоставит matchState и matchStateHint , если сопоставление не удалось.

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