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à tách biệt để 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 tế. Bằng cách sử dụng tài khoản thử nghiệm 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 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 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 vào 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 như sau:

• Thiết lập đơn giản: Quy trình thiết lập tài khoản thử nghiệm không phức tạp, giúp bạn nhanh chóng bắt đầu thử nghiệm 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 thực tế vẫn được bảo vệ và loại bỏ nguy cơ vi phạm chính sách trong tài khoản thực tế.
• Hiệu quả thử nghiệm: Bạn có thể thử nghiệm nhiều tình huống và trường hợp hiếm gặp mà không phải duy trì một tài khoản chính thức song song cho mục đích thử nghiệm.
• Xác thực sản phẩm ngay lập tức: Tận dụng tính năng miễn trừ tự động đối với 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 thử nghiệm việc chèn sản phẩm. Theo mặc định, các ưu đãi đượ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 của môi trường phát hành công khai đố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 suôn sẻ hơn: Tài khoản thử nghiệm giúp quá trình chuyển đổi diễn ra suôn sẻ và đáng tin cậy cho những người dùng 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ã 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 thử nghiệm. Bạn nên sử dụng tên có ý nghĩa để cho biết rằng các tên này được dùng cho mục đích thử nghiệm. Ví dụ: có từ test trong 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 thử nghiệm:

• time_zone: Múi giờ báo cáo và hiển thị của 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 Account (Tài khoản) bao gồm accountId và tên tài nguyên riêng biệ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 mã mẫu sau đây cho biết cách tạo tài khoản thử nghiệm:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.Account;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.CreateTestAccountRequest;
import com.google.type.TimeZone;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 * This class demonstrates how to create a new Merchant Center test account.
 *
 * <p>For more information refer to:
 * https://developers.google.com/merchant/api/guides/accounts/test-accounts
 */
public class CreateTestAccountSample {

  // Method to create a test account.
  public static void createTestAccount(Config config, String newAccountName) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      // The test account to be created.
      Account account =
          Account.newBuilder()
              .setAccountName(newAccountName)
              .setTimeZone(TimeZone.newBuilder().setId("Europe/Zurich"))
              .setLanguageCode("en-US")
              .build();

      // Creates parent to identify where to insert the account.
      String parent = String.format("accounts/%s", config.getAccountId());

      // Create the request message.
      CreateTestAccountRequest request =
          CreateTestAccountRequest.newBuilder().setParent(parent).setAccount(account).build();

      System.out.println("Sending Create Test Account request:");
      Account response = accountsServiceClient.createTestAccount(request);

      System.out.println("Created Test Account below:");
      System.out.println(response);
    } catch (Exception e) {
      System.err.println("Error during test account creation:");
      e.printStackTrace();
    }
  }

  // Main method to run the sample.
  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // This is the name of the new test account to be created.
    String newAccountName = "MyNewTestShop";

    createTestAccount(config, newAccountName);
  }
}
CreateTestAccountSample.java

cURL

curl -X POST \
"https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/:createTestAccount" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
 "account_name": "{TEST_ACCOUNT_NAME}",
 "time_zone": {
   "id": "America/Los_Angeles"
   },
 "language_code": "en-US"
}'

Tài khoản thử nghiệm và tài khoản phụ nâng cao

Phương thức accounts.createTestAccount luôn tạo một tài khoản thử nghiệm độc lập. Cách thiết lập hệ phân cấp tài khoản nâng cao để thử nghiệm:

1. Tạo một tài khoản thử nghiệm độc lập bằng accounts.createTestAccount.
2. Chuyển đổi tài khoản thử nghiệm độc lập đó thành tài khoản nâng cao trong Merchant Center bằng cách làm theo hướng dẫn trong bài viết Chuyển sang chế độ thiết lập tài khoản nâng cao trên trung tâm trợ giúp.
3. Tạo thêm tài khoản phụ thử nghiệm trong tài khoản thử nghiệm nâng cao bằng cách gọi accounts.createAndConfigure và chỉ định tài khoản thử nghiệm nâng cao làm nhà cung cấp accountAggregation. Mọi tài khoản phụ được tạo trong tài khoản nhà cung cấp thử nghiệm đều tự động được tạo dưới dạng tài khoản thử nghiệm (testAccount: true).

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 quy định 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 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: Xét về hạn mức API, Merchant API coi tài khoản thử nghiệm là tài khoản chính thức. Tài khoản thử nghiệm phải tuân theo hạn mức giống như tài khoản chính thức. Không thể tăng hạn mức cho tài khoản thử nghiệm.
• Chuyển đổi tài khoản và tài khoản nâng cao: Bạn không thể chuyển đổi tài khoản thông thường (tài khoản thực) – dù là tài khoản độc lập hay tài khoản nâng cao – thành tài khoản thử nghiệm, hoặc chuyển đổi tài khoản thử nghiệm thành tài khoản thực. Ngoài ra, bạn không thể trực tiếp tạo tài khoản thử nghiệm nâng cao bằng accounts.createTestAccount. Trước tiên, hãy tạo một tài khoản thử nghiệm độc lập, sau đó chuyển đổi tài khoản đó thành tài khoản nâng cao.
• 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ư 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ư:
  • Nguồn cấp dữ liệu tự động
  • Quản lý chế độ cài đặt trang chủ chẳng hạn như xác nhận quyền sở hữu và từ chối quyền sở hữu.
  • Liên kết với Trang doanh nghiệp trên Google
  • Chương trình đối tác nguồn cấp dữ liệu địa phương (LFP)
• Các quy đị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ý cho 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 trong môi trường hộp cát trước: 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 vào môi trường thực 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 cho 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ư "Thử nghiệm di chuyển" hoặc "Tài khoản thử nghiệm tích hợp".