रिमोट कॉन्फ़िगरेशन, रिमोट कॉन्फ़िगरेशन टेंप्लेट के बारे में बताता है.
हर ऐप्लिकेशन इंस्टेंस को फ़ेच करने के दौरान, किसी प्रोजेक्ट के रिमोट कॉन्फ़िगरेशन टेंप्लेट का आकलन किया जाता है.
ध्यान दें: सर्वर टेंप्लेट में फ़िलहाल प्रतिशत की शर्तें काम करती हैं. अगर सर्वर टेंप्लेट में, शर्तें पूरी न करने वाली वैल्यू काम नहीं करती हैं, तो इसे पब्लिश करने पर पुष्टि करने से जुड़ी गड़बड़ी दिखेगी. ज़्यादा जानकारी के लिए, सर्वर एनवायरमेंट में रिमोट कॉन्फ़िगरेशन देखें.
पैरामीटर की ऐसी वैल्यू तय की जाती है जिसका समाधान किया गया है:
ऐप्लिकेशन इंस्टेंस के लिए, true
conditions
को रेफ़र करने वाली conditional values
दी गई है, जिसमें पैरामीटर से मिली वैल्यू वह कंडीशनल वैल्यू है जिसका name
, conditions list
में सबसे पुराना है.
ऐसा नहीं होने पर, अगर पैरामीटर में default value
है, तो समाधान की गई वैल्यू, डिफ़ॉल्ट वैल्यू पर सेट हो जाती है.
ऐसा नहीं होने पर, पैरामीटर की कोई वैल्यू नहीं होती. साथ ही, उसे ऐप्लिकेशन इंस्टेंस से फ़ेच किए जाने वाले नतीजे से हटा दिया जाता है.
उदाहरण के लिए, मान लें कि हमारे पास पैरामीटर कुंजी fruit
है, जिसमें डिफ़ॉल्ट वैल्यू pear
और कंडीशनल वैल्यू सबमैप {"is_ios": "apple", "is_in_20_percent":
"banana"}
है. इसमें "is_ios"
और "is_20_percent"
, क्रम वाली शर्तों की सूची में शामिल शर्तों के नाम हैं. अगर is_ios
सही है, तो fruit
की वैल्यू apple
होगी. अगर is_in_20_percent
, true
है, तो fruit
का आकलन banana
के तौर पर किया जाएगा. साथ ही, अगर is_ios
और is_in_20_percent
दोनों गलत हैं, तो fruit
का आकलन pear
के तौर पर किया जाएगा. अगर कोई डिफ़ॉल्ट वैल्यू तय नहीं की गई है और is_ios
और is_in_20_percent
दोनों गलत थे, तो रिमोट कॉन्फ़िगरेशन सर्वर से क्लाइंट को fruit
के लिए कोई वैल्यू नहीं दिखेगी.
प्रोजेक्ट का रिमोट कॉन्फ़िगरेशन टेंप्लेट सफल projects.updateRemoteConfig
कॉल के ज़रिए पब्लिश होने के बाद, क्लाइंट इन पैरामीटर वैल्यू को फ़ेच कर सकते हैं और उपयोगकर्ताओं को दिखा सकते हैं.
JSON के काेड में दिखाना |
---|
{ "conditions": [ { object ( |
फ़ील्ड | |
---|---|
conditions[] |
प्राथमिकता के हिसाब से घटते क्रम में, शर्तों की सूची.
|
parameters |
पैरामीटर कुंजियों का मैप, जो उनके वैकल्पिक डिफ़ॉल्ट वैल्यू और वैकल्पिक कंडीशनल वैल्यू पर ले जाता है. एक ऑब्जेक्ट, जिसमें |
version |
|
parameterGroups |
पैरामीटर के ग्रुप के नामों को उनके ब्यौरे और ग्रुप किए गए पैरामीटर से जोड़ने वाला मैप. ग्रुप का नाम बदला जा सकता है, लेकिन कॉन्फ़िगरेशन में मौजूद ग्रुप के लिए यह यूनीक होना चाहिए. नाम में 256 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते. इसे ऐसा होना चाहिए कि कोई भी व्यक्ति इसे आसानी से पढ़ सके. यूनिकोड की अनुमति है. ग्रुप में पैरामीटर की एक सूची होती है. इसकी मदद से, एपीआई के उपयोगकर्ता, एक ही सुविधा या थीम से जुड़े पैरामीटर का ग्रुप बना सकते हैं. ऐसा करने से, उन्हें आसानी से संगठन का ऐक्सेस दिया जा सकता है. उदाहरण के लिए, "Search V2" नाम के पैरामीटर ग्रुप में, एक ऑब्जेक्ट, जिसमें |
RemoteConfigCondition
उपयोगकर्ताओं के किसी खास ग्रुप को टारगेट करने वाली शर्त. इन शर्तों की सूची में RemoteConfig ऑब्जेक्ट का इस्तेमाल किया जाता है.
JSON के काेड में दिखाना |
---|
{
"name": string,
"expression": string,
"tagColor": enum ( |
फ़ील्ड | |
---|---|
name |
ज़रूरी है. इस शर्त का ऐसा नाम जो खाली न हो और जो यूनीक हो. |
expression |
ज़रूरी है. इस स्थिति का तर्क. इस फ़ील्ड के अनुमानित सिंटैक्स के लिए, शर्त एक्सप्रेशन से जुड़ा दस्तावेज़ देखें. |
tagColor |
ज़रूरी नहीं. इस शर्त से जुड़ा रंग, ताकि Firebase कंसोल में कॉन्टेंट दिखाया जा सके. इस मान को तय न करने या "Condition_DISPLAY_COLOR_UNSPECIFIED" न होने पर, कंसोल में शर्त के साथ जोड़ने के लिए मनमुताबिक रंग चुना जाता है. |
कंडीशनल डिसप्ले कलर
डिसप्ले के लिए शर्तों से जुड़े रंगों की सूची.
एनम्स | |
---|---|
CONDITION_DISPLAY_COLOR_UNSPECIFIED |
|
BLUE |
नीला |
BROWN |
ब्राउन |
CYAN |
हरा-नीला |
DEEP_ORANGE |
इसे "रेड ऑरेंज" भी कहा जाता है |
GREEN |
हरा |
INDIGO |
गहरा नीला |
LIME |
लाइम पत्थर |
ORANGE |
Orange |
PINK |
गुलाबी |
PURPLE |
बैंगनी |
TEAL |
हरा-नीला |
RemoteConfig पैरामीटर
google.firebase.remoteconfig.v1.RemoteConfig.parameters
में पैरामीटर कुंजी से जुड़ी पैरामीटर वैल्यू.
पैरामीटर पर असर डालने के लिए, कम से कम defaultValue
या conditionalValues
एंट्री मौजूद होनी चाहिए.
JSON के काेड में दिखाना |
---|
{ "defaultValue": { object ( |
फ़ील्ड | |
---|---|
defaultValue |
ज़रूरी नहीं - पैरामीटर को सेट करने के लिए वैल्यू, जब नाम वाली किसी भी शर्त का आकलन |
conditionalValues |
वैकल्पिक - एक ( एक ऑब्जेक्ट, जिसमें |
description |
ज़रूरी नहीं. इस पैरामीटर की जानकारी. इसमें 256 या इससे कम वर्ण होने चाहिए . ब्यौरे में कोई भी यूनिकोड वर्ण हो सकता है. |
valueType |
टेंप्लेट के मौजूदा वर्शन में, इस पैरामीटर की सभी वैल्यू का डेटा टाइप. तय न होने पर, डिफ़ॉल्ट वैल्यू |
RemoteConfig पैरामीटर वैल्यू
RemoteConfigपैरामीटरValue संसाधन में वह वैल्यू शामिल होती है जो किसी पैरामीटर में हो सकती है.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड value_option . RemoteConfig parameterValue में एक स्ट्रिंग (वैल्यू) या बूलियन (use_in_app_default, लागू होने पर 'सही' पर सेट) होता है. value_option इनमें से सिर्फ़ एक हो सकती है: |
|
value |
स्ट्रिंग की वह वैल्यू जिस पर पैरामीटर सेट किया गया है. |
useInAppDefault |
सही होने पर, पैरामीटर को क्लाइंट को वापस की जाने वाली पैरामीटर वैल्यू से हटा दिया जाता है. |
personalizationValue |
कॉन्फ़िगरेशन को फ़ेच करने के बाद, उपयोगकर्ता के हिसाब से जनरेट की जाने वाली डाइनैमिक वैल्यू. |
rolloutValue |
यह डाइनैमिक रोल आउट वैल्यू, Firebase ABT एक्सपेरिमेंट सेवा से मैनेज की जाती है. |
मनमुताबिक बनाने की वैल्यू
निजी वैल्यू फ़ेच करने के लिए ज़रूरी जानकारी होती है.
JSON के काेड में दिखाना |
---|
{ "personalizationId": string } |
फ़ील्ड | |
---|---|
personalizationId |
ऐसा आइडेंटिफ़ायर जो ऐप्लिकेशन को उपयोगकर्ता के मनमुताबिक बनाने की परिभाषा दिखाता है. इस परिभाषा का इस्तेमाल, कॉन्फ़िगरेशन फ़ेच करने के समय वैल्यू को ठीक करने के लिए किया जाता है. सिस्टम से जनरेट की गई इस वैल्यू में बदलाव नहीं किया जाना चाहिए. |
रोलआउट वैल्यू
रोल आउट से जुड़ी जानकारी.
JSON के काेड में दिखाना |
---|
{ "rolloutId": string, "value": string, "percent": number } |
फ़ील्ड | |
---|---|
rolloutId |
ऐसा आइडेंटिफ़ायर जो किसी पैरामीटर की वैल्यू को रोल आउट एक्सपेरिमेंट से जोड़ता है. |
value |
रोल आउट की जाने वाली उपयोगकर्ता की तय की गई वैल्यू. |
percent |
उन उपयोगकर्ताओं का प्रतिशत जिन्हें रोल आउट की वैल्यू मिलेगी. |
पैरामीटर वैल्यू टाइप
पैरामीटर वैल्यू के लिए स्वीकार किए जाने वाले डेटा टाइप.
एनम्स | |
---|---|
PARAMETER_VALUE_TYPE_UNSPECIFIED |
पहचान में न आने वाली enum वैल्यू के लिए कैच-ऑल. |
STRING |
स्ट्रिंग की वैल्यू दिखाता है. |
BOOLEAN |
यह बूलियन वैल्यू को दिखाता है ("सही" या "गलत"). |
NUMBER |
पॉज़िटिव और नेगेटिव इंटीजर और फ़्लोट वैल्यू, दोनों को दिखाता है. |
JSON |
JSON वैल्यू को दिखाता है. |
RemoteConfig पैरामीटर का ग्रुप
नाम वाले पैरामीटर का ग्रुप. पैरामीटर का इस्तेमाल सिर्फ़ मैनेजमेंट के लिए किया जाता है. इनसे पैरामीटर वैल्यू को क्लाइंट-साइड फ़ेच करने की प्रोसेस पर कोई असर नहीं पड़ता.
JSON के काेड में दिखाना |
---|
{
"description": string,
"parameters": {
string: {
object ( |
फ़ील्ड | |
---|---|
description |
ज़रूरी नहीं. ग्रुप के लिए जानकारी. इसमें 256 या उससे कम वर्ण होने चाहिए. ब्यौरे में कोई भी यूनिकोड वर्ण हो सकता है. |
parameters |
पैरामीटर कुंजियों का मैप, जिसमें उनकी वैकल्पिक डिफ़ॉल्ट वैल्यू शामिल हैं. साथ ही, इस ग्रुप से जुड़े पैरामीटर के लिए वैकल्पिक वैल्यू पर भी, शर्तें लागू होती हैं. हर RemoteConfig के लिए एक पैरामीटर सिर्फ़ एक बार दिखता है: किसी ग्रुप में शामिल न किया गया पैरामीटर, टॉप लेवल पर दिखता है. किसी ग्रुप में व्यवस्थित किया गया पैरामीटर, उसके ग्रुप के पैरामीटर मैप में दिखता है. एक ऑब्जेक्ट, जिसमें |