Local Feeds Partnership API

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 güvenilir bir veri sağlayıcıya gönderebilir. Bu sağlayıcı da bilgileri Google ile paylaşabilir. Desteklenen veri iş ortaklarının listesi için Yerel Feed'ler İş Ortaklığı Programı hakkında başlıklı makaleyi inceleyin.

Yerel ürün envanteri feed'i yükleyerek yerel ürün envanteri ekleyebilirsiniz.

Envanter veri sağlayıcınızın Merchant Center'a eklenmesi için bilgilerinizi Yerel ürünleri Google'da göstermek için Satış Noktası Veri Sağlayıcısı Geri Bildirimi sayfasından gönderin.

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

Perakendecinin ilk katılım durumunu alma

Yerel Feed İş Ortaklığı entegrasyonuyla ilgili satıcı düzeyindeki mülklerin durumunu almak için lfpMerchantStates.get yöntemini kullanabilirsiniz. Sağlanan özelliklere göre, entegrasyonun amaçlandığı 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": "{TARGET_MERCHANT_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ı.
  • {TARGET_MERCHANT_ID}: Envanterini göndermek istediğiniz işletmenin hesap kimliği.

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

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

Daha fazla bilgi için Method: accounts.lfpInventories.insert (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/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}"
}

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

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

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

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

Daha fazla bilgi için Method: accounts.lfpSales.insert (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": "{TARGET_MERCHANT_ID}"
}

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

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

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

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

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

Perakendeciye bildirim gönderme

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/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 ONBOARDING_UI dize değerini iletebilirsiniz.