API

---

Xác thực

Để sử dụng API Merchant Center for Shopping với một tài khoản Merchant Center cụ thể, bạn phải thiết lập dự án Bảng điều khiển API. Trợ giúp cho các dự án trên Google Cloud Console bạn quản lý quyền truy cập và xác thực API cho giải pháp API Merchant Center của mình.

Tuỳ thuộc vào trường hợp sử dụng, có 2 cách để truy cập vào API Merchant:

• Bạn nên dùng OAuth 2.0 để truy cập vào một tài khoản Merchant Center cụ thể tài khoản thông qua một ứng dụng mà bạn đã phát triển cho người dùng của mình. Người dùng sẽ cần cấp quyền truy cập vào tài khoản của bạn để gửi dữ liệu thay mặt họ.
• Tài khoản dịch vụ là một loại tài khoản đặc biệt, thường được thay vì con người. Tài khoản dịch vụ được xác định theo địa chỉ email địa chỉ email duy nhất cho tài khoản.

Tham khảo cách xác thực bằng OAuth 2.0 hoặc một dịch vụ tài khoản.

Lưu ý: Khi gửi dữ liệu với tư cách là Nhà cung cấp đối tác nguồn cấp dữ liệu địa phương, dịch vụ này email tài khoản cần được thêm vào danh sách người dùng tài khoản MCA khi cuộc gọi được xác thực thông qua tài khoản đó cho tất cả các tài khoản phụ của MCA.

Bật chế độ cài đặt quốc gia

Lưu ý quan trọng: Trước khi gửi ưu đãi mà bạn cần để bật chế độ xem cục bộ .

Gọi liasettings.update để chỉ định quốc gia nơi bạn phân phát quảng cáo tại địa phương.

Thông tin thêm về trang Mục tiêu cài đặt quốc gia

Gửi dữ liệu ưu đãi

Có hai loại dữ liệu: dữ liệu sản phẩm và dữ liệu kho hàng.

Gửi dữ liệu sản phẩm và kho hàng cùng một lúc

Bạn có thể gửi dữ liệu sản phẩm và kho hàng cùng một lúc bằng accounts.lfpInventories.insert

Trường "GTIN" sẽ hoạt động như một mã nhận dạng sản phẩm cho danh mục của Google và nguồn cấp dữ liệu sản phẩm sẽ được tạo tự động.

Nguồn cấp dữ liệu được tạo tự động này sẽ hiển thị trong Merchant Center đích dưới dạng "Nhà cung cấp nguồn cấp dữ liệu địa phương" với các sản phẩm liên quan.

Phương pháp này sẽ hiệu quả nếu tất cả sản phẩm của người bán đều có GTIN và được bật (giống như Trang chủ cửa hàng địa phương do người bán lưu trữ (cơ bản). Nếu bạn dự định bật MHLSF cho người bán, hãy gửi một nguồn cấp dữ liệu sản phẩm riêng là chế độ thiết lập bạn nên dùng.

Bạn cũng có thể thực hiện quy trình tương tự khi sử dụng accounts.lfpSales.insert

Trong trường hợp này, dữ liệu này đề cập đến Sự kiện bán hàng cho một sản phẩm cụ thể tại thời gian cụ thể.

Gửi dữ liệu sản phẩm và dữ liệu kho hàng riêng biệt

Nếu GTIN không có sẵn rộng rãi hoặc bạn muốn tận dụng nguồn cấp dữ liệu sản phẩm hiện tại trong tài khoản Merchant Center mục tiêu hoặc bạn muốn bật MHLSF cho người bán, bạn cần phải có một Nguồn cấp dữ liệu sản phẩm địa phương cụ thể.

Bạn có thể bật tính năng này bằng cách gọi accounts.productInputs.insert trước tiên rồi chèn tất cả các giá trị tĩnh của một sản phẩm. Hãy nhớ đặt Thuộc tính Channel thành "local".

Tìm hiểu thêm về dữ liệu cơ bản của sản phẩm trong bài viết này và API hướng dẫn chung về cách chèn sản phẩm.

Luồng dữ liệu sẽ như sau:

• Trước tiên, hãy gọi accounts.productInputs.insert để bắt đầu tải lên sản phẩm cho người bán của bạn
• Sau đó, hãy gọi tới accounts.lfpInventories.insert để gửi kho hàng .

Ngoài ra, dữ liệu kho hàng có thể được gửi qua accounts.lfpSales.insert. Sau đó, một mô hình học máy sẽ dự đoán giá và số lượng của sản phẩm dựa trên dữ liệu này.

Ví dụ về thông tin tổng quan về accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

Lưu ý quan trọng: Mã ưu đãi được gửi trong accounts.productInputs.insert cần phải khớp với offerId trong accounts.lfpInventories.insert để các mặt hàng được liên kết chính xác.

Quan trọng: accounts.lfpInventories.insert có gốc trong URL. Đây là tài khoản nhà cung cấp LFP của bạn do Nhóm hỗ trợ. Tài khoản Merchant Center của nhà bán lẻ của bạn có trong tải trọng yêu cầu thay vào đó được xác định là TargetMerchant. Đây là mã truy cập Merchant Center của người bán gửi kho hàng.

Lưu ý quan trọng: Dữ liệu sản phẩm sẽ hết hạn sau 30 ngày và dữ liệu kho hàng sẽ hết hạn sau 14 ngày ngày. Cách này có hiệu quả trong việc xoá các sản phẩm không mong muốn. Sản phẩm và kho hàng dữ liệu có thể được gửi cùng một lúc bằng accounts.lfpInventories.insert nếu bạn biết rõ GTIN đối với tất cả các mặt hàng. Ngoài ra, bạn có thể sử dụng accounts.productInputs.insert cho dữ liệu sản phẩm và accounts.lfpInventories.insert (hoặc accounts.lfpSales.insert) cho dữ liệu kho hàng

Gửi dữ liệu trên Trang doanh nghiệp

Trường hợp không thể truy cập vào tài khoản Trang doanh nghiệp trên Google của người bán để truy xuất mã cửa hàng, Dữ liệu cửa hàng có thể được gửi qua accounts.lfpStores.insert bằng mã cửa hàng cụ thể của riêng bạn.

Xin lưu ý rằng khi gọi accounts.lfpinventories.insert hoặc accounts.lfpSales.insert Mã cửa hàng cần phải khớp với Mã cửa hàng được cung cấp trong yêu cầu Cửa hàng lfp.

Lưu ý quan trọng: Nếu không tìm thấy cửa hàng trùng khớp, kho hàng hoặc chương trình giảm giá mà bạn gửi cùng với mã cửa hàng sẽ không được sử dụng. Để đạt được tỷ lệ khớp cao hơn, thông tin được cung cấp phải khớp chính xác với thông tin trên Google Bản đồ cho cửa hàng cụ thể đó.

Phản hồi của accounts.lfpStores.insert cũng sẽ cung cấp matchingState và matchingStateHint nếu không so khớp được.

Lưu ý: Bạn nên theo dõi các phản hồi đó để ghi lại và giải quyết các vấn đề về việc so khớp sớm hơn là sau này và tránh xây dựng những cửa hàng không trùng khớp, vì việc này sẽ không vị trí để phân phát ưu đãi.