Sử dụng Dịch vụ truy cập Giao thức ngữ cảnh mô hình (MCP) của Merchant API để được cấp quyền truy cập vào dữ liệu và thông tin chi tiết trong Merchant Center nhằm xây dựng trải nghiệm dựa trên tác nhân và quy trình tự động mới.
Tổng quan
Dịch vụ truy cập MCP của Merchant API cung cấp một cầu nối tiêu chuẩn và an toàn cho các mô hình ngôn ngữ lớn (LLM), tác nhân và trợ lý lập trình để xây dựng và điều phối trải nghiệm dựa trên tác nhân và quy trình tự động mới dựa trên dữ liệu trong Merchant Center.
Cụ thể, dịch vụ này cho phép truy cập vào dữ liệu trong Merchant Center và các báo cáo cũng như thông tin chi tiết do Google tạo để thực hiện các thao tác chỉ đọc và thao tác ghi có giới hạn nhằm giải quyết các trường hợp sử dụng như:
- Chẩn đoán và khắc phục tình trạng sản phẩm bị từ chối
- Tạo báo cáo hiệu suất và thông tin chi tiết
- Xem xét lựa chọn sử dụng tính năng tự động cải thiện
- Tạo và tìm nạp nguồn dữ liệu
Các biện pháp kiểm soát về bảo mật và quyền truy cập
Dịch vụ truy cập MCP của Merchant API được thiết kế với ưu tiên hàng đầu là bảo mật:
- Xác thực: Việc thực thi công cụ chịu sự điều chỉnh của quy trình xác thực Merchant API tiêu chuẩn, yêu cầu có thông tin đăng nhập OAuth 2.0 hoặc tài khoản dịch vụ. Bạn nên sử dụng thông tin đăng nhập có quyền truy cập hạn chế nhất có thể.
- Tính an toàn khi thực thi: Mặc dù khả năng hiển thị công cụ không bị hạn chế đối với việc khám phá dựa trên tác nhân, nhưng việc thực thi công cụ bị hạn chế đối với thông tin đăng nhập API cụ thể của bạn.
- Biện pháp bảo vệ: Các công cụ bị giới hạn nghiêm ngặt đối với các thao tác chỉ đọc và các công cụ ghi có rủi ro thấp (ví dụ: tạo nguồn dữ liệu) như một biện pháp bảo vệ an toàn.
Điểm quan trọng cần lưu ý
Dịch vụ truy cập MCP của Merchant API là phiên bản alpha; phạm vi và các tính năng của dịch vụ này sẽ được mở rộng và có thể thay đổi.
Trước khi bắt đầu, hãy xem các hạn chế và phương pháp hay nhất sau đây:
Các thay đổi và bản phát hành
Các thay đổi có thể xảy ra mà không cần thông báo trước và sẽ được công bố trong ghi chú phát hành.
Thử nghiệm an toàn
Bạn nên thử nghiệm trước bằng tài khoản thử nghiệm hoặc tài khoản không hoạt động trước khi sử dụng các công cụ này trong môi trường thực tế.
Hạn mức dùng chung
Dịch vụ truy cập MCP của Merchant API dùng chung nhóm hạn mức với các lệnh gọi Merchant API tiêu chuẩn của bạn. Các tác nhân đang chạy có thể nhanh chóng sử dụng hết hạn mức, đặc biệt là đối với các lần tìm nạp nguồn dữ liệu. Bạn nên sử dụng tài khoản thử nghiệm để tránh làm gián đoạn dịch vụ sản xuất.
Lọc và bảo mật công cụ
Các tính năng mới, đặc biệt là các thao tác ghi, sẽ được thêm vào trong tương lai. Bạn nên định cấu hình rõ ràng ứng dụng của mình để lọc công cụ tích hợp thay vì hiển thị toàn bộ bộ công cụ.
Tóm tắt các tính năng hiện có
Bạn có thể sử dụng Dịch vụ truy cập MCP của Merchant API để thực hiện các thao tác sau theo cách dựa trên tác nhân:
- Tìm nạp trạng thái chi tiết và ngữ cảnh báo cáo cho một số sản phẩm cụ thể bằng cách sử dụng tên tài nguyên chính xác.
- Liệt kê và tìm kiếm nhiều sản phẩm.
- Truy vấn các chỉ số hiệu suất, trạng thái sản phẩm và thông tin chi tiết về các sản phẩm phổ biến, thông tin chi tiết về giá, mức độ hiển thị cạnh tranh và số liệu phân tích về chương trình tiếp thị liên kết của YouTube Shopping.
- Xác định các vấn đề ở cấp tài khoản ảnh hưởng đến khả năng hiển thị sản phẩm hoặc việc tham gia chương trình.
- Liệt kê, tạo, tìm nạp và kiểm tra trạng thái tải lên của nguồn dữ liệu.
- Liệt kê các lý do tổng hợp khiến sản phẩm bị từ chối trong kho hàng của bạn.
- Xem xét các chế độ cài đặt tự động cải thiện cho mặt hàng, hình ảnh và thông tin vận chuyển.
- Kiểm tra các khu vực đang hoạt động, các yêu cầu chưa đáp ứng và trạng thái tham gia cho các chương trình cụ thể của Merchant Center.
Bắt đầu
Để kết nối IDE, trợ lý lập trình hoặc tác nhân với Dịch vụ truy cập MCP của Merchant API, hãy cập nhật chế độ cài đặt ứng dụng MCP. Ví dụ: cập nhật tệp mcp.json cho Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code hoặc khung tác nhân tuỳ chỉnh của bạn.
Việc thiết lập Dịch vụ truy cập MCP của Merchant API tại địa phương yêu cầu có tài khoản dịch vụ. Người dùng tiêu chuẩn không được hỗ trợ OAuth cho quá trình thực thi cục bộ không có giao diện người dùng này. Bạn phải tạo tài khoản dịch vụ, tải tệp khoá riêng tư JSON xuống và cung cấp đường dẫn đến tệp đó cùng với mã truy cập Merchant Center cụ thể của bạn làm đối số.
Để biết hướng dẫn chi tiết về cách tạo và tải tài khoản dịch vụ xuống, hãy xem hướng dẫn về Tài khoản dịch vụ.
Cấu hình ứng dụng
Thiết lập cấu hình:
Antigravity
Làm theo hướng dẫn trong tài liệu về Antigravity documentation.
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Claude Desktop
Làm theo hướng dẫn trong tài liệu về Claude Desktop.
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Các trường hợp sử dụng ví dụ
Để minh hoạ cách bạn có thể tận dụng Dịch vụ truy cập MCP của Merchant API để xây dựng trải nghiệm dựa trên tác nhân và quy trình tự động, hãy xem xét các trường hợp sau:
Trường hợp 1: Chẩn đoán và khắc phục tình trạng sản phẩm bị từ chối
Bạn muốn biết lý do một sản phẩm cụ thể không xuất hiện trong kết quả trên Google Tìm kiếm.
Câu lệnh của người dùng:
"Tại sao sản phẩm có mã ưu đãi là 'offer123' của tôi bị từ chối?"
Hành vi của tác nhân với MCP:
- Tác nhân gọi
list_productshoặcget_product_by_nameđể xác định trạng thái sản phẩm. - Máy chủ MCP trả về trạng thái sản phẩm, bao gồm danh sách
issues(ví dụ: "Định dạng giá không chính xác" hoặc "Thiếu giá trị vận chuyển"). - Tác nhân phân tích các vấn đề và giải thích nguyên nhân gốc rễ cho bạn, đồng thời đề xuất cách khắc phục (ví dụ: cập nhật thông tin về giá).
Trường hợp 2: Xem xét lựa chọn sử dụng tính năng tự động cải thiện
Bạn muốn xác minh xem tính năng tự động cải thiện thông tin vận chuyển có đang hoạt động hay không.
Câu lệnh của người dùng:
"Tôi đã bật tính năng tự động cải thiện thông tin vận chuyển chưa?"
Hành vi của tác nhân với MCP:
- Tác nhân gọi
get_automatic_improvementsđể tìm nạp các chế độ cài đặt ở cấp tài khoản. - Máy chủ MCP trả về cấu hình cho biết trạng thái của các tính năng cải thiện hình ảnh, mặt hàng và thông tin vận chuyển.
- Tác nhân xác nhận rằng các tính năng cải thiện thông tin vận chuyển đang hoạt động hoặc giải thích cách bật các tính năng đó nếu chúng đang tắt.
Trường hợp 3: Tạo báo cáo hiệu suất và thông tin chi tiết
Bạn muốn nhanh chóng kiểm tra hiệu suất gần đây mà không cần di chuyển trong giao diện người dùng của Merchant Center.
Câu lệnh của người dùng:
"Cho tôi xem 5 sản phẩm hoạt động hàng đầu của tôi theo số lượt nhấp trong tuần trước."
Hành vi của tác nhân với MCP:
- Tác nhân tạo một truy vấn Ngôn ngữ truy vấn Merchant Center (MCQL)
nhắm đến bảng
product_performance_view, sắp xếp theoclicks DESCvà giới hạn ở5. - Tác nhân gọi
report_searchbằng truy vấn đã tạo. - Máy chủ MCP thực thi truy vấn đối với cơ sở dữ liệu báo cáo trực tiếp và trả về các hàng.
- Tác nhân định dạng kết quả thành một bảng Markdown rõ ràng cho bạn.
Trường hợp 4: Tạo và tìm nạp nguồn dữ liệu
Bạn muốn thêm một nguồn dữ liệu mới để tải thông tin cập nhật về sản phẩm lên.
Câu lệnh của người dùng:
"Tạo một nguồn dữ liệu bổ sung có tên là 'price-updates' cho tài khoản người bán của tôi."
Hành vi của tác nhân với MCP:
- Tác nhân gọi
create_data_sourcebằng các chế độ cài đặt đã chỉ định để đăng ký nguồn cấp dữ liệu mới. - Máy chủ MCP tạo nguồn dữ liệu và trả về tên tài nguyên duy nhất của nguồn dữ liệu đó.
- Tác nhân gọi
fetch_data_sourceđể kích hoạt quá trình tải xuống và xử lý tệp được liên kết. - Tác nhân gọi
get_file_uploadđể theo dõi tiến trình tải lên và xác nhận trạng thái xử lý thành công của các mặt hàng.
Các công cụ và nội dung mô tả về MCP
Dịch vụ truy cập MCP của Merchant API cung cấp các công cụ sau cho tác nhân của bạn:
| Công cụ MCP | Mô tả |
|---|---|
get_product_by_name |
Nhận thông tin sản phẩm cho một người bán nhất định bằng cách sử dụng tên tài nguyên sản phẩm chính xác. Trả về trạng thái sản phẩm chi tiết chứa ngữ cảnh báo cáo và các vấn đề tiềm ẩn ở cấp sản phẩm. |
list_products |
Liệt kê hoặc tìm kiếm nhiều sản phẩm cho một người bán nhất định. Trả về trạng thái sản phẩm chi tiết chứa ngữ cảnh báo cáo và các vấn đề tiềm ẩn ở cấp sản phẩm cho nhiều sản phẩm. |
report_search |
Truy vấn các bảng báo cáo để tìm nạp các chỉ số hiệu suất sản phẩm, trạng thái sản phẩm, thông tin chi tiết về giá và mức độ hiển thị cạnh tranh. Xem hướng dẫn về Báo cáo để biết thông tin chi tiết. |
list_data_sources |
Liệt kê các nguồn dữ liệu có sẵn cho một người bán nhất định. |
get_data_source |
Xem thông tin chi tiết về một nguồn dữ liệu cụ thể. |
create_data_source |
Tạo một nguồn dữ liệu mới cho một người bán nhất định. |
fetch_data_source |
Tìm nạp và xử lý tệp được liên kết với một nguồn dữ liệu cho một người bán nhất định. |
get_file_upload |
Xem trạng thái của lần tải tệp lên gần đây nhất cho một nguồn dữ liệu nhất định. |
list_accounts |
Liệt kê các tài khoản cho một người dùng nhất định. |
list_account_issues |
Liệt kê các vấn đề ở cấp tài khoản cho một người bán nhất định để xác định các vấn đề trên toàn tài khoản. |
list_programs |
Liệt kê các chương trình cho một người bán nhất định, bao gồm trạng thái tham gia, các khu vực đang hoạt động và mọi yêu cầu chưa đáp ứng. |
list_aggregate_product_statuses |
Liệt kê các vấn đề tổng hợp ở cấp sản phẩm để theo dõi tình trạng tổng thể của dữ liệu sản phẩm. |
get_automatic_improvements |
Xem các chế độ cài đặt tự động cải thiện, bao gồm thông tin cập nhật về mặt hàng, các tính năng cải thiện hình ảnh và thông tin vận chuyển. |