Tổng quan về Merchant API

Bạn có thể sử dụng Merchant API để

  • Quản lý cách doanh nghiệp và sản phẩm của bạn xuất hiện trên Google.
  • Truy cập có lập trình vào dữ liệu, thông tin chi tiết và các tính năng độc đáo.
  • Phát triển doanh nghiệp và tiếp cận nhiều khách hàng hơn trên Google.

Merchant API có thể quản lý các tài khoản Merchant Center lớn hoặc phức tạp. Các trường hợp sử dụng điển hình bao gồm:

  • 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
  • Quản lý báo cáo tự động về hiệu suất và thông tin chi tiết về thị trường

Merchant API giúp bạn tạo và quản lý nhiều nguồn dữ liệu, nhờ đó, bạn có thể sắp xếp hiệu quả hơn cho thông tin về sản phẩm, khuyến mãi và bài đánh giá. Nhờ Merchant API, bạn có thể quản lý bổ sung các sản phẩm bên cạnh các phương thức khác để tải dữ liệu sản phẩm lên (như tệp và nguồn cấp dữ liệu tự động). Merchant API cũng giúp bạn chạy song song nhiều yêu cầu riêng lẻ.

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

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:

Trước khi bắt đầu

Để chạy yêu cầu API của người bán, bạn phải có những điều sau:

  • 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. Hãy đả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: Sử dụng dự án này để truy cập qua API vào tài khoản của bạn.

  • Đường liên kết từ tài khoản Merchant Center đến dự án trên đám mây của Google Cloud. Tạo đường liên kết bằng cách gọi phương thức Đăng ký nhà phát triển. Bạn sẽ sử dụng tài khoản này và những người dùng này để giao tiếp về việc tích hợp API, khảo sát và cơ hội.

  • Liên kết tài khoản Merchant Center với dự án trên đám mây của Google bằng cách đăng ký làm nhà phát triển. Những người dùng có vai trò nhà phát triển API sẽ nhận được thông tin liên lạc về API, trong đó có thông báo bắt buộc về dịch vụ, khảo sát dành cho nhà phát triển và các cơ hội.

Xác thực bằng Merchant API

Bạn có thể sử dụng các phương thức sau để xác thực:

  • Bạn có thể tạo mã ứng dụng khách và khoá bí mật OAuth 2.0 cho ứng dụng của mình. Sau đó, bạn có thể sử dụng mã và khoá bí mật 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 các lệnh gọi API.

Mã 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 để xác định. Ví dụ: tên tài nguyên cho một sản phẩm có thể là accounts/123456/products/en~US~sku123, trong đó 123456 là mã nhận dạng riêng biệt của tài khoản và en~US~sku123 là mã nhận dạng riêng biệ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 các 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ư list và get.

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

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

Để tạo một tài nguyên, hãy sử dụng tên tài nguyên của tài nguyên mẹ và URL này:

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 cho accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/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 Merchant API hoạt động 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à 2 cách để thực hiện lệnh gọi Merchant API:

gRPC (khuyến nghị) REST
  1. Tạo nội dung 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. Huỷ tuần tự hoá 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 nội dung đó đến máy chủ bằng HTTP 1.1.
  3. Huỷ tuần tự hoá 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 phụ đều 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 bài viết Mẫu cho Merchant API.

Nhận trợ giúp

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

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

Để 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: Chọn tuỳ chọn Gửi ý kiến phản hồi trong phần Vấn đề/Câu hỏi là gì? của biểu mẫu ý kiến phản hồi.
  • Tài liệu: Sử dụng tính năng đánh giá bằ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 một vấn đề trên kho lưu trữ GitHub cho các mã mẫu.

Bước tiếp theo

  • Để biết thông tin về khả năng tương thích ngược, hãy xem bài viết Khả năng tương thích của Content API for Shopping.

  • Để tìm hiểu thêm về các tính năng chính của Merchant API, hãy xem các hướng dẫn trong trình đơn điều hướng bên trái.

  • Để biết thông tin về các tài nguyên và dịch vụ hiện có, hãy xem tài liệu tham khảo.

Trước
Latest updates
Tiếp
Design