API đối tác nguồn cấp dữ liệu địa phương

Chương trình đối tác nguồn cấp dữ liệu địa phương giúp nhà bán lẻ tham gia sử dụng quảng cáo kho hàng tại địa phương và trang thông tin miễn phí về sản phẩm tại địa phương mà không cần phải tạo nguồn cấp dữ liệu chính và nguồn cấp dữ liệu kho hàng tại địa phương của riêng mình. Nhà bán lẻ có thể cung cấp thông tin về doanh số bán hàng và kho hàng cho một nhà cung cấp dữ liệu đáng tin cậy. Nhà cung cấp này có thể chia sẻ thông tin đó với Google. Để biết danh sách các đối tác dữ liệu được hỗ trợ, hãy xem bài viết Giới thiệu về chương trình đối tác nguồn cấp dữ liệu địa phương.

Bạn có thể thêm kho hàng tại địa phương bằng cách tải nguồn cấp dữ liệu kho hàng tại địa phương lên.

Để thêm nhà cung cấp dữ liệu kho hàng vào Merchant Center, hãy cung cấp thông tin chi tiết của bạn tại Ý kiến phản hồi về nhà cung cấp dữ liệu tại điểm bán hàng để giới thiệu sản phẩm tại địa phương trên Google.

Để tìm hiểu về việc di chuyển từ Content API for Shopping, hãy xem bài viết Di chuyển mối quan hệ đối tác nguồn cấp dữ liệu địa phương.

Truy xuất trạng thái tham gia của nhà bán lẻ

Bạn có thể sử dụng phương thức lfpMerchantStates.get để truy xuất trạng thái của các thuộc tính ở cấp người bán liên quan đến việc tích hợp mối quan hệ đối tác với nguồn cấp dữ liệu địa phương. Dựa trên các thuộc tính được cung cấp, bạn có thể kiểm tra xem hoạt động tích hợp có diễn ra như dự kiến hay không hoặc có cần thực hiện thêm hành động nào không.

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

Chèn khoảng không quảng cáo

Để chèn một khoảng không quảng cáo, hãy sử dụng yêu cầu sau:

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

Thay thế nội dung sau:

  • {PARENT}: Định dạng là accounts/{ACCOUNT_ID}, trong đó {ACCOUNT_ID} là giá trị nhận dạng duy nhất của tài khoản Merchant Center.
  • {OFFER_ID}: Giá trị nhận dạng duy nhất của sản phẩm.
  • {STORE_CODE}: Giá trị nhận dạng của cửa hàng của người bán.
  • {TARGETMERCHANT_ID}: Mã tài khoản của doanh nghiệp mà bạn muốn gửi kho hàng.

Bạn có thể thấy phản hồi sau:

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

Để biết thêm thông tin, hãy xem Phương thức: accounts.lfpInventories.insert.

Chèn chương trình giảm giá

Để chèn một lượt bán hàng, hãy dùng yêu cầu sau:

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

Thay thế nội dung sau:

  • {TARGETMERCHANT_ID}: Mã tài khoản của doanh nghiệp để gửi thông tin bán hàng.

Bạn có thể thấy phản hồi sau:

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

Để biết thêm thông tin, hãy xem Phương thức: accounts.lfpSales.insert

Chèn cửa hàng

Để chèn một cửa hàng, hãy dùng yêu cầu sau:

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

Thay thế nội dung sau:

  • {STORE_CODE}: Giá trị nhận dạng duy nhất của cửa hàng.
  • {TARGETMERCHANT_ID}: Mã tài khoản của doanh nghiệp để gửi cửa hàng.

Bạn có thể thấy phản hồi sau:

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

Để biết thêm thông tin, hãy xem accounts.lfpStores.insert.

Gửi thông báo cho nhà bán lẻ

Bạn có thể sử dụng phương thức SendLfpNotification để gửi thông báo cho một nhà bán lẻ. Ví dụ: bạn có thể sử dụng phương thức này để gửi thông báo tham gia cho nhà bán lẻ.

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

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

Thay thế nội dung sau:

  • {ACCOUNT_ID}: Giá trị nhận dạng duy nhất của tài khoản Merchant Center.
  • {TARGETMERCHANT_ID}: Giá trị nhận dạng duy nhất của tài khoản mà bạn muốn gửi thông báo.
  • {EMAIL_ADDRESS}: Địa chỉ email của tài khoản mà bạn muốn gửi thông báo.
  • {TYPE}: Bạn chỉ có thể truyền giá trị chuỗi ONBOARDING_UI trong trường này.