Local Feeds Partnership API

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

Вы можете добавить местный ассортимент, загрузив фид ассортимента местных товаров.

Чтобы добавить поставщика данных об ассортименте в Merchant Center, заполните форму.

Чтобы узнать, как перейти с 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": "{TARGET_MERCHANT_ID}"
}

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

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

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

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

  • {TARGET_MERCHANT_ID}: идентификатор аккаунта компании, для которой нужно отправить данные о продаже.

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

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

  • {STORE_CODE} – уникальный идентификатор магазина.
  • {TARGET_MERCHANT_ID}: идентификатор аккаунта компании, для которой нужно отправить магазин.

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "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.