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 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 nhiều khách hàng hơn và giới thiệu sản phẩm của mình trên Google. Bạn có thể sử dụng Merchant API để quản lý những 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 hàng tự động
  • Báo cáo tuỳ chỉnh

Merchant API giúp bạn tạo và quản lý nhiều nguồn dữ liệu, cho phé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 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:

Để 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 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 hàng trên tài khoản này.

  • Một dự án trên Google Cloud: Dự án này được dùng để truy cập API vào tài khoản của bạn.

  • Liên kết tài khoản Merchant Center với dự án Google Cloud bằng cách gọi phương thức Đăng ký nhà phát triển. Người dùng của tài khoản được liên kết sẽ nhận được thông tin liên lạc qua 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 để xác định. Tên tài nguyên mẫu cho 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 riêng biệt của tài khoản và online~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/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Để tạo một tài nguyên, 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 thấy cách bạn có thể tạo một khu vực 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 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à 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ã thông báo đó đế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 phần Yêu cầu trợ giúp về Merchant API.

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

Giai đoạn thử nghiệm 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 rộng rã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: Gửi 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.

Để đư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

Trước
Latest updates
Tiếp
Design