Merchant API (thế hệ mới của Content API for Shopping) là một giao diện lập trình ứng dụng do Google cung cấp. Nó cho phép các nhà bán lẻ tự động hóa việc kết nối, quản lý và cập nhật dữ liệu sản phẩm trực tiếp từ hệ thống quản lý của mình (như website thương mại điện tử, ERP, CRM) lên Google Merchant Center.
 |
| Merchant API |
Thay vì phải tải lên các tệp dữ liệu (Feed) một cách thủ công, Merchant API giúp bạn đồng bộ dữ liệu theo thời gian thực: khi bạn thay đổi giá, cập nhật trạng thái còn/hết hàng trên website, thông tin đó sẽ ngay lập tức được cập nhật trên Google Shopping.
Cách tạo Merchant API để cập nhật sản phẩm lên Google Merchant Center
Để sử dụng Merchant API, bạn cần thiết lập kết nối thông qua Google Cloud Console và liên kết với tài khoản Google Merchant Center. Quy trình gồm các bước chuẩn sau:
Bước 1: Kích hoạt API trên Google Cloud Platform (GCP)
Truy cập vào
Google Cloud Console Tạo một Project (Dự án) mới (nếu chưa có) hoặc chọn một dự án hiện tại.
Vào mục API & Services > Library.
Tìm kiếm từ khóa "Merchant API" hoặc "Content API for Shopping" (phiên bản trước đó).
Nhấp vào API đó và chọn Enable (Kích hoạt).
Bước 2: Tạo Tài khoản dịch vụ (Service Account) và Khóa (Key)
Tài khoản dịch vụ đóng vai trò như một "thành viên ảo" giúp hệ thống của bạn tự động đăng nhập vào Google.
Trong giao diện GCP, vào mục IAM & Admin > Service Accounts.
Nhấp vào Create Service Account.
Điền tên tài khoản dịch vụ (ví dụ:
merchant-api-updater) và bấm Create and Continue, sau đó bấm Done.Tại danh sách Tài khoản dịch vụ, nhấp vào email của tài khoản vừa tạo.
Chuyển sang tab Keys > chọn Add Key > Create new key.
Chọn định dạng JSON và bấm Create. Một tệp
.jsonchứa private key sẽ được tải xuống máy tính của bạn. Hãy bảo mật tệp này vì nó chứa quyền truy cập.Sao chép địa chỉ email của Service Account vừa tạo (có đuôi dạng
@appspot.gserviceaccount.comhoặc@định-dạng-của-bạn.iam.gserviceaccount.com).
Bước 3: Cấp quyền cho Service Account trong Google Merchant Center
Đăng nhập vào
Google Merchant Center Nhấp vào biểu tượng Cài đặt (Bánh răng) ở góc trên bên phải > Chọn People & access (Mọi người và quyền truy cập).
Nhấp vào Add user (Thêm người dùng).
Dán địa chỉ email của Service Account đã sao chép ở Bước 2 vào.
Cấp quyền Admin (Quản trị viên) hoặc Standard (Chuẩn) để tài khoản này có đủ quyền chỉnh sửa và cập nhật sản phẩm. Sau đó bấm Invite / Add.
Bước 4: Viết code code để cập nhật sản phẩm bằng Merchant API
Sau khi có tệp JSON (thông tin xác thực) và ID của tài khoản Merchant Center (Merchant ID), bạn có thể sử dụng các thư viện ngôn ngữ lập trình được Google hỗ trợ (Python, PHP, Node.js, Java...) để gọi API.
Dưới đây là logic cơ bản bằng phương thức accounts.products.insert (hoặc products.custombatch để cập nhật hàng loạt):
Endpoint (gọi API):
https://merchantapi.googleapis.com/v1beta/accounts/{merchantId}/productsXác thực: Sử dụng tệp JSON đã tải về để cấu hình OAuth2 Client.
Thân bài viết (Body Request): Bạn gửi lên cấu trúc JSON của sản phẩm bao gồm:
offerId(Mã sản phẩm),title(Tên sản phẩm),link(Đường dẫn sản phẩm),imageLink(Ảnh sản phẩm),price(Giá sản phẩm), vàavailability(Tình trạng kho hàng:in_stockhoặcout_of_stock).
💡 Mẹo nhỏ cho bạn: Nếu website của bạn chạy trên các mã nguồn phổ biến như WordPress (WooCommerce) hoặc Shopify, bạn không cần phải tự viết code API từ đầu. Bạn có thể sử dụng các Plugin/App chính thức của Google hoặc bên thứ ba (ví dụ: Google Listings & Ads trên WooCommerce). Các công cụ này đã tích hợp sẵn Merchant API, bạn chỉ cần đăng nhập tài khoản Google là hệ thống tự động đồng bộ.
Nhận xét
Đăng nhận xét