Thiết kế API Merchant

Chúng tôi thiết kế Merchant API sao cho quen thuộc với các nhà phát triển Content API for Shopping, nhưng đơn giản và linh hoạt hơn. Sau đây là một số thông tin chi tiết về thiết kế của Merchant API.

API phụ

Merchant API là một tập hợp các API phụ. API phụ là các nhóm dịch vụ và tài nguyên có liên quan. Thiết kế này có nghĩa là bạn có thể chọn chỉ sử dụng các API phụ cần thiết cho hoạt động tích hợp riêng của mình.

Merchant API bao gồm các API phụ sau:

  • Tài khoản: Quản lý tài khoản Merchant Center trên quy mô lớn.
  • Lượt chuyển đổi: Quản lý các nguồn chuyển đổi cho tài khoản của bạn.
  • Nguồn dữ liệu: Xem và quản lý nguồn dữ liệu cho sản phẩm của bạn.
  • Giải quyết vấn đề: Nhận các vấn đề ảnh hưởng đến tài khoản của bạn và tạo một trang chẩn đoán trong ứng dụng.
  • Kho hàng: Giới thiệu sản phẩm của bạn theo cửa hàng hoặc khu vực trên Google.
  • Hợp tác về nguồn cấp dữ liệu tại địa phương: Tải nguồn cấp dữ liệu kho hàng tại địa phương lên.
  • Thông báo: Quản lý các gói thuê bao thông báo.
  • Theo dõi đơn đặt hàng: Cung cấp dữ liệu theo dõi đơn đặt hàng trước đây để cải thiện thông tin ước tính về việc vận chuyển và nâng cao trang thông tin bằng chú thích vận chuyển.
  • Sản phẩm: Quản lý dữ liệu sản phẩm, chẳng hạn như giá và tình trạng còn hàng.
  • Product Studio: Sử dụng Google Product Studio để tự động tạo hình ảnh sản phẩm và đề xuất văn bản.
  • Chương trình khuyến mãi: Tạo và quản lý chương trình khuyến mãi để giới thiệu các ưu đãi đặc biệt cho sản phẩm của bạn.
  • Quota: Kiểm tra hạn mức API của tài khoản.
  • Báo cáo: Xem dữ liệu về sản phẩm, hiệu suất và môi trường cạnh tranh của bạn trên Google.
  • Bài đánh giá: Quản lý bài đánh giá sản phẩm và người bán.

Giao thông vận tải

Cơ chế truyền tải mặc định của Merchant API là gRPC. Bạn cũng có thể sử dụng REST.

Hãy xem hướng dẫn bắt đầu nhanh để biết thêm thông tin.

Enum

Các trường enum trên Merchant API có thể sẽ hiển thị các giá trị mới trong tương lai. Mã của bạn phải được cấu trúc theo cách có thể xử lý các giá trị không được nhận dạng một cách hiệu quả. Bạn nên theo dõi sự xuất hiện của các giá trị enum không nhận dạng được và can thiệp để giữ cho mã luôn mới.

Lập phiên bản

Các API phụ được lập phiên bản riêng. Điều này có nghĩa là bạn không cần làm gì cả nếu chúng tôi cập nhật một API phụ mà bạn không sử dụng. Bạn chỉ cần cập nhật mã khi các phiên bản mới của API phụ mà bạn sử dụng được phát hành. Để biết thêm thông tin, hãy xem phần Tạo phiên bản.

Các phiên bản có đuôi "beta" có thể thay đổi hoặc bị xoá.