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à 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 việc tự động miễn trừ yêu cầu xác minh và khai báo 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 APITEST_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ừtestvà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 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 kiểm thử:
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);
}
}
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"
}'
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 kiểm thử: Bạn có thể tạo tối đa 5 tài khoản kiểm thử 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 thực tế.
- 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ử việc di chuyển" hoặc "Tài khoản kiểm thử tích hợp".