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.
  • Nhận quyền truy cập có lập trình vào dữ liệu, thông tin chi tiết và các chức năng độc đáo.
  • Phát triển doanh nghiệp và tiếp cận thêm nhiều khách hàng 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. Sau đây là các trường hợp sử dụng điển hình:

  • Quản lý tài khoản tự động
  • Quản lý sản phẩm tự động
  • Quản lý kho hàng 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 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á một cách 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 khác như tệp và nguồn cấp dữ liệu tự động. Merchant API cũng cho phép bạn chạy song song nhiều yêu cầu riêng lẻ.

Merchant API là một phiên bản 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 một yêu cầu Merchant API, bạn phải có những thông tin 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. Đả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ảng không quảng cáo trên tài khoản này.

  • Một dự án Google Cloud: Sử dụng dự án này để có quyền truy cập API vào tài khoản của bạn.

  • Một đường liên kết từ tài khoản Merchant Center đến dự án 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 để liên lạc về việc tích hợp API, các cuộc khảo sát và cơ hội.

  • Liên kết tài khoản Merchant Center với dự án Google Cloud 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, bao gồm 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 lựa chọn 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ể dùng mã ứng dụng khách và khoá bí mật này để tạo thông tin đăng nhập 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.

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. Tên tài nguyên mẫu cho một sản phẩm có thể là accounts/123456/products/en~US~sku123, trong đó 123456 là giá trị nhận dạng riêng biệt của tài khoản và en~US~sku123 là giá trị 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 đây sẽ xoá kho hàng tại 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 khu vực 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 (nên dùng) 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. Giải tuần tự 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 mã này đến máy chủ bằng HTTP 1.1.
  3. Giải tuần tự hoá phản hồi dưới dạng một đố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. Các 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 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

Để gửi ý kiến phản hồi, hãy gửi một trong những thông tin sau:

  • Tính năng API: Chọn mục 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 phản hồi.
  • Tài liệu: Sử dụng nút đánh giá 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ã mẫu.

Bước tiếp theo

Trước
Latest updates
Tiếp
Design