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 cho phé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 có thể chia sẻ thông tin đó với Google. Để xem danh sách các đối tác dữ liệu được hỗ trợ, hãy tham khảo 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 tại trang Phản hồi về nhà cung cấp dữ liệu điểm bán hàng để hiển thị sản phẩm tại cửa hàng địa phương trên Google.

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

Truy xuất trạng thái giới thiệu 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 chương trình đối tác 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 quá trình tích hợp có hoạt động như dự kiến hay không hoặc có cần thực hiện thêm hành động nào hay không.

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

Chèn kho hàng

Để chèn kho hàng, 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à mã nhận dạng duy nhất của tài khoản Merchant Center.
  • {OFFER_ID}: Mã nhận dạng duy nhất của sản phẩm.
  • {STORE_CODE}: Mã 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 giao dịch bán

Để chèn giao dịch bán, hãy sử 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 giao dịch bán.

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 cửa hàng, hãy sử 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}: Mã 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 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 giới thiệu 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}: Mã nhận dạng duy nhất của tài khoản Merchant Center.
  • {TARGETMERCHANT_ID}: Mã 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.