Tổng quan về Merchant API

Trang này giới thiệu về API Merchant và giải thích cách bạn có thể sử dụng API này để tự động hoá các 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à hàng tồn kho trên Merchant Center.

Bạn có thể sử dụng API Merchant để 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 API Merchant để 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 đ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ả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 sắp xếp thông tin hiệu quả hơn về các sản phẩm, chương trình khuyến mãi và bài đánh giá. Với API Người bán, 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 lên, như tệp và nguồn cấp dữ liệu tự động. API Merchant cũng hỗ trợ bạn chạy song song nhiều yêu cầu riêng lẻ.

Merchant API là 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 hợp nếu phát hiện nội dung hoặc hành vi vi phạm những chính sách này.

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

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

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

Trước khi bắt đầu

Để chạy yêu cầu API người bán, 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. Hãy đảm bảo rằng bạn có các quyền cần thiết để quản lý các sản phẩm và kho hàng trên tài khoản này.

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

Xác thực bằng API người bán

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

  • Bạn có thể tạo mã ứng dụng khách OAuth 2.0 và khoá bí mật cho ứng dụng của mình. Sau đó, mã và khoá bí mật có thể được dùng để tạo thông tin xác thực OAuth 2.0 cần thiết cho 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.

Mã tài khoản và mã nhận dạng 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ụ về tên tài nguyên 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 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

Để hoạt động 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 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 biết cách bạn có thể tạo một vùng 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ề API Merchant Center.

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

Để xem nhanh cách hoạt động của API Merchant 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. Dưới đây là 2 cách để thực hiện lệnh gọi API Merchant Center:

gRPC (nên dùng) REST
  1. Tạo phần nội dung của yêu cầu làm 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 đến vùng đệm giao thức.
  4. Diễn giải kết quả.
  1. Tạo phần nội dung yêu cầu dưới dạng đối tượng JSON.
  2. Gửi yêu cầu đến máy chủ bằng HTTP 1.1.
  3. Giải tuần tự phản hồi dưới dạng đối tượng JSON.
  4. Diễn giải kết quả.

Dùng thư viện ứng dụng và mã mẫu

Mỗi API phụ 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 API Merchant Center.

Nhận trợ giúp

Để tham khảo tài nguyên 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 beta cho phép chúng tô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. Để chia sẻ ý kiến phản hồi, hãy gửi một trong những thông tin sau:

  • Tính năng API: Gửi biểu mẫu phản hồi
  • Tài liệu: Dùng điểm xếp hạng thích 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 mã mẫu.

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

Bước tiếp theo

  • Để biết thông tin về khả năng tương thích ngược, hãy truy cập vào Content API for Shopping.

  • Để tìm hiểu thêm về các tính năng chính của API Merchant, hãy xem 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.

Tiếp
Design