Cấu hình từ xa đại diện cho một mẫu Cấu hình từ xa.
Mẫu Cấu hình từ xa của một dự án được đánh giá trong quá trình tìm nạp của mỗi phiên bản ứng dụng.
Lưu ý: Các mẫu máy chủ hiện hỗ trợ điều kiện về tỷ lệ phần trăm. Việc xuất bản mẫu máy chủ chứa các giá trị có điều kiện không được hỗ trợ sẽ trả về lỗi xác thực. Xem phần Cấu hình từ xa trong môi trường máy chủ để biết thêm thông tin.
Giá trị đã phân giải của một thông số được xác định như sau:
Với conditional values
tham chiếu đến true
conditions
cho thực thể ứng dụng, giá trị đã phân giải của tham số là giá trị có điều kiện có name
xuất hiện sớm nhất trong conditions list
.
Ngược lại, nếu tham số có default value
, thì giá trị đã phân giải sẽ được đặt thành giá trị mặc định.
Ngoài ra, tham số này không có giá trị và bị bỏ qua khỏi kết quả mà thực thể ứng dụng tìm nạp.
Ví dụ: giả sử chúng ta có khoá tham số fruit
, với giá trị mặc định là pear
và sơ đồ con giá trị có điều kiện {"is_ios": "apple", "is_in_20_percent":
"banana"}
, trong đó "is_ios"
và "is_20_percent"
là tên của các điều kiện trong danh sách điều kiện được sắp xếp theo thứ tự. Giá trị của fruit
sẽ đánh giá là apple
nếu is_ios
là đúng. Ngược lại, nếu is_in_20_percent
là true
, fruit
sẽ cho kết quả là banana
, và nếu is_ios
và is_in_20_percent
đều sai, thì fruit
sẽ đánh giá là pear
. Nếu không có giá trị mặc định nào được chỉ định, đồng thời is_ios
và is_in_20_percent
đều sai, thì sẽ không có giá trị nào cho fruit
được máy chủ Cấu hình từ xa trả về cho máy khách.
Sau khi mẫu Cấu hình từ xa của một dự án được xuất bản thông qua lệnh gọi projects.updateRemoteConfig
thành công, ứng dụng có thể tìm nạp các giá trị thông số này và cho người dùng thấy.
Biểu diễn JSON |
---|
{ "conditions": [ { object ( |
Trường | |
---|---|
conditions[] |
Danh sách các điều kiện được sắp xếp theo thứ tự ưu tiên giảm dần. Giá trị của các mục |
parameters |
Ánh xạ các khoá tham số với giá trị mặc định (không bắt buộc) và giá trị có điều kiện (không bắt buộc). Đối tượng chứa danh sách các cặp |
version |
Chỉ có đầu ra, ngoại trừ phiên bản |
parameterGroups |
Bản đồ tên nhóm tham số với nội dung mô tả và tham số được nhóm. Tên của một nhóm là có thể thay đổi nhưng phải là duy nhất trong số các nhóm trong cấu hình. Tên này chỉ được dài tối đa 256 ký tự và người dùng có thể đọc được. Mọi ký tự Unicode đều được cho phép. Các nhóm có danh sách các thông số cho phép người dùng API nhóm các thông số được liên kết với cùng một tính năng hoặc chủ đề lại với nhau để dễ dàng truy cập vào các tổ chức. Ví dụ: một nhóm thông số có tên "Search V2" có thể có Đối tượng chứa danh sách các cặp |
RemoteConfigCondition
Một điều kiện nhắm đến một nhóm người dùng cụ thể. Danh sách các tình trạng này tạo thành một phần của đối tượng RemoteConfig.
Biểu diễn JSON |
---|
{
"name": string,
"expression": string,
"tagColor": enum ( |
Trường | |
---|---|
name |
Bắt buộc. Tên không trống và duy nhất của điều kiện này. |
expression |
Bắt buộc. Logic của điều kiện này. Xem tài liệu về Biểu thức điều kiện để biết cú pháp dự kiến của trường này. |
tagColor |
Không bắt buộc. Màu được liên kết với điều kiện này cho mục đích hiển thị trong Bảng điều khiển của Firebase. Nếu bạn không chỉ định giá trị này hoặc để trạng thái "condition_DISPLAY_COLOR_UNSPECIFIED" xuất hiện, Play Console sẽ chọn một màu tuỳ ý để liên kết với điều kiện. |
ConditionDisplayColor
Danh sách màu được liên kết với Điều kiện cho mục đích hiển thị.
Enum | |
---|---|
CONDITION_DISPLAY_COLOR_UNSPECIFIED |
|
BLUE |
Xanh dương |
BROWN |
Nâu |
CYAN |
Lục lam |
DEEP_ORANGE |
còn gọi là "Cam đỏ" |
GREEN |
Xanh lục |
INDIGO |
Chàm |
LIME |
Vôi |
ORANGE |
Da cam |
PINK |
Màu hồng |
PURPLE |
Màu tím |
TEAL |
Màu xanh mòng két |
Thông số cấu hình từ xa
Một giá trị thông số được liên kết với khoá thông số trong google.firebase.remoteconfig.v1.RemoteConfig.parameters
.
Ở mức tối thiểu, bạn phải có mục defaultValue
hoặc conditionalValues
để tham số này có hiệu lực.
Biểu diễn JSON |
---|
{ "defaultValue": { object ( |
Trường | |
---|---|
defaultValue |
Không bắt buộc – giá trị để đặt tham số khi không có điều kiện nào được đặt tên sẽ đánh giá là |
conditionalValues |
Không bắt buộc – bản đồ ( Đối tượng chứa danh sách các cặp |
description |
Không bắt buộc. Nội dung mô tả cho Thông số này. Độ dài của biểu tượng phải nhỏ hơn hoặc bằng 256 ký tự . Mô tả có thể chứa bất kỳ ký tự Unicode nào. |
valueType |
Loại dữ liệu cho tất cả giá trị của tham số này trong phiên bản hiện tại của mẫu. Giá trị mặc định là |
RemoteConfigParameterValue
Tài nguyên RemoteConfigParameterValue chứa giá trị mà một tham số có thể có.
Biểu diễn JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp value_option . RemoteConfigParameterValue bao gồm một chuỗi (value) hoặc một boolean (use_in_app_default, đặt thành true nếu có). value_option chỉ có thể là một trong những trạng thái sau: |
|
value |
Giá trị chuỗi mà tham số được đặt. |
useInAppDefault |
Nếu đúng thì thông số này sẽ bị bỏ qua khỏi các giá trị thông số được trả về ứng dụng. |
personalizationValue |
Một giá trị động, dành riêng cho người dùng được tính khi tìm nạp cấu hình. |
rolloutValue |
Giá trị Phát hành linh động do dịch vụ Thử nghiệm ABT trong Firebase quản lý. |
Giá trị cá nhân hoá
Chứa thông tin cần thiết để tìm nạp giá trị được cá nhân hoá.
Biểu diễn JSON |
---|
{ "personalizationId": string } |
Trường | |
---|---|
personalizationId |
Giá trị nhận dạng biểu thị định nghĩa về hoạt động cá nhân hoá. Định nghĩa này dùng để phân giải giá trị tại thời điểm tìm nạp cấu hình. Bạn không thể sửa đổi giá trị do hệ thống tạo. |
Giá trị phát hành
Thông tin liên quan đến đợt Phát hành.
Biểu diễn JSON |
---|
{ "rolloutId": string, "value": string, "percent": number } |
Trường | |
---|---|
rolloutId |
Giá trị nhận dạng liên kết giá trị thông số với thử nghiệm Phát hành. |
value |
Giá trị do người dùng chỉ định sẽ được triển khai. |
percent |
Tỷ lệ phần trăm người dùng sẽ nhận được giá trị phát hành. |
Loại giá trị tham số
Các loại dữ liệu được chấp nhận cho giá trị thông số.
Enum | |
---|---|
PARAMETER_VALUE_TYPE_UNSPECIFIED |
Tổng hợp cho các giá trị enum không được nhận dạng. |
STRING |
Đại diện cho các giá trị Chuỗi. |
BOOLEAN |
Đại diện cho các giá trị Boolean ("true" hoặc "false"). |
NUMBER |
Đại diện cho cả số nguyên dương và số nguyên âm cũng như giá trị số thực. |
JSON |
Đại diện cho các giá trị JSON. |
RemoteConfigParameterGroup
Một nhóm thông số được đặt tên. Việc nhóm các thông số chỉ dành cho mục đích quản lý và không ảnh hưởng đến việc tìm nạp các giá trị thông số phía máy khách.
Biểu diễn JSON |
---|
{
"description": string,
"parameters": {
string: {
object ( |
Trường | |
---|---|
description |
Không bắt buộc. Nội dung mô tả về nhóm. Độ dài của mã này phải nhỏ hơn hoặc bằng 256 ký tự. Mô tả có thể chứa bất kỳ ký tự Unicode nào. |
parameters |
Ánh xạ các khoá tham số với giá trị mặc định (không bắt buộc) và giá trị có điều kiện (không bắt buộc) cho những thông số thuộc nhóm này. Một thông số chỉ xuất hiện một lần cho mỗi Cấu hình từ xa: một thông số chưa được nhóm xuất hiện ở cấp cao nhất; một thông số được sắp xếp trong một nhóm xuất hiện trong bản đồ thông số của nhóm đó. Đối tượng chứa danh sách các cặp |