Tổng quan về Merchant API

Trang này giới thiệu về Merchant API và giải thích cách bạn có thể sử dụng API này để tự động hoá nhiều quy trình công việc liên quan đến việc quản lý tài khoản, sản phẩm và khoảng không quảng cáo trên Merchant Center.

Bạn có thể sử dụng Merchant API để tiếp cận thêm khách hàng và giới thiệu sản phẩm trên Google. Bạn có thể sử dụng Merchant API để quản lý các tài khoản Merchant Center lớn hoặc phức tạp. Sau đây là một số trường hợp sử dụng thường gặp:

  • Quản lý tài khoản tự động
  • Quản lý sản phẩm tự động
  • Quản lý khoảng không quảng cáo tự động
  • Báo cáo tuỳ chỉnh

Merchant API cho phép bạn tạo và quản lý nhiều nguồn dữ liệu, giúp bạn sắp xếp thông tin về sản phẩm, chương trình khuyến mãi và bài đánh giá hiệu quả hơn. Với Merchant API, bạn có thể quản lý sản phẩm theo cách bổ sung cho các phương thức tải dữ liệu sản phẩm lên khác như tệp và nguồn cấp dữ liệu tự động.

Merchant API là một bản thiết kế lại của Content API for Shopping và bao gồm nhiều API phụ.

Nhà bán lẻ có trách nhiệm tuân thủ các chính sách về quảng cáo Mua sắm và trang thông tin miễn phí. Google Mua sắm giữ quyền thực thi các chính sách này và phản hồi thích đáng nếu phát hiện nội dung hoặc hành vi vi phạm các chính sách này.

Tính năng mới trong Merchant API

Sau đây là một số lý do để nâng cấp lên Merchant API:

Để biết thêm thông tin, hãy xem bài viết Các tính năng mới được giới thiệu trong Merchant API Beta.

Trước khi bắt đầu

Để chạy yêu cầu Merchant API, bạn phải có:

  • Tài khoản Merchant Center: Đây là tài khoản mà bạn sẽ truy vấn, cập nhật và tải dữ liệu lên. Đảm bảo rằng bạn có các quyền cần thiết để quản lý sản phẩm và kho hàng trên tài khoản này.

  • Dự án Google Cloud: Dự án này dùng để cấp quyền truy cập API vào tài khoản của bạn.

Xác thực bằng Merchant API

Bạn có thể sử dụng các tuỳ chọn sau để xác thực:

  • Bạn có thể tạo mã ứng dụng khách và mật khẩu OAuth 2.0 cho ứng dụng của mình. Sau đó, bạn có thể dùng mã ứng dụng khách và mật khẩu này để tạo thông tin xác thực OAuth 2.0 cần thiết trong các lệnh gọi API đến tài khoản Merchant Center.
  • Bạn có thể tạo một tài khoản dịch vụ và tải khoá riêng tư của tài khoản đó xuống để thực hiện lệnh gọi API.

Giá trị nhận dạng tài khoản và sản phẩm

Merchant API sử dụng tên tài nguyên thay vì mã nhận dạng để nhận dạng. Ví dụ: tên tài nguyên của một sản phẩm có thể là accounts/123456/products/online~en~US~sku123, trong đó 123456 là giá trị nhận dạng duy nhất của tài khoản và online~en~US~sku123 là giá trị nhận dạng duy nhất của sản phẩm.

Định dạng URL yêu cầu

Để thao tác trên một tài nguyên, hãy gửi yêu cầu đến URL theo định dạng sau:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

Phần :{METHOD} bị bỏ qua đối với các phương thức tiêu chuẩn như danh sách và lấy.

Ví dụ: yêu cầu sau đây sẽ xoá kho hàng theo khu vực:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Để tạo một tài nguyên mới, bạn có thể sử dụng tên tài nguyên của tài nguyên mẹ và URL sau:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Ví dụ: yêu cầu sau đây cho biết cách bạn có thể tạo một vùng mới cho accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Để biết thêm thông tin chi tiết về các dịch vụ cụ thể, hãy xem tài liệu tham khảo về Merchant API.

Bắt đầu sử dụng Merchant API

Để nhanh chóng xem cách hoạt động của Merchant API và thử tải một sản phẩm mẫu lên, hãy xem bài viết Bắt đầu sử dụng Merchant API.

Sử dụng gRPC hoặc REST

Merchant API hỗ trợ gRPC và REST. Sau đây là hai cách để thực hiện lệnh gọi Merchant API:

gRPC (nên dùng) REST
  1. Tạo nội dung của yêu cầu dưới dạng vùng đệm giao thức.
  2. Gửi nội dung yêu cầu đến máy chủ bằng HTTP/2.
  3. Giải mã phản hồi thành vùng đệm giao thức.
  4. Diễn giải kết quả.
  1. Tạo nội dung yêu cầu dưới dạng đối tượng JSON.
  2. Gửi thông tin đó đến máy chủ bằng HTTP 1.1.
  3. Tạo lại phản hồi dưới dạng đối tượng JSON.
  4. Diễn giải kết quả.

Sử dụng thư viện ứng dụng và mã mẫu

Mỗi API con có thư viện ứng dụng để giúp bạn bắt đầu. Mã mẫu có thể giúp bạn bắt đầu viết mã bằng Java, PHP và Python. Để biết thêm thông tin, hãy xem phần Mẫu cho Merchant API.

Nhận trợ giúp

Để biết thông tin về cách yêu cầu hỗ trợ, hãy xem bài viết Yêu cầu trợ giúp về Merchant API.

Gửi ý kiến phản hồi

Giai đoạn thử nghiệm này giúp chúng tôi có cơ hội thu thập và giải quyết ý kiến phản hồi của bạn trước khi phát hành công khai. Để gửi ý kiến phản hồi, hãy gửi một trong những nội dung sau:

  • Tính năng API: Gửi biểu mẫu phản hồi
  • Tài liệu: Sử dụng tính năng xếp hạng bằng biểu tượng ngón tay cái trên trang và nút Gửi ý kiến phản hồi.
  • Mẫu và thư viện: Tạo vấn đề trên kho lưu trữ GitHub cho các mẫu mã.

Để đưa ra ý kiến phản hồi chung sau khi triển khai từng nhiệm vụ, hãy sử dụng biểu mẫu phản hồi.

Bước tiếp theo

Tiếp
Thiết kế