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à riêng biệt để bạn kiểm tra kỹ lưỡng các mối tích hợp trước khi triển khai chúng trong một môi trường thực. Bằng cách sử dụng tài khoản kiểm thử trong 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 thực 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 kiểm thử, 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ó tài khoản Merchant Center.
  • Quyền truy cập Merchant API: Bạn phải là một người dùng đã đăng ký Merchant API.

Lợi ích của Tài khoản kiểm thử

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

  • Thiết lập đơn giản: Quá trình thiết lập tài khoản kiểm thử 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 phát hành công khai vẫn được bảo vệ và nguy cơ vi phạm chính sách trong tài khoản phát hành công khai 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 biên mà không 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 ngay ưu đãi: Tận dụng tính năng tự động miễn trừ việc xác nhận quyền sở hữu và xác minh trang chủ đối với tài khoản kiểm thử để nhanh chóng kiểm thử việc chèn ưu đãi. Theo mặc định, các mặt hàng được phê duyệt cho tài khoản thử nghiệm.
  • Mô phỏng thực tế: Môi trường 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ả thử nghiệm đáng tin cậy.
  • Quá trình di chuyển API diễn ra suôn sẻ hơn: Tài khoản thử nghiệm giúp những người di 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 có thể xác thực song song, nhờ đó, quá trình chuyển đổi diễn ra suôn sẻ và không gặp trở ngại.

Cách tạo tài khoản kiểm thử

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ã truy cập Merchant Center của bạn.
  • ACCESS_TOKEN: mã thông báo uỷ quyền để thực hiện Lệnh gọi API
  • TEST_ACCOUNT_NAME: tên của tài khoản kiểm thử. Bạn nên sử dụng những tên có ý nghĩa cho thấy rằng các tên này được dùng để kiểm thử. Ví dụ: thêm từ test vào tên tài khoản thử nghiệm.

Bạn phải điền vào các trường sau đây khi tạo tài khoản kiểm thử:

  • 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.

Một lệnh gọi thành công sẽ trả về một tài nguyên Account (Tài khoản) bao gồm accountId và tên tài nguyên duy nhất của tài khoản kiểm thử 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 kiểm thử được thiết kế để xác thực chức năng và có những 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 về số lượng tài khoản Merchant Center trên mỗi Tài khoản Google.
  • Tích hợp với hạn mức Merchant API: Theo 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 hạn mức giống như tài khoản sản xuất. Không thể tăng hạn mức cho tài khoản kiểm thử.
  • Tài khoản nâng cao: Bạn không thể tạo tài khoản kiểm thử nâng cao hoặc chuyển đổi tài khoản nâng cao thành tài khoản kiểm thử.
  • Không phân phát công khai: Dữ liệu được gửi đến tài khoản kiểm thử 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 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 dùng một số tính năng như:
  • Hạn chế về việc 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 kiểm thử: Bạn không thể thực hiện đăng ký cho tài khoản kiểm thử.

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 kiểm thử:

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