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

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

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

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

Получить статус регистрации продавца

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

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

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

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

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

Вы можете ожидать увидеть следующий ответ:

{
 "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"
}

Дополнительные сведения см. в разделе Метод: account.lfpInventories.insert .

Вставить продажу

Чтобы вставить продажу, используйте следующий запрос:

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

Вы можете ожидать увидеть следующий ответ:

{
 "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"
}

Дополнительные сведения см. в разделе Метод: account.lfpSales.insert .

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

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

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

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{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"
}

Дополнительные сведения см. в разделе Метод: account.lfpStores.insert .

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

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

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

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

  • {accountId} : уникальный идентификатор вашей учетной записи Merchant Center.
  • {targetMerchantId} : уникальный идентификатор учетной записи, на которую вы хотите отправить уведомление.
  • {emailAddress} : адрес электронной почты учетной записи, на которую вы хотите отправить уведомление.
  • {Type} : в этом поле можно передать только строковое значение ONBOARDING_UI