שינוי הגדרת התצורה מרחוק באופן פרוגרמטי

במאמר הזה נסביר איך לקרוא ולשנות את קבוצת הפרמטרים והתנאים בפורמט JSON, שנקראים תבנית Remote Config, באופן פרוגרמטי. כך תוכלו לבצע שינויים בתבניות בקצה העורפי, שאפליקציית הלקוח תוכל לאחזר באמצעות ספריית הלקוח.

באמצעות Remote Config REST API או Admin SDKs שמתוארים במדריך הזה, אפשר לעקוף את ניהול התבנית במסוף Firebase כדי לשלב שינויים ב-Remote Config ישירות בתהליכים שלכם. לדוגמה, באמצעות ממשקי API לקצה העורפי של Remote Config תוכלו:

• תזמון של Remote Config עדכונים. באמצעות קריאות API בשילוב עם משימה ב-cron, אפשר לשנות את הערכים של Remote Config לפי לוח זמנים קבוע.
• ייבוא ערכים של הגדרות באצווה כדי לעבור ביעילות מהמערכת הקניינית שלכם ל-Firebase Remote Config.

• שימוש ב-Remote Config עם Cloud Functions for Firebase, שינוי ערכים באפליקציה על סמך אירועים שמתרחשים בצד השרת. לדוגמה, אפשר להשתמש ב-Remote Config כדי לקדם תכונה חדשה באפליקציה, ולהשבית את המבצע באופן אוטומטי אחרי שמזוהה מספיק אנשים שהייתה להם אינטראקציה עם התכונה החדשה.

  

בקטעים הבאים במדריך מפורטות הפעולות שאפשר לבצע באמצעות ממשקי ה-API לקצה העורפי של Remote Config. כדי לראות קוד שמבצע את המשימות האלה דרך ה-API ל-REST, אפשר לעיין באחת מהאפליקציות לדוגמה הבאות:

• מדריך למתחילים ב-Java ל-API ל-REST של הגדרת תצורה מרחוק ב-Firebase
• מדריך למתחילים ב-Node.js ל-Firebase Remote Config REST API
• תחילת העבודה עם Firebase Remote Config API ל-REST ב-Python

שינוי של הגדרת תצורה מרחוק באמצעות Firebase Admin SDK

Admin SDK היא קבוצה של ספריות שרת שמאפשרות לכם ליצור אינטראקציה עם Firebase מסביבות בעלות הרשאות. בנוסף לביצוע עדכונים ב-Remote Config, באמצעות Admin SDK אפשר ליצור ולאמת אסימוני אימות של Firebase, לקרוא ולכתוב ב-Realtime Database וכן הלאה. למידע נוסף על הדרישות המוקדמות ועל ההגדרה של Admin SDK, ראו הוספת Firebase Admin SDK לשרת.

בתהליך Remote Config טיפוסי, יכול להיות שתקבלו את התבנית הנוכחית, תשנו חלק מהפרמטרים או התנאים וקבוצות הפרמטרים, תאמתו את התבנית ואז תפרסמו אותה. לפני שמבצעים את הקריאות האלה ל-API, צריך לאשר בקשות מה-SDK.

אתחול ה-SDK והרשאה לבקשות API

כשמפעילים את Admin SDK ללא פרמטרים, ה-SDK משתמש ב-Google Application Default Credentials וקורא אפשרויות ממשתנה הסביבה FIREBASE_CONFIG. אם התוכן של המשתנה FIREBASE_CONFIG מתחיל ב-{, הוא ינותח כאובייקט JSON. אחרת, ה-SDK יחשוב שהמחרוזת היא השם של קובץ JSON שמכיל את האפשרויות.

לדוגמה:

Node.js

const admin = require('firebase-admin');
admin.initializeApp();

Java

FileInputStream serviceAccount = new FileInputStream("service-account.json");
FirebaseOptions options = FirebaseOptions.builder()
        .setCredentials(GoogleCredentials.fromStream(serviceAccount))
        .build();
FirebaseApp.initializeApp(options);

אחזור התבנית הנוכחית של הגדרת התצורה מרחוק

כשעובדים עם תבניות Remote Config, חשוב לזכור שלכל גרסה יש משך חיים מוגבל מרגע יצירתה ועד לעדכון ההחלפה שלה: 90 יום, עם מגבלה כוללת של 300 גרסאות מאוחסנות. מידע נוסף זמין במאמר תבניות וניהול גרסאות.

אפשר להשתמש בממשקי ה-API לקצה העורפי כדי לקבל את הגרסה הפעילה הנוכחית של התבנית Remote Config בפורמט JSON.

פרמטרים וערכים של פרמטרים שנוצרו במיוחד כוריאנטים בניסוי A/B Testing לא נכללים בתבניות שיוצאו.

כדי לקבל את התבנית:

Node.js

function getTemplate() {
  var config = admin.remoteConfig();
  config.getTemplate()
      .then(function (template) {
        console.log('ETag from server: ' + template.etag);
        var templateStr = JSON.stringify(template);
        fs.writeFileSync('config.json', templateStr);
      })
      .catch(function (err) {
        console.error('Unable to get template');
        console.error(err);
      });
}

Java

Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get();
// See the ETag of the fetched template.
System.out.println("ETag from server: " + template.getETag());

טיפ: אפשר גם להוריד את התבנית הנוכחית של Remote Config ישירות מהמסוף Firebase. מידע נוסף זמין במאמר הורדה ופרסום של תבניות של הגדרת תצורה מרחוק.

שינוי הפרמטרים של Remote Config

אפשר לשנות באופן פרוגרמטי ולהוסיף פרמטרים וקבוצות פרמטרים של Remote Config. לדוגמה, לקבוצת פרמטרים קיימת שנקראת "new_menu" אפשר להוסיף פרמטר כדי לשלוט בהצגת מידע עונתי:

Node.js

function addParameterToGroup(template) {
  template.parameterGroups['new_menu'].parameters['spring_season'] = {
    defaultValue: {
      useInAppDefault: true
    },
    description: 'spring season menu visibility.',
  };
}

Java

template.getParameterGroups().get("new_menu").getParameters()
        .put("spring_season", new Parameter()
                .setDefaultValue(ParameterValue.inAppDefault())
                .setDescription("spring season menu visibility.")
        );

באמצעות ה-API תוכלו ליצור פרמטרים וקבוצות פרמטרים חדשים, או לשנות ערכי ברירת מחדל, ערכים מותנים ותיאורים. בכל המקרים, צריך לפרסם את התבנית באופן מפורש אחרי שמבצעים בה שינויים.

שינוי התנאים של Remote Config

אפשר לשנות ולהוסיף תנאים וערכים מותנים באופן פרוגרמטי של Remote Config. לדוגמה, כדי להוסיף תנאי חדש:

Node.js

function addNewCondition(template) {
  template.conditions.push({
    name: 'android_en',
    expression: 'device.os == \'android\' && device.country in [\'us\', \'uk\']',
    tagColor: 'BLUE',
  });
}

Java

template.getConditions().add(new Condition("android_en",
        "device.os == 'android' && device.country in ['us', 'uk']", TagColor.BLUE));

בכל המקרים, צריך לפרסם את התבנית באופן מפורש אחרי שמבצעים בה שינויים.

הערה: מאחר שכל ערך הוא מטבעו מחרוזת עבור Firebase Remote Config, ערכים בוליאניים מוקלדים כ-'true' ו-'false'. הם מומרים ל-boolean בצורה נכונה כשמשתמשים בשיטות getBoolean. הערכים 'True', 'False', '1' ו-'0' הם לא ייצוגים נכונים של ערכים בוליאניים עבור Firebase Remote Config.

ממשקי ה-API לקצה העורפי של Remote Config מספקים כמה תנאים ואופרטורים להשוואה, שאפשר להשתמש בהם כדי לשנות את ההתנהגות והמראה של האפליקציה. למידע נוסף על התנאים ועל האופרטורים הנתמכים בתנאים האלה, אפשר לעיין במאמר העזרה בנושא ביטויים מותנים.

אימות התבנית של Remote Config

אפשר גם לאמת את העדכונים לפני הפרסום שלהם, כפי שמוצג כאן:

Node.js

function validateTemplate(template) {
  admin.remoteConfig().validateTemplate(template)
      .then(function (validatedTemplate) {
        // The template is valid and safe to use.
        console.log('Template was valid and safe to use');
      })
      .catch(function (err) {
        console.error('Template is invalid and cannot be published');
        console.error(err);
      });
}

Java

try {
  Template validatedTemplate = FirebaseRemoteConfig.getInstance()
          .validateTemplateAsync(template).get();
  System.out.println("Template was valid and safe to use");
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Template is invalid and cannot be published");
    System.out.println(rcError.getMessage());
  }
}

תהליך האימות הזה בודק אם יש שגיאות כמו מפתחות כפולים של פרמטרים ותנאים, שמות של תנאים לא חוקיים או תנאים לא קיימים, או ETag בפורמט שגוי. לדוגמה, בקשה שמכילה יותר ממספר המפתחות המותרים – 2, 000 – תחזיר את הודעת השגיאה Param count too large.

פרסום התבנית של הגדרת התצורה מרחוק

אחרי שאתם מאחזרים תבנית ועורכים אותה עם העדכונים הרצויים, אתם יכולים לפרסם אותה. פרסום תבנית כפי שמתואר בקטע הזה מחליף את כל תבנית התצורה הקיימת בקובץ המעודכן, ולתבנית הפעילה החדשה מוקצה מספר גרסה גבוה באחד ממספר הגרסה של התבנית שהוחלפה.

במידת הצורך, אפשר להשתמש ב-API ל-REST כדי לחזור לגרסה הקודמת. כדי לצמצם את הסיכון לשגיאות בעדכון, תוכלו לבצע אימות לפני הפרסום.

ההתאמות האישיות והתנאים של Remote Config כלולים בתבניות שהורדתם, לכן חשוב לדעת על המגבלות הבאות כשמנסים לפרסם בפרויקט אחר:

• אי אפשר לייבא התאמות אישיות מפרויקט לפרויקט.

  לדוגמה, אם הפעלתם התאמה אישית בפרויקט ואתם מורידים ולערוך תבנית, תוכלו לפרסם אותה באותו פרויקט, אבל אי אפשר לפרסם אותה בפרויקט אחר אלא אם מוחקים את ההתאמות האישיות מהתבנית.

• אפשר לייבא תנאים מפרויקט לפרויקט, אבל חשוב לזכור שערכים מותנים ספציפיים (כמו מזהי אפליקציות או קהלים) צריכים להתקיים בפרויקט היעד לפני הפרסום.

  לדוגמה, אם יש לכם פרמטר Remote Config שמשתמש בתנאי שמציין ערך פלטפורמה של iOS, אפשר לפרסם את התבנית בפרויקט אחר כי ערכי הפלטפורמה זהים בכל פרויקט. עם זאת, אם הוא מכיל תנאי שמבוסס על מזהה אפליקציה ספציפי או על קהל משתמשים שלא קיים בפרויקט היעד, האימות ייכשל.

• אם התבנית שאתם מתכננים לפרסם מכילה תנאים שמסתמכים על Google Analytics, צריך להפעיל את Analytics בפרויקט היעד.

Node.js

function publishTemplate() {
  var config = admin.remoteConfig();
  var template = config.createTemplateFromJSON(
      fs.readFileSync('config.json', 'UTF8'));
  config.publishTemplate(template)
      .then(function (updatedTemplate) {
        console.log('Template has been published');
        console.log('ETag from server: ' + updatedTemplate.etag);
      })
      .catch(function (err) {
        console.error('Unable to publish template.');
        console.error(err);
      });
}

Java

try {
  Template publishedTemplate = FirebaseRemoteConfig.getInstance()
          .publishTemplateAsync(template).get();
  System.out.println("Template has been published");
  // See the ETag of the published template.
  System.out.println("ETag from server: " + publishedTemplate.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Unable to publish template.");
    System.out.println(rcError.getMessage());
  }
}

טיפ: אפשר גם לפרסם תבנית Remote Config ישירות מהמסוף Firebase. מידע נוסף זמין במאמר הורדה ופרסום של תבניות של הגדרת תצורה מרחוק.

שינוי הגדרת התצורה מרחוק באמצעות API ל-REST

בקטע הזה מתוארות היכולות העיקריות של API ל-REST של Remote Config בכתובת https://firebaseremoteconfig.googleapis.com. פרטים מלאים זמינים בהפניית ה-API.

קבלת אסימון גישה לאימות ולאישור בקשות API

פרויקטים ב-Firebase תומכים בחשבונות שירות של Google, שבאמצעותם אפשר לבצע קריאה ל-API של שרת Firebase משרת האפליקציה או מסביבה מהימנה. אם אתם מפתחים קוד באופן מקומי או פורסים את האפליקציה בארגון, תוכלו להשתמש בפרטי הכניסה שהתקבלו דרך חשבון השירות הזה כדי לאשר בקשות מהשרת.

כדי לאמת חשבון שירות ולהעניק לו הרשאת גישה לשירותי Firebase, צריך ליצור קובץ מפתח פרטי בפורמט JSON.

כדי ליצור קובץ מפתח פרטי לחשבון השירות:

1. במסוף Firebase, פותחים את Settings (הגדרות) > Service Accounts (חשבונות שירות).

2. לוחצים על Generate New Private Key (יצירת מפתח פרטי חדש) ואז על Generate Key (יצירת מפתח) כדי לאשר.

3. מאחסנים באופן מאובטח את קובץ ה-JSON שמכיל את המפתח.

הערה: לחשבון השירות שבו אתם משתמשים כדי ליצור את פרטי הכניסה צריכות להיות ההרשאות שכלולות בתפקיד 'אדמין של Firebase Remote Config'. אם פועלים לפי השלבים שלמעלה ומשתמשים בחשבון השירות Admin SDK שמוגדר כברירת מחדל ב-Firebase, ההרשאות הנדרשות Remote Config כלולות. אם רוצים לעדכן תנאים של נכסי משתמשים או קהלים באמצעות ה-API ל-REST, צריך להוסיף את ההרשאה firebaseanalytics.resources.googleAnalyticsReadAndAnalyze לתפקיד מותאם אישית.

כשאתם נותנים הרשאה דרך חשבון שירות, יש לכם שתי אפשרויות למסור את פרטי הכניסה לאפליקציה. אתם יכולים להגדיר את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS או להעביר את הנתיב למפתח של חשבון השירות בקוד באופן מפורש. האפשרות הראשונה מאובטחת יותר ומומלצת מאוד.

כדי להגדיר את משתנה הסביבה:

מגדירים את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS לנתיב של קובץ ה-JSON שמכיל את המַפְתח של חשבון השירות. המשתנה הזה חל רק על סשן המעטפת הנוכחי, כך שאם פותחים סשן חדש צריך להגדיר את המשתנה שוב.

Linux או macOS

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

באמצעות PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

אחרי שתשלימו את השלבים שלמעלה, השירות Application Default Credentials (ADC) יוכל לקבוע באופן משתמע את פרטי הכניסה שלכם, כך שתוכלו להשתמש בפרטי הכניסה של חשבון השירות בזמן בדיקה או הפעלה בסביבות שאינן של Google.

משתמשים בפרטי הכניסה ל-Firebase יחד עם ספריית האימות של Google בשפה המועדפת עליכם כדי לאחזר אסימון גישה לטווח קצר מסוג OAuth 2.0:

צומת.js

 function getAccessToken() {
  return admin.credential.applicationDefault().getAccessToken()
      .then(accessToken => {
        return accessToken.access_token;
      })
      .catch(err => {
        console.error('Unable to get access token');
        console.error(err);
      });
}
index.js

בדוגמה הזו, ספריית הלקוח של Google API מאמתת את הבקשה באמצעות אסימון אינטרנט מסוג JSON‏ (JWT). למידע נוסף, ראו אסימוני אינטרנט מסוג JSON.

Python

def _get_access_token():
  """Retrieve a valid access token that can be used to authorize requests.

  :return: Access token.
  """
  credentials = ServiceAccountCredentials.from_json_keyfile_name(
      'service-account.json', SCOPES)
  access_token_info = credentials.get_access_token()
  return access_token_info.access_token
configure.py

Java

public static String getAccessToken() throws IOException {
  GoogleCredentials googleCredentials = GoogleCredentials
          .fromStream(new FileInputStream("service-account.json"))
          .createScoped(Arrays.asList(SCOPES));
  googleCredentials.refreshAccessToken();
  return googleCredentials.getAccessToken().getTokenValue();
}
FirebaseRemoteConfigSnippets.java

אחרי שתוקף אסימון הגישה יפוג, השיטה לרענון האסימון תופעל באופן אוטומטי כדי לאחזר אסימון גישה מעודכן.

כדי לאשר גישה ל-Remote Config, צריך לבקש את ההיקף https://www.googleapis.com/auth/firebase.remoteconfig.

שינוי התבנית של Remote Config

כשעובדים עם תבניות Remote Config, חשוב לזכור שלכל גרסה יש משך חיים מוגבל מרגע יצירתה ועד לעדכון ההחלפה שלה: 90 יום, עם מגבלה כוללת של 300 גרסאות מאוחסנות. מידע נוסף זמין במאמר תבניות וניהול גרסאות.

מורידים את התבנית הנוכחית של הגדרת תצורה מרחוק

אפשר להשתמש בממשקי ה-API לקצה העורפי כדי לקבל את הגרסה הפעילה הנוכחית של התבנית Remote Config בפורמט JSON.

פרמטרים וערכים של פרמטרים שנוצרו במיוחד כוריאנטים בניסוי A/B Testing לא נכללים בתבניות שיוצאו.

משתמשים בפקודות הבאות:

cURL

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename

הפקודה הזו מפיקה את מטען ה-JSON לקובץ אחד, ואת הכותרות (כולל ה-Etag) לקובץ נפרד.

בקשת HTTP גולמית

Host: firebaseremoteconfig.googleapis.com

GET /v1/projects/my-project-id/remoteConfig HTTP/1.1
Authorization: Bearer token
Accept-Encoding: gzip

הערה: זוהי בקשת קריאה, ולכן ה-ETag מוחזר אבל לא משתנה באמצעות הפקודה הזו.

קריאת ה-API הזו מחזירה את ה-JSON הבא, יחד עם כותרת נפרדת שכוללת ETag שמשמש לבקשה הבאה.

אימות התבנית של הגדרת התצורה מרחוק

אפשר גם לאמת את העדכונים לפני הפרסום שלהם. כדי לאמת את העדכונים בתבנית, מוסיפים לבקשת הפרסום את הפרמטר ?validate_only=true של כתובת האתר. אם התשובה כוללת את קוד הסטטוס 200 ואת מזהה ה-etag המעודכן עם הסיומת -0, סימן שהעדכון אומת בהצלחה. כל תגובה שאינה 200 מציינת שנתוני ה-JSON מכילים שגיאות שצריך לתקן לפני הפרסום.

מעדכנים את התבנית של הגדרת התצורה מרחוק

אחרי שאתם מאחזרים תבנית ועורכים את תוכן ה-JSON עם העדכונים הרצויים, אתם יכולים לפרסם אותה. פרסום תבנית כפי שמתואר בקטע הזה מחליף את כל תבנית התצורה הקיימת בקובץ המעודכן, ולתבנית הפעילה החדשה מוקצה מספר גרסה גבוה באחד ממספר הגרסה של התבנית שהוחלפה.

במידת הצורך, אפשר להשתמש ב-API ל-REST כדי לחזור לגרסה הקודמת. כדי לצמצם את הסיכון לשגיאות בעדכון, תוכלו לבצע אימות לפני הפרסום.

התנאים וההתאמות האישיות של Remote Config כלולים בתבניות שהורדו, לכן חשוב לשים לב למגבלות הבאות כשמנסים לפרסם בפרויקט אחר:

• אי אפשר לייבא התאמות אישיות מפרויקט לפרויקט.

  לדוגמה, אם הפעלתם התאמה אישית בפרויקט ואתם מורידים ולערוך תבנית, תוכלו לפרסם אותה באותו פרויקט, אבל אי אפשר לפרסם אותה בפרויקט אחר אלא אם מוחקים את ההתאמות האישיות מהתבנית.

• אפשר לייבא תנאים מפרויקט לפרויקט, אבל חשוב לזכור שערכים מותנים ספציפיים (כמו מזהי אפליקציות או קהלים) צריכים להתקיים בפרויקט היעד לפני הפרסום.

  לדוגמה, אם יש לכם פרמטר Remote Config שמשתמש בתנאי שמציין ערך פלטפורמה של iOS, אפשר לפרסם את התבנית בפרויקט אחר כי ערכי הפלטפורמה זהים בכל פרויקט. עם זאת, אם הוא מכיל תנאי שמבוסס על מזהה אפליקציה ספציפי או על קהל משתמשים שלא קיים בפרויקט היעד, האימות ייכשל.

• אם התבנית שאתם מתכננים לפרסם מכילה תנאים שמסתמכים על Google Analytics, צריך להפעיל את Analytics בפרויקט היעד.

cURL

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename

בפקודה curl הזו, אפשר לציין את התוכן באמצעות התו '@' ואחריו שם הקובץ.

בקשת HTTP גולמית

Host: firebaseremoteconfig.googleapis.com
PUT /v1/projects/my-project-id/remoteConfig HTTP/1.1
Content-Length: size
Content-Type: application/json; UTF8
Authorization: Bearer token
If-Match: expected ETag
Accept-Encoding: gzip
JSON_HERE

מכיוון שזו בקשת כתיבה, הפקודה הזו משנה את ה-ETag, ו-ETag מעודכן מסופק בכותרות התגובה של הפקודה הבאה PUT.

שינוי התנאים של הגדרת התצורה מרחוק

אפשר לשנות באופן פרוגרמטי את התנאים ואת הערכים המותנים של Remote Config. כשמשתמשים ב-API ל-REST, צריך לערוך את התבנית ישירות כדי לשנות את התנאים לפני פרסום התבנית.

{
  "conditions": [{
    "name": "android_english",
    "expression": "device.os == 'android' && device.country in ['us', 'uk']",
    "tagColor": "BLUE"
  }, {
    "name": "tenPercent",
    "expression": "percent <= 10",
    "tagColor": "BROWN"
  }],
  "parameters": {
    "welcome_message": {
      "defaultValue": {
        "value": "Welcome to this sample app"
      },
      "conditionalValues": {
        "tenPercent": {
          "value": "Welcome to this new sample app"
        }
      },
      "description": "The sample app's welcome message"
    },
    "welcome_message_caps": {
      "defaultValue": {
        "value": "false"
      },
      "conditionalValues": {
        "android_english": {
          "value": "true"
        }
      },
      "description": "Whether the welcome message should be displayed in all capital letters."
    }
  }
}

השינויים שלמעלה מגדירים קודם קבוצת תנאים, ואז מגדירים ערכי ברירת מחדל וערכי פרמטרים מבוססי-תנאים (ערכים מותנים) לכל פרמטר. הוא גם מוסיף תיאור אופציונלי לכל רכיב. בדומה לתגובות בקוד, התיאורים האלה מיועדים למפתחים ולא מוצגים באפליקציה. בנוסף, ETag מסופק למטרות בקרת גרסאות.

הערה: מאחר שכל ערך הוא מטבעו מחרוזת עבור Firebase Remote Config, ערכים בוליאניים מוקלדים כ-'true' ו-'false'. הם מומרים ל-boolean בצורה נכונה כשמשתמשים בשיטות getBoolean. הערכים 'True', 'False', '1' ו-'0' הם לא ייצוגים נכונים של ערכים בוליאניים עבור Firebase Remote Config.

ממשקי ה-API לקצה העורפי Remote Config מספקים כמה תנאים ואופרטורים להשוואות שבהם אפשר להשתמש כדי לשנות את ההתנהגות והמראה של האפליקציה. מידע נוסף על התנאים ועל האופרטורים שנתמכים בתנאים האלה זמין במאמרי העזרה לביטויים מותנים.

קודי שגיאה של HTTP

קוד הסטטוס	משמעות
200	העדכון בוצע בהצלחה
400	אירעה שגיאת אימות. לדוגמה, בקשה שמכילה יותר ממספר המפתחות המותרים – 2, 000 – תחזיר קוד 400 (בקשה לא חוקית) עם הודעת השגיאה Param count too large. בנוסף, קוד המצב הזה של HTTPS יכול להתרחש בשתי המצבים הבאים: אירעה שגיאה של חוסר התאמה בגרסה כי קבוצת הערכים והתנאים עודכנו מאז האחזור האחרון של ערך ETag. כדי לפתור את הבעיה, צריך להשתמש בפקודה GET כדי לקבל תבנית וערך ETag חדשים, לעדכן את התבנית ואז לשלוח אותה באמצעות התבנית הזו וערך ה-ETag החדש. בוצעה פקודת PUT (בקשה לעדכון Remote Config של תבנית) בלי לציין כותרת If-Match.
401	אירעה שגיאת הרשאה (לא סופק אסימון גישה או שה-API ל-REST של Remote Config ב-Firebase לא נוסף לפרויקט במסוף הפיתוח של Cloud)
403	אירעה שגיאת אימות (סיפק אסימון הגישה הלא נכון)
500	אירעה שגיאה פנימית. אם השגיאה הזו מתרחשת, צריך לשלוח כרטיס תמיכה ב-Firebase.

קוד סטטוס 200 מציין שהתבנית Remote Config (הפרממטרים, הערכים והתנאים של הפרויקט) עודכנה ועכשיו היא זמינה לאפליקציות שמשתמשות בפרויקט הזה. קודי סטטוס אחרים מציינים שתבנית Remote Config שהייתה קיימת קודם לכן עדיין בתוקף.

אחרי ששולחים עדכונים לתבנית, נכנסים למסוף Firebase כדי לוודא שהשינויים מופיעים כמצופה. זה חשוב כי סדר התנאים משפיע על אופן ההערכה שלהם (התנאי הראשון שמעריך את true נכנס לתוקף).

שימוש ב-ETag ועדכונים מאולצים

ב-API ל-REST של Remote Config נעשה שימוש בתג ישות (ETag) כדי למנוע מרוץ תהליכים ועדכונים חופפים של משאבים. למידע נוסף על תגי ETag, ראו ETag – HTTP.

ב-API ל-REST, מומלץ לשמור במטמון את ה-ETag שסופק על ידי הפקודה GET האחרונה, ולהשתמש בערך ה-ETag הזה בכותרת הבקשה של If-Match כשמפעילים פקודות PUT. אם הפקודה PUT מובילה לקוד סטטוס HTTPS 409, צריך להפיק פקודת GET חדשה כדי לקבל תבנית ו-ETag חדשים לשימוש בפקודה הבאה של PUT.

הערה: אנחנו מודעים לבעיה שבה ה-ETag לא מוחזר כראוי במקרים שבהם הבקשה לא מציינת סוג דחיסה. בשלב זה, חובה לכלול את הכותרת Accept-Encoding: gzip או את הכותרת המקבילה בכל הבקשות.

אפשר לעקוף את ה-ETag ואת ההגנה שהוא מספק על ידי אילוץ העדכון של התבנית Remote Config באופן הבא: If-Match: * עם זאת, לא מומלץ להשתמש בגישה הזו כי היא עלולה לגרום לאובדן עדכונים של התבנית Remote Config אם כמה לקוחות מעדכנים את התבנית Remote Config. התנגשות כזו יכולה להתרחש אצל מספר לקוחות שמשתמשים ב-API, או בעקבות עדכונים מתנגשים של לקוחות API ושל משתמשים במסוף Firebase.

למידע נוסף על ניהול גרסאות של תבניות Remote Config, ראו תבניות וניהול גרסאות של Remote Config.