Yerel feed'ler iş ortaklığı API'si

Yerel feed'ler iş ortaklığı programı, perakendecilerin kendi birincil feed'lerini ve yerel ürün envanteri feed'lerini oluşturmasına gerek kalmadan yerel envanter reklamlarına ve ücretsiz yerel ürün listelemelerine katılmasına olanak tanır. Perakendeciler, satış ve envanter bilgilerini Google ile paylaşabilecek güvenilir bir veri sağlayıcıya gönderebilir. Desteklenen veri iş ortaklarının listesi için Yerel feed'ler iş ortaklığı programı hakkında başlıklı makaleyi inceleyin.

Yerel ürün envanteri feed'i yükleyerek yerel ürün envanteri ekleyebilirsiniz. Yerel ürün envanteri feed'i, mağazada satılabilen öğelerin listesini, bu öğeleri açıklayan özelliklerle birlikte sağlar.

Envanter veri sağlayıcınızı Merchant Center'a eklemek için bu form üzerinden ayrıntılarını sağlayın.

Perakendecinin ilk katılım durumunu alma

Yerel feed'ler iş ortaklığı entegrasyonuyla ilgili satıcı düzeyindeki mülklerin durumunu almak için GetLfpState yöntemini kullanabilirsiniz. Sağlanan özelliklere göre entegrasyonun istenen şekilde çalışıp çalışmadığını veya ek işlem gerekip gerekmediğini kontrol edebilirsiniz.

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

Envanter ekleme

Envanter eklemek için aşağıdaki isteği kullanın:

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

Aşağıdaki yanıtı görebilirsiniz:

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

Daha fazla bilgi için Yöntem: accounts.lfpInventories.insert başlıklı makaleyi inceleyin.

İndirim ekleme

İndirim eklemek için aşağıdaki isteği kullanın:

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

Aşağıdaki yanıtı görebilirsiniz:

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

Daha fazla bilgi için Yöntem: accounts.lfpSales.insert başlıklı makaleyi inceleyin.

Mağaza ekleme

Mağaza eklemek için aşağıdaki isteği kullanın:

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

Aşağıdaki yanıtı görebilirsiniz:

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

Daha fazla bilgi için Yöntem: accounts.lfpStores.insert başlıklı makaleyi inceleyin.

Perakendecilere bildirim gönderme

Bir perakendeciye bildirim göndermek için SendLfpNotification yöntemini kullanabilirsiniz. Örneğin, perakendeciye ilk katılım bildirimi göndermek için bu yöntemi kullanabilirsiniz.

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

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

Aşağıdakini değiştirin:

  • {accountId}: Merchant Center hesabınızın benzersiz tanımlayıcısı
  • {targetMerchantId}: Bildirimi göndermek istediğiniz hesabın benzersiz tanımlayıcısı
  • {emailAddress}: Bildirimi göndermek istediğiniz hesabın e-posta adresi
  • {Type}: Bu alana yalnızca ONBOARDING_UI dize değerini iletebilirsiniz