Dịch vụ truy cập MCP Merchant API (Alpha)

Sử dụng Dịch vụ truy cập Giao thức ngữ cảnh mô hình (MCP) Merchant API để có quyền truy cập được uỷ quyền 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 công việc tự động mới.

Tổng quan

Merchant API MCP Access Service cung cấp một cầu nối an toàn, được tiêu chuẩn hoá cho các LLM, tác nhân và trợ lý lập trình để xây dựng và điều phối các trải nghiệm mới dựa trên tác nhân và quy trình làm việc tự động dựa trên dữ liệu của Merchant Center.

Cụ thể, API này cho phép truy cập được uỷ quyền vào dữ liệu Merchant Center, báo cáo và thông tin chi tiết do Google tạo để thực hiện các thao tác chỉ đọc và 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 trường hợp 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 chế độ kiểm soát về an toàn và quyền truy cập

Dịch vụ truy cập MCP của Merchant API được thiết kế chú trọng đến tính bảo mật:

• Xác thực: Việc thực thi công cụ chịu sự chi phối của quy trình xác thực API Merchant tiêu chuẩn, yêu cầu thông tin xác thực 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ể.
• Độ 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 tính năng khám phá dựa trên tác nhân, nhưng việc thực thi công cụ sẽ 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ụ chỉ được phép thực hiện 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 ý

Merchant API MCP Access Service là phiên bản alpha; phạm vi và các chức năng của phiên bản 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:

Thay đổi và phát hành

Các thay đổi có thể diễn 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

Trước khi sử dụng các công cụ này trong môi trường sản xuất thực tế, 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.

Hạn mức dùng chung

Dịch vụ Merchant API MCP Access 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 hết hạn mức, đặc biệt là đối với các lượt tìm nạp nguồn dữ liệu. Bạn nên sử dụng tài khoản kiểm thử để tránh làm gián đoạn dịch vụ sản xuất.

Lọc công cụ và đảm bảo an toàn

Các chức 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 khách 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 chức năng hiện có

Bạn có thể sử dụng Merchant API MCP Access Service để thực hiện các thao tác sau theo cách có sự hỗ trợ của tác nhân:

• Truy xuất trạng thái và ngữ cảnh báo cáo chi tiết cho các 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.
• Chỉ số hiệu suất của cụm từ tìm kiếm, 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á, khả năng hiển thị so với đối 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 Mua sắm.
• 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.
• Xem xét chế độ cài đặt cải thiện tự động 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 của các chương trình cụ thể trong 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 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.

Chế độ thiết lập Dịch vụ truy cập MCP của Merchant API tại địa phương yêu cầu phải có tài khoản dịch vụ. Không hỗ trợ OAuth người dùng tiêu chuẩn cho hoạt động thực thi cục bộ không cần giao diện này. Bạn phải tạo một 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ã Merchant Center cụ thể của bạn dưới dạng đố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:

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Ví dụ về các trường hợp sử dụng

Để minh hoạ cách bạn có thể tận dụng Dịch vụ truy cập MCP Merchant API để tạo trải nghiệm dựa trên tác nhân và quy trình công việc tự động, hãy xem xét các tình huống sau:

Tình huống 1: Chẩn đoán và khắc phục trường hợp 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 "offer123" của tôi bị từ chối?"

Hành vi của nhân viên hỗ trợ khi sử dụng MCP:

1. Tác nhân gọi list_products hoặc get_product_by_name để xác định trạng thái sản phẩm.
2. Máy chủ MCP trả về trạng thái sản phẩm, bao gồm cả danh sách issues (ví dụ: "Định dạng giá không chính xác" hoặc "Thiếu giá trị phí vận chuyển").
3. Nhân viên hỗ trợ sẽ 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 cải thiện tự động

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 có bật tính năng tự động cải thiện thông tin vận chuyển không?"

Hành vi của nhân viên hỗ trợ khi sử dụng MCP:

1. Tác nhân gọi get_automatic_improvements để truy xuất các chế độ cài đặt ở cấp tài khoản.
2. Máy chủ MCP trả về cấu hình cho biết trạng thái của hình ảnh, mặt hàng và thông tin vận chuyển được cải thiện.
3. Nhân viên hỗ trợ xác nhận rằng các điểm cải thiện về thông tin vận chuyển đang hoạt động hoặc giải thích cách bật các điểm này nếu chúng đang ở trạng thái 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 điều hướng giao diện người dùng Merchant Center.

Câu lệnh của người dùng:

"Cho tôi xem 5 sản phẩm hoạt động hiệu quả nhất theo số lượt nhấp trong tuần trước."

Hành vi của tác nhân với MCP:

1. Tác nhân tạo một truy vấn bằng Ngôn ngữ truy vấn Merchant Center (MCQL) nhắm đến bảng product_performance_view, sắp xếp theo clicks DESC và giới hạn ở 5.
2. Tác nhân gọi report_search bằng truy vấn đã tạo.
3. Máy chủ MCP thực thi truy vấn dựa trên cơ sở dữ liệu báo cáo trực tiếp và trả về các hàng.
4. Tác nhân sẽ định dạng kết quả thành một bảng Markdown rõ ràng cho bạn.

Tình huống 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:

1. Tác nhân gọi create_data_source bằng các chế độ cài đặt được chỉ định để đăng ký nguồn cấp dữ liệu mới.
2. 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 đó.
3. 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.
4. 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ục.

Công cụ và nội dung mô tả về MCP

Dịch vụ Merchant API MCP Access cung cấp các công cụ sau cho tác nhân của bạn: