Tài khoản thử nghiệm trong Merchant API

Tính năng Tài khoản thử nghiệm Merchant API cung cấp một không gian an toàn và biệt lập để bạn kiểm thử kỹ lưỡng các hoạt động tích hợp trước khi triển khai trong môi trường thực. Bằng cách sử dụng tài khoản thử nghiệm trong môi trường hộp cát, bạn có thể thử nghiệm các lệnh gọi API, xác thực mã và xác định các vấn đề tiềm ẩn ngay từ đầu trong chu kỳ phát triển mà không ảnh hưởng đến dữ liệu sản xuất, làm gián đoạn các hoạt động theo thời gian thực hoặc vô tình vi phạm chính sách của Merchant Center.

Điều kiện tiên quyết

Trước khi có thể tạo và sử dụng tài khoản thử nghiệm, hãy đảm bảo bạn đáp ứng các yêu cầu sau:

  • Tài khoản Merchant Center: Bạn phải có một tài khoản Merchant Center.
  • Quyền truy cập Merchant API: Bạn phải là người dùng đã đăng ký Merchant API.

Lợi ích của tài khoản thử nghiệm

Việc sử dụng tài khoản thử nghiệm mang lại một số lợi ích chính:

  • Thiết lập đơn giản: Quy trình thiết lập tài khoản thử nghiệm có độ phức tạp thấp, cho phép bạn nhanh chóng bắt đầu kiểm thử các tính năng và hoạt động tích hợp.
  • Tính toàn vẹn và an toàn của dữ liệu: Dữ liệu sản xuất vẫn được bảo vệ và rủi ro vi phạm chính sách trong tài khoản sản xuất sẽ bị loại bỏ.
  • Hiệu quả kiểm thử: Bạn có thể kiểm thử nhiều tình huống đa dạng và trường hợp đặc biệt mà không cần phải duy trì một tài khoản sản xuất song song cho mục đích kiểm thử.
  • Xác thực ưu đãi ngay lập tức: Tận dụng tính năng tự động miễn trừ việc xác minh và xác nhận quyền sở hữu trang chủ cho tài khoản thử nghiệm để nhanh chóng kiểm thử việc chèn ưu đãi. Theo mặc định, các ưu đãi sẽ được phê duyệt cho tài khoản thử nghiệm.
  • Mô phỏng thực tế: Môi trường này phản ánh hành vi sản xuất đối với các chức năng quan trọng như tải sản phẩm lên và quản lý khoảng không quảng cáo, đảm bảo kết quả kiểm thử đáng tin cậy.
  • Di chuyển API mượt mà hơn: Tài khoản thử nghiệm tạo điều kiện cho quá trình chuyển đổi tự tin và liền mạch đối với những người chuyển từ Content API sang Merchant API hoặc từ phiên bản API này sang phiên bản API khác bằng cách cho phép xác thực song song.

Cách tạo tài khoản thử nghiệm

Tài khoản thử nghiệm được tạo bằng một phương thức tuỳ chỉnh cụ thể trong Merchant API.

Sử dụng phương thức accounts.createTestAccount:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Thay thế nội dung sau:

  • ACCOUNT_ID: mã Merchant Center của bạn.
  • ACCESS_TOKEN: mã thông báo uỷ quyền để tạo lệnh gọi API
  • TEST_ACCOUNT_NAME: tên của tài khoản thử nghiệm. Bạn nên sử dụng những tên có ý nghĩa cho biết rằng chúng được dùng để kiểm thử. Ví dụ: đưa từ test vào tên tài khoản thử nghiệm.

Bạn phải điền các trường sau khi tạo tài khoản thử nghiệm:

  • time_zone: Múi giờ báo cáo và hiển thị cho tài khoản.
  • language_code: Mã ngôn ngữ BCP-47 cho tài khoản, chẳng hạn như en-US.

Lệnh gọi thành công sẽ trả về một tài nguyên Tài khoản bao gồm accountId và tên tài nguyên duy nhất của tài khoản thử nghiệm mới:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Các điểm hạn chế

Tài khoản thử nghiệm được thiết kế để xác thực chức năng và có các hạn chế cụ thể:

  • Số lượng tài khoản thử nghiệm: Bạn có thể tạo tối đa 5 tài khoản thử nghiệm cho mỗi Tài khoản Google. Tài khoản thử nghiệm được tính vào hạn mức mặc định của bạn về số lượng tài khoản Merchant Center cho mỗi Tài khoản Google.
  • Tích hợp với hạn mức Merchant API: Từ góc độ hạn mức API, Merchant API coi tài khoản thử nghiệm là tài khoản sản xuất. Tài khoản thử nghiệm phải tuân theo cùng hạn mức như tài khoản sản xuất. Bạn không thể tăng hạn mức cho tài khoản thử nghiệm.
  • Tài khoản nâng cao: Bạn không thể tạo tài khoản thử nghiệm nâng cao hoặc chuyển đổi tài khoản nâng cao thành tài khoản thử nghiệm.
  • Không phân phát công khai: Dữ liệu được gửi đến tài khoản thử nghiệm sẽ không bao giờ được xuất bản trên bất kỳ nền tảng nào của Google, chẳng hạn như quảng cáo trên Tìm kiếm hoặc quảng cáo Mua sắm.
  • Điểm cuối bị hạn chế: Bạn không thể sử dụng tài khoản thử nghiệm khi sử dụng một số tính năng như:
  • Hạn chế liên kết: Bạn không thể liên kết tài khoản thử nghiệm với các tài khoản Google Ads hoặc Trang doanh nghiệp trên Google khác.
  • Không đăng ký tài khoản thử nghiệm: Bạn không thể thực hiện đăng ký cho tài khoản thử nghiệm.

Các phương pháp hay nhất

Bạn nên làm theo một số phương pháp hay nhất khi sử dụng tài khoản thử nghiệm:

  • Phát triển theo phương thức hộp cát trước tiên: Luôn xác thực các tính năng tích hợp mới trong tài khoản thử nghiệm trước khi áp dụng các tính năng đó vào môi trường sản xuất.
  • Kiểm thử tích hợp tự động: Sử dụng tài khoản thử nghiệm làm môi trường ổn định để chạy kiểm thử hồi quy tự động.
  • Đặt tên tài khoản thử nghiệm: Sử dụng account_name để gợi ý mục đích của từng tài khoản thử nghiệm, chẳng hạn như "Kiểm thử di chuyển" hoặc "Tài khoản thử nghiệm tích hợp".