API партнерства с местными фидами

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

Добавить товары из местного ассортимента можно, загрузив файл с информацией о наличии товаров в вашем регионе.

Чтобы добавить вашего поставщика данных об инвентаре в Merchant Center, укажите свои данные в разделе «Отзывы о поставщиках данных для точек продаж», чтобы отображать местные товары в Google .

Чтобы узнать о миграции с Content API for Shopping, см. раздел «Миграция партнерства по локальным фидам» .

Получить информацию о статусе подключения ритейлера к системе.

Вы можете использовать метод lfpMerchantStates.get для получения состояния свойств уровня продавца, связанных с интеграцией партнерства с локальными фидами. На основе предоставленных свойств вы можете проверить, работает ли интеграция должным образом или требуется ли какое-либо дополнительное действие.

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Внести данные в инвентарь

Для добавления товара в инвентарь используйте следующий запрос:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Замените следующее:

  • {PARENT} : Формат — accounts/ {ACCOUNT_ID} , где {ACCOUNT_ID} — уникальный идентификатор учетной записи Merchant Center.
  • {OFFER_ID} : Уникальный идентификатор продукта.
  • {STORE_CODE} : Идентификатор магазина продавца.
  • {TARGETMERCHANT_ID} : Идентификатор учетной записи компании, для которой вы хотите отправить данные об инвентаризации.

В ответ вы получите следующее:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

Для получения дополнительной информации см. Метод: accounts.lfpInventories.insert .

Вставить объявление о продаже

Для добавления продажи используйте следующий запрос:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Замените следующее:

  • {TARGETMERCHANT_ID} : Идентификатор учетной записи компании, для которой будет оформлена продажа.

В ответ вы получите следующее:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

Для получения дополнительной информации см. Метод: accounts.lfpSales.insert

Вставьте название магазина

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

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Замените следующее:

  • {STORE_CODE} : Уникальный идентификатор магазина.
  • {TARGETMERCHANT_ID} : Идентификатор учетной записи компании, для которой необходимо отправить данные магазина.

В ответ вы получите следующее:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

Для получения дополнительной информации см. accounts.lfpStores.insert .

Отправить уведомление продавцу

Для отправки уведомления продавцу можно использовать метод SendLfpNotification . Например, этот метод можно использовать для отправки уведомления о начале сотрудничества продавцу.

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

Замените следующее:

  • {ACCOUNT_ID} : Уникальный идентификатор вашей учетной записи в Merchant Center.
  • {TARGETMERCHANT_ID} : Уникальный идентификатор учетной записи, на которую вы хотите отправить уведомление.
  • {EMAIL_ADDRESS} : Адрес электронной почты учетной записи, на которую вы хотите отправить уведомление.
  • {TYPE} : В это поле можно передать только строковое значение ONBOARDING_UI .