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.

Envanter verileri sağlayıcınızın Merchant Center'a eklenmesi için Google'da yerel ürün göstermek üzere satış noktası verileri sağlayıcısı geri bildirimi sayfasında ayrıntılarınızı paylaşın.

Content API for Shopping'den geçiş hakkında bilgi edinmek için Yerel feed iş ortaklığını taşıma başlıklı makaleyi inceleyin.

Perakendecinin ilk katılım durumunu alma

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

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

Envanter ekleme

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

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

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

  • {PARENT}: Biçim accounts/{ACCOUNT_ID} şeklindedir. Burada {ACCOUNT_ID}, Merchant Center hesabının benzersiz tanımlayıcısıdır.
  • {OFFER_ID}: Ürünün benzersiz tanımlayıcısı.
  • {STORE_CODE}: Satıcının mağazasının tanımlayıcısı.
  • {TARGETMERCHANT_ID}: Envanter göndermek istediğiniz işletmenin hesap kimliği.

Aşağıdaki yanıtı alırsınız:

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

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

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

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

  • {TARGETMERCHANT_ID}: Satışın gönderileceği işletmenin hesap kimliği.

Aşağıdaki yanıtı alırsınız:

{
 "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/v1/{PARENT}/lfpStores:insert

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

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

  • {STORE_CODE}: Mağazanın benzersiz tanımlayıcısı.
  • {TARGETMERCHANT_ID}: Mağazanın gönderileceği işletmenin hesap kimliği.

Aşağıdaki yanıtı alırsınız:

{
 "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 accounts.lfpStores.insert başlıklı makaleyi inceleyin.

Perakendeciye bildirim gönderme

Bir perakendeciye bildirim göndermek için SendLfpNotification yöntemini kullanabilirsiniz. Örneğin, perakendeciye oryantasyon bildirimi göndermek için bu yöntemi kullanabilirsiniz.

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

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

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

  • {ACCOUNT_ID}: Merchant Center hesabınızın benzersiz tanımlayıcısı.
  • {TARGETMERCHANT_ID}: Bildirimi göndermek istediğiniz hesabın benzersiz tanımlayıcısı.
  • {EMAIL_ADDRESS}: Bildirimi göndermek istediğiniz hesabın e-posta adresi.
  • {TYPE}: Bu alana yalnızca dize değeri ONBOARDING_UI iletilebilir.