यूनिफ़ाइड अपडेट कंट्रोल

यूनिफ़ाइड अपडेट कंट्रोल (यूयूसी) की मदद से, आईटी एडमिन को एक ही जगह पर, कंपनी के मालिकाना हक वाले Android डिवाइसों पर सॉफ़्टवेयर अपडेट डाउनलोड और लागू करने का विकल्प मिलता है, ताकि अपडेट की वजह से, बिज़नेस ऑपरेशंस में रुकावट न आए.

एक यूयूसी नीति की मदद से, इन सॉफ़्टवेयर कॉम्पोनेंट के अपडेट कंट्रोल किए जा सकते हैं:

• डिवाइस बनाने वाली कंपनी (ओईएम) की ओर से जारी किए गए ओएस अपडेट. इनमें ओएस के मुख्य अपडेट के साथ-साथ, ओएस और सुरक्षा से जुड़े छोटे-मोटे अपडेट भी शामिल हैं.
• Google Play के सिस्टम अपडेट (Mainline).
• Google की सिस्टम सेवाएं, जैसे कि Google Play services और Android सिस्टम का वेबव्यू. इन्हें एक साथ या एक-एक करके अपडेट किया जा सकता है.

यूयूसी के नियम, Policy संसाधन के unifiedUpdatePolicy फ़ील्ड में तय किए जाते हैं. Android Device Policy (ADP) ऐप्लिकेशन, यूयूसी के लिए डिवाइस पर मौजूद मुख्य कंट्रोल सेंटर है.

ज़रूरी शर्तें

यूयूसी को कॉन्फ़िगर करने से पहले, इन ज़रूरी शर्तों की पुष्टि करें:

• आपका ईएमएम सलूशन, किसी एंटरप्राइज़ के लिए नीतियां बना सकता है और उन्हें अपडेट कर सकता है.
• डिवाइसों का मालिकाना हक कंपनी के पास हो और उन्हें पूरी तरह से मैनेज किए जा रहे डिवाइस के तौर पर या कंपनी के मालिकाना हक वाले डिवाइस पर वर्क प्रोफ़ाइल के साथ कॉन्फ़िगर किया गया हो. निजी डिवाइसों पर यूयूसी की सुविधा काम नहीं करती.
• डिवाइसों में Android का वह कम से कम वर्शन होना चाहिए जो अपडेट के लिए टारगेट किए गए हर वर्शन के साथ काम करता हो. इसकी जानकारी यहां दी गई टेबल में दी गई है:

ज़रूरी बातें और सीमाएं

यूयूसी इंटिग्रेशन की प्लानिंग करने से पहले, इन बातों और सीमाओं को ध्यान में रखें:

• शुरुआती सेटअप विज़र्ड: जब डिवाइस शुरुआती सेटअप विज़र्ड में होता है, तब यूयूसी नीतियां लागू नहीं होती हैं. डिवाइस सेटअप के दौरान, Google Play या ओईएम ओटीए एजेंट से ज़रूरी अपडेट मिल सकते हैं.
• सेटअप के बाद मिलने वाले शुरुआती अपडेट: हो सकता है कि यूयूसी की नीतियां, डिवाइस सेटअप के तुरंत बाद अपने-आप शुरू होने वाले अपडेट पर लागू न हों. जैसे, नीति के एडीपी तक पहुंचने से पहले, Google Play services के शुरुआती अपडेट.
• बंडल किए गए ओटीए मॉड्यूल: ओईएम ओटीए अपडेट में, Mainline मॉड्यूल और Google की सिस्टम सेवाओं के अपडेट किए गए वर्शन शामिल हो सकते हैं. ओईएम ओटीए अपडेट इंस्टॉल करने पर, बंडल किए गए कॉम्पोनेंट अपने-आप अपडेट हो जाते हैं.
• Google Play के सिस्टम अपडेट (Mainline): यूयूसी, Mainline अपडेट को एक यूनिट के तौर पर कंट्रोल करता है. इसलिए, Mainline के अलग-अलग पैकेज को अलग से कंट्रोल नहीं किया जा सकता. UUC सिर्फ़ डाउनलोड फ़ेज़ की शुरुआत को कंट्रोल करता है: एक बार Mainline डाउनलोड शुरू होने के बाद, इसे रोका नहीं जा सकता. अगर डाउनलोड शुरू होने के बाद BLOCK नियम लागू किया जाता है, तो डिवाइस को फिर से चालू करने पर अपडेट पूरा हो जाता है.
• ब्लॉक पीरियड के दौरान मैन्युअल तरीके से अपडेट करना: Google Play के सिस्टम अपडेट (Mainline) और Google के सिस्टम से जुड़ी सेवाओं के लिए, BLOCK नियम सिर्फ़ अपने-आप होने वाले अपडेट को रोकता है. BLOCK नियम चालू होने पर भी, उपयोगकर्ता इन कॉम्पोनेंट को मैन्युअल तरीके से अपडेट कर सकते हैं. इस समस्या को आने वाले वर्शन में ठीक कर दिया जाएगा.
• छूट वाले ऐप्लिकेशन: यूयूसी, Google Play Store ऐप्लिकेशन या एडीपी ऐप्लिकेशन के अपडेट मैनेज नहीं करता.

यूयूसी की नीतियों को समझना

UnifiedUpdatePolicy में Rule ऑब्जेक्ट की क्रम वाली सूची होती है. हर नियम में यह जानकारी होती है:

• ईएमएम सलूशन से तय किया गया आइडेंटिफ़ायर (id)
• एक या उससे ज़्यादा सॉफ़्टवेयर अपडेट टारगेट
• इवैलुएशन के वैकल्पिक चरण
• समय के हिसाब से शर्तों वाले एक या उससे ज़्यादा वैकल्पिक प्रेडिकेट
• एक नतीजा, जिससे यह तय होता है कि अपडेट को कैसे मैनेज किया जाए

नियम का आकलन

किसी अपडेट की समीक्षा करते समय, एडीपी उन सभी नियमों को ध्यान में रखता है जो उस अपडेट के टारगेट और स्टेज पर लागू होते हैं. ये नियम, rules में दिखने के क्रम में लागू होते हैं. एडीपी, उस पहले नियम को चुनता है जिसका प्रेडिकेट true के तौर पर आकलन करता है और उसके नतीजे को लागू करता है. जैसे, चेन किया गया if-else स्टेटमेंट. अगर किसी भी नियम का प्रेडिकेट true पर सेट नहीं है, तो कॉम्पोनेंट के लिए ज़िम्मेदार अपडेट क्लाइंट, अपडेट को सामान्य तरीके से मैनेज करता है.

नियम के आइडेंटिफ़ायर

हर नियम के लिए, ज़्यादा से ज़्यादा 64 वर्णों का id ज़रूरी है. इसे आपका ईएमएम सलूशन तय करता है. id को खाली नहीं छोड़ा जा सकता. साथ ही, यह किसी नीति के नियमों के बीच यूनीक होना चाहिए.

टारगेट अपडेट करना

हर नियम में, targets की एक ऐसी सूची होनी चाहिए जो खाली न हो और जिसमें डुप्लीकेट वैल्यू न हों. एक ही नियम में कई टारगेट तय करने का मतलब है कि क्रम में कई नियम तय करना. हर नियम में एक ही टारगेट होना चाहिए और वह उसी क्रम में होना चाहिए.

यहां दी गई टेबल में, targetType की इस्तेमाल की जा सकने वाली वैल्यू के बारे में बताया गया है:

इवैलुएशन के चरण

OS_UPDATE_WITH_API_LEVEL_CHANGE और OS_UPDATE_WITHOUT_API_LEVEL_CHANGE टारगेट के लिए, आपके पास वह stages तय करने का विकल्प होता है जिस पर किसी नियम का आकलन किया जाता है:

• STAGE_DOWNLOAD: अपडेट डाउनलोड करने से पहले, नियम का आकलन किया जाता है.
• STAGE_APPLY: अपडेट लागू करने वाली कार्रवाई करने से पहले, नियम का आकलन किया जाता है. जैसे, डिवाइस को अपने-आप फिर से चालू करना.

अगर stages खाली है, तो नियम का आकलन सभी चरणों में किया जाता है. ध्यान दें: GOOGLE_SYSTEM_SERVICES, SINGLE_APP, और GOOGLE_PLAY_SYSTEM_UPDATE टारगेट के लिए, स्टेज को अनदेखा कर दिया जाता है.

प्रेडिकेट

predicate, समय के हिसाब से ऐसी शर्तें तय करता है जिनके तहत कोई नियम लागू होता है. जैसे, हफ़्ते के दिन, दिन के समय की विंडो (घंटे के हिसाब से), डिवाइस के स्थानीय टाइम ज़ोन में कैलेंडर की तारीख की सीमा या डिवाइस के लिए अपडेट कितने समय से उपलब्ध है (24 घंटे के गुणकों में).

एक ही प्रेडिकेट में सेट की गई सभी शर्तों को लॉजिकल AND का इस्तेमाल करके जोड़ा जाता है. खाली या छोड़े गए प्रेडिकेट की वैल्यू हमेशा true होती है. प्रेडिकेट फ़ील्ड और उनकी पाबंदियों की पूरी सूची देखने के लिए, Predicate रेफ़रंस दस्तावेज़ देखें.

दिन के समय की विंडो (timeOfDayLowerBound और timeOfDayUpperBound) कॉन्फ़िगर करते समय, आकलन के इन नियमों का ध्यान रखें:

• घंटे की सीमाएं: दिन के समय की सीमाओं का आकलन, डिवाइस के स्थानीय टाइम ज़ोन में hh:00:00 के तौर पर किया जाता है. timeOfDayUpperBound, तय किए गए घंटे पर विंडो बंद कर देता है. उदाहरण के लिए, 9 की निचली सीमा और 17 की ऊपरी सीमा, 09:00 से 17:00 को कवर करती है.
• बाउंड ऑर्डरिंग मान्य है: जब दोनों बाउंड एक ही नियम में सेट किए जाते हैं, तो timeOfDayUpperBound, timeOfDayLowerBound से ज़्यादा होना चाहिए. अगर timeOfDayUpperBound, timeOfDayLowerBound से कम या इसके बराबर है या इसे 0 (00:00) पर सेट किया गया है, तो प्रेडिकेट की वैल्यू false होगी.
• दिन के आखिर और रात भर की विंडो: किसी विंडो को दिन के आखिर (24:00) तक बढ़ाने के लिए, timeOfDayUpperBound को छोड़ दें. रात भर की विंडो तय करने के लिए, जो आधी रात तक चलती है (उदाहरण के लिए, 22:00 से 04:00), विंडो को दो क्रम में चलने वाले नियमों में बांटें: शाम का नियम, जिसमें सिर्फ़ timeOfDayLowerBound सेट हो ({ "hours": 22 }) और सुबह का नियम, जिसमें सिर्फ़ timeOfDayUpperBound सेट हो ({ "hours": 4 }, अगर daysOfWeek सेट है, तो अगले दिन को टारगेट करना).

परिणाम

outcome से यह तय होता है कि जब किसी नियम का प्रेडिकेट true के तौर पर आकलन करता है, तब एडीपी, अपडेट एजेंट को आगे बढ़ने का निर्देश कैसे देता है. नीचे दी गई टेबल में, इस्तेमाल की जा सकने वाली outcomeType वैल्यू के बारे में बताया गया है:

देरी से लागू करने की ज़्यादा से ज़्यादा सीमाएं

UUC, BLOCK या USER_PROMPT नतीजे वाले अपडेट को कुछ समय के लिए टालने की अनुमति देता है. हर अपडेट टारगेट के लिए, अपडेट को ज़्यादा से ज़्यादा तय समय तक टाला जा सकता है. अगर कोई अपडेट, देरी से लागू करने की तय की गई ज़्यादा से ज़्यादा अवधि से ज़्यादा समय तक उपलब्ध रहता है, तो BLOCK या USER_PROMPT के नतीजे को डिफ़ॉल्ट पर सेट कर दिया जाता है. साथ ही, अपडेट क्लाइंट, अपडेट को सामान्य तरीके से मैनेज करता है.

यहां दी गई टेबल में, टारगेट और मैनेजमेंट मोड के हिसाब से, अपडेट को रोकने की ज़्यादा से ज़्यादा सीमाएं दी गई हैं:

systemUpdate की प्राथमिकता

किसी मौजूदा नीति में unifiedUpdatePolicy को जोड़ने से पहले, उसकी systemUpdate सेटिंग की समीक्षा करें. साथ ही, यूयूसी के नियमों का इस्तेमाल करके, अपनी ज़रूरत के मुताबिक बिहेवियर को फिर से बनाएं. उदाहरण के लिए, कारोबार के खुले होने के समय ओएस अपडेट को रोकने के लिए, BLOCK नियम का इस्तेमाल करें. जैसे, कारोबार के खुले होने के समय ओएस के मुख्य अपडेट ब्लॉक करें में बताया गया है.

यह प्राथमिकता, AMAPI SDK टूल का इस्तेमाल करने वाले कस्टम डीपीसी से अलग होती है. इसमें ओईएम ओटीए अपडेट के लिए, एओएसपी SystemUpdatePolicy को यूयूसी से ज़्यादा प्राथमिकता दी जाती है. ज़्यादा जानकारी के लिए, एओएसपी SystemUpdatePolicy की प्राथमिकता देखें. अगर डिवाइस पर ओईएम के लिए खास तौर पर बनाई गई अपडेट मैनेजमेंट सेवा (जैसे, एंटरप्राइज़ ओटीए सलूशन) चालू है, तो ओईएम ओएस अपडेट (OS_UPDATE_WITH_API_LEVEL_CHANGE और OS_UPDATE_WITHOUT_API_LEVEL_CHANGE) के लिए, उस सेवा को भी यूयूसी से ज़्यादा प्राथमिकता दी जाती है.

यूयूसी नीति को कॉन्फ़िगर करना

नीति के संसाधन पर, unifiedUpdatePolicy फ़ील्ड को सेट किया जा सकता है, वापस पाया जा सकता है, और मिटाया जा सकता है. साथ ही, नीति का इस्तेमाल करने वाले डिवाइसों के लिए, डिवाइस के नियमों का पालन करने की स्थिति देखी जा सकती है.

यूयूसी की नीति सेट करना

UUC को कॉन्फ़िगर करने के लिए, नीति में unifiedUpdatePolicy ऑब्जेक्ट जोड़ें. किसी मौजूदा नीति की अन्य सेटिंग में बदलाव किए बिना, यूयूसी नीति लागू करने के लिए, updateMask=unifiedUpdatePolicy के साथ enterprises.policies.patch को कॉल करें:

PATCH https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}?updateMask=unifiedUpdatePolicy

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

अपडेट की गई नीति, उन सभी डिवाइसों पर लागू होती है जो इसका इस्तेमाल करते हैं. जब भी किसी कंट्रोल किए गए कॉम्पोनेंट के लिए कोई अपडेट उपलब्ध होता है, तब एडीपी हर डिवाइस पर नियमों का आकलन करता है.

यूयूसी की नीति को वापस लाना

कॉन्फ़िगर किए गए यूयूसी नियमों को पढ़ने के लिए, enterprises.policies.get को कॉल करें और लौटाई गई नीति के unifiedUpdatePolicy फ़ील्ड की जांच करें:

GET https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}

यूयूसी नीति को हटाना

किसी नीति से सभी यूयूसी नियम हटाने के लिए, updateMask=unifiedUpdatePolicy के साथ enterprises.policies.patch को कॉल करें. साथ ही, अनुरोध के मुख्य हिस्से में unifiedUpdatePolicy शामिल न करें:

PATCH https://androidmanagement.googleapis.com/v1/enterprises/{enterpriseId}/policies/{policyId}?updateMask=unifiedUpdatePolicy

{}

नीति कॉन्फ़िगरेशन के उदाहरण

यहां दिए गए उदाहरणों में, सामान्य स्थितियों के लिए unifiedUpdatePolicy ऑब्जेक्ट दिखाया गया है. यूयूसी नीति सेट करें में बताए गए तरीके के मुताबिक, enterprises.policies.patch का इस्तेमाल करके उन्हें लागू करें. AMAPI SDK की मदद से, अपडेट कंट्रोल करने की सुविधा को कॉन्फ़िगर करें लेख में, Kotlin और Java कोड के तौर पर भी यही स्थितियां उपलब्ध हैं.

कारोबार के खुले होने के समय, ओएस के मुख्य अपडेट ब्लॉक करना

यहां दिया गया नियम, सोमवार से शुक्रवार तक सुबह 9:00 बजे से शाम 5:00 बजे तक, ओएस के मुख्य अपडेट (OS_UPDATE_WITH_API_LEVEL_CHANGE) को ब्लॉक करता है:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

अपडेट की उम्र के हिसाब से, ओएस के अपडेट को ज़बरदस्ती लागू करना

इस नियम के तहत, ओएस के उन मुख्य अपडेट को इंस्टॉल करना ज़रूरी है जो डिवाइस के लिए सात दिनों (604800s) से उपलब्ध हैं:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Force Policy",
        "targets": [
          {
            "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE"
          }
        ],
        "predicate": {
          "updateAgeUpperBound": "604800s"
        },
        "outcome": {
          "outcomeType": "FORCE"
        }
      }
    ]
  }
}

Google के किसी सिस्टम सर्विस ऐप्लिकेशन के लिए अपडेट ब्लॉक करना

Google की सिस्टम सर्विस के किसी खास ऐप्लिकेशन को कंट्रोल करने के लिए, जैसे कि Android सिस्टम का वेबव्यू (com.google.android.webview), targetType को SINGLE_APP पर सेट करें. साथ ही, singleApp में ऐप्लिकेशन का packageName दें. नीचे दिया गया नियम, सोमवार से शुक्रवार तक सुबह 9 बजे से शाम 5 बजे तक WebView के अपडेट को ब्लॉक करता है:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Webview Policy",
        "targets": [
          {
            "targetType": "SINGLE_APP",
            "singleApp": {
              "packageName": "com.google.android.webview"
            }
          }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}

अपडेट के सभी टारगेट के लिए, कई नियमों को एक साथ जोड़ना

नियमों का आकलन क्रम से किया जाता है. इसलिए, कई नियमों को जोड़कर, कुछ खास विंडो के दौरान अपडेट ब्लॉक किए जा सकते हैं. साथ ही, उन विंडो के बाहर अपडेट लागू किए जा सकते हैं.

नीचे दिए गए उदाहरण में, चार कैटगरी टारगेट (OS_UPDATE_WITH_API_LEVEL_CHANGE, OS_UPDATE_WITHOUT_API_LEVEL_CHANGE, GOOGLE_SYSTEM_SERVICES, और GOOGLE_PLAY_SYSTEM_UPDATE) पर, क्रम में चलने वाले दो नियम लागू किए गए हैं:

1. कारोबार के खुले होने के समय (सोमवार से शुक्रवार, सुबह 9:00 बजे से शाम 5:00 बजे तक) सभी अपडेट ब्लॉक करें.
2. कारोबार के खुले होने के समय के अलावा, सात दिनों तक उपलब्ध अपडेट को ज़बरदस्ती लागू करें.

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "Block Policy - rule1",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "daysOfWeek": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY"
          ],
          "timeOfDayLowerBound": { "hours": 9 },
          "timeOfDayUpperBound": { "hours": 17 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      },
      {
        "id": "Force Policy - rule2",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "updateAgeUpperBound": "604800s"
        },
        "outcome": {
          "outcomeType": "FORCE"
        }
      }
    ]
  }
}

किसी तारीख तक अपडेट पर पाबंदी लगाना

डिवाइस के स्थानीय टाइम ज़ोन में, कैलेंडर की तारीख की किसी खास सीमा के दौरान अपडेट पर पाबंदी लगाने या उन्हें अनुमति देने के लिए, dateLowerBound और dateUpperBound का इस्तेमाल किया जा सकता है. यहां दिए गए नियम के तहत, 14 मार्च, 2026 तक कैटगरी टारगेटिंग की चार सुविधाओं के लिए अपडेट ब्लॉक रहेंगे:

{
  "unifiedUpdatePolicy": {
    "rules": [
      {
        "id": "block_until_date",
        "targets": [
          { "targetType": "OS_UPDATE_WITH_API_LEVEL_CHANGE" },
          { "targetType": "OS_UPDATE_WITHOUT_API_LEVEL_CHANGE" },
          { "targetType": "GOOGLE_SYSTEM_SERVICES" },
          { "targetType": "GOOGLE_PLAY_SYSTEM_UPDATE" }
        ],
        "predicate": {
          "dateUpperBound": { "year": 2026, "month": 3, "day": 14 }
        },
        "outcome": {
          "outcomeType": "BLOCK"
        }
      }
    ]
  }
}