Enterprises: pullNotificationSet

अनुरोध के लिए पुष्टि किए गए सेवा खाते से जुड़े एंटरप्राइज़ के लिए सूचना सेट करता है और दिखाता है. अगर कोई सूचना लंबित नहीं है, तो हो सकता है कि सूचना सेट खाली हो.
एंटरप्राइज़ सेट को खाली छोड़ने पर, एंटरप्राइज़ सेट को कॉल करके, सूचना सेट को 20 सेकंड के अंदर स्वीकार करना होगा.
ऐसी सूचनाएं जिन्हें 20 सेकंड के अंदर स्वीकार नहीं किया जाता, उन्हें दूसरे पुल नोटिफ़िकेशन सेट के अनुरोध के जवाब में फिर से शामिल कर लिया जाता है. जिन सूचनाओं को स्वीकार नहीं किया जाता उन्हें Google Cloud Platform के Pub/Sub सिस्टम की नीति के तहत मिटा दिया जाता है.
सूचनाएं पाने के लिए एक साथ कई अनुरोध किए जा सकते हैं. इस स्थिति में, अगर कोई अनुरोध पूरा नहीं हुआ है, तो वह सूचना हर कॉलर में बंट जाएगी.
अगर कोई सूचना मौजूद नहीं है, तो एक खाली सूचना सूची दिखेगी. बाद के अनुरोध, ज़्यादा सूचनाएं मिल सकती हैं.

अनुरोध करें

एचटीटीपी अनुरोध

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
वैकल्पिक क्वेरी पैरामीटर
requestMode string सूचनाएं पाने का अनुरोध मोड.
waitForNotifications के बारे में बताने पर अनुरोध ब्लॉक हो जाएगा और एक या ज़्यादा सूचनाएं मौजूद होने तक इंतज़ार करना होगा. कुछ समय बाद कोई सूचना न होने पर, सूचना वाली सूची खाली दिखेगी.
returnImmediately को तय करने से, बिना पढ़ी हुई सूचनाएं तुरंत वापस लौटाने का अनुरोध होगा या कोई सूचना मौजूद न होने पर इसे खाली छोड़ दिया जाएगा.
अगर छूट जाता है, तो डिफ़ॉल्ट रूप से waitForNotifications हो जाता है.

मान्य वैल्यू ये हैं:
  • "returnImmediately"
  • "waitForNotifications"

अनुमति देना

इस अनुरोध के लिए नीचे दिए गए दायरे की अनुमति चाहिए:

स्कोप
https://www.googleapis.com/auth/androidenterprise

ज़्यादा जानकारी के लिए, पुष्टि और अनुमति देना पेज देखें.

अनुरोध का मुख्य भाग

इस तरीके से, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

{
  "kind": "androidenterprise#notificationSet",
  "notificationSetId": string,
  "notification": [
    {
      "enterpriseId": string,
      "timestampMillis": long,
      "notificationType": string,
      "productApprovalEvent": {
        "productId": string,
        "approved": string
      },
      "installFailureEvent": {
        "productId": string,
        "deviceId": string,
        "userId": string,
        "failureReason": string,
        "failureDetails": string
      },
      "appUpdateEvent": {
        "productId": string
      },
      "newPermissionsEvent": {
        "productId": string,
        "requestedPermissions": [
          string
        ],
        "approvedPermissions": [
          string
        ]
      },
      "appRestrictionsSchemaChangeEvent": {
        "productId": string
      },
      "productAvailabilityChangeEvent": {
        "productId": string,
        "availabilityStatus": string
      },
      "newDeviceEvent": {
        "userId": string,
        "deviceId": string,
        "managementType": string,
        "dpcPackageName": string
      },
      "deviceReportUpdateEvent": {
        "userId": string,
        "deviceId": string,
        "report": {
          "lastUpdatedTimestampMillis": long,
          "appState": [
            {
              "packageName": string,
              "keyedAppState": [
                {
                  "key": string,
                  "stateTimestampMillis": long,
                  "severity": string,
                  "message": string,
                  "data": string
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा ज़रूरी जानकारी
notificationSetId string सूचना सेट आईडी को एंटरप्राइज़ की अनुमति वाले विज्ञापन की सूचना पाने की एपीआई के साथ सूचना के तौर पर मार्क करना ज़रूरी है. अगर कोई सूचना मौजूद नहीं है, तो उसे छोड़ दिया जाएगा.
notification[] list आपको कोई सूचना न मिलने पर या बिना सूचनाएं वाली खाली जगहें मिलेंगी.
notification[].enterpriseId string उस एंटरप्राइज़ का आईडी जिसके लिए सूचना भेजी गई है. यह हमेशा मौजूद रहेगा.
notification[].timestampMillis long 1970-01-01T00:00:00Z से मिलीसेकंड में सूचना प्रकाशित होने का समय. यह हमेशा मौजूद रहेगा.
notification[].productApprovalEvent nested object किसी प्रॉडक्ट की मंज़ूरी के स्टेटस में किए गए बदलावों के बारे में सूचनाएं.
notification[].productApprovalEvent.productId string प्रॉडक्ट का आईडी (जैसे कि "app.com.google.android.gm") जिसके लिए अनुमति की स्थिति बदल गई है. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].productApprovalEvent.approved string प्रॉडक्ट स्वीकार किया गया था या अस्वीकार किया गया था. यह फ़ील्ड हमेशा मौजूद रहेगा.

मान्य वैल्यू ये हैं:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object ऐप्लिकेशन इंस्टॉल न होने के बारे में सूचनाएं.
notification[].installFailureEvent.productId string उस प्रॉडक्ट का आईडी (उदाहरण के लिए, "app:com.google.android.gm") जिसके लिए इंस्टॉल न हो पाने का इवेंट हुआ. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].installFailureEvent.deviceId string डिवाइस का Android आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].installFailureEvent.userId string उपयोगकर्ता का आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].installFailureEvent.failureReason string इंस्टॉलेशन की गड़बड़ी की वजह. यह फ़ील्ड हमेशा मौजूद रहेगा.

मान्य वैल्यू ये हैं:
  • "timeout"
  • "unknown"
notification[].installFailureEvent.failureDetails string अगर लागू हो, तो गड़बड़ी के बारे में ज़्यादा जानकारी.
notification[].appUpdateEvent nested object ऐप्लिकेशन के अपडेट से जुड़ी सूचनाएं.
notification[].appUpdateEvent.productId string प्रॉडक्ट का आईडी (उदाहरण के लिए, "app.com.google.android.gm") जिसे अपडेट किया गया था. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].newPermissionsEvent nested object ऐप्लिकेशन की नई अनुमतियों के बारे में सूचनाएं.
notification[].newPermissionsEvent.productId string उस प्रॉडक्ट का आईडी (जैसे कि "app.com.google.android.gm") जिसके लिए नई अनुमतियां जोड़ी गई थीं. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].newPermissionsEvent.requestedPermissions[] list अनुमतियों का वह सेट जिसके लिए ऐप्लिकेशन, फ़िलहाल अनुरोध कर रहा है. अनुमतियां इस्तेमाल करें.इन अनुमतियों की जानकारी पाने के लिए, ईएमएम एपीआई में जाएं.
notification[].newPermissionsEvent.approvedPermissions[] list उन अनुमतियों का सेट जिन्हें एंटरप्राइज़ के एडमिन ने पहले ही इस ऐप्लिकेशन के लिए मंज़ूरी दे दी है. अनुमतियां इस्तेमाल करें.इन अनुमतियों की जानकारी पाने के लिए, ईएमएम एपीआई में जाएं.
notification[].appRestrictionsSchemaChangeEvent nested object ऐप्लिकेशन पर लगी पाबंदी वाले स्कीमा से जुड़े नए बदलावों के बारे में सूचनाएं.
notification[].appRestrictionsSchemaChangeEvent.productId string उस प्रॉडक्ट का आईडी (जैसे कि "app:com.google.android.gm") जिसके लिए ऐप्लिकेशन पर लगी पाबंदी वाला स्कीमा बदल गया है. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].productAvailabilityChangeEvent nested object प्रॉडक्ट की उपलब्धता में बदलावों से जुड़ी सूचनाएं.
notification[].productAvailabilityChangeEvent.productId string प्रॉडक्ट का आईडी (जैसे कि "app.com.google.android.gm") जिसके लिए प्रॉडक्ट की उपलब्धता में बदलाव हुआ है. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].productAvailabilityChangeEvent.availabilityStatus string प्रॉडक्ट की नई स्थिति. यह फ़ील्ड हमेशा मौजूद रहेगा.

मान्य वैल्यू ये हैं:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
notification[].newDeviceEvent nested object नए डिवाइसों के बारे में सूचनाएं.
notification[].newDeviceEvent.userId string उपयोगकर्ता का आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].newDeviceEvent.deviceId string डिवाइस का Android आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].newDeviceEvent.managementType string यह बताता है कि डिप्लॉयमेंट कॉन्फ़िगरेशन में किसी डिवाइस को Android ईएमएम से किस हद तक कंट्रोल किया जा सकता है.

ये वैल्यू हो सकती हैं:
  • "managedDevice", ऐसा डिवाइस जहां डीपीसी को डिवाइस के मालिक के तौर पर सेट किया गया है
  • "managedProfile", एक ऐसा डिवाइस है जहां DPC को प्रोफ़ाइल के मालिक के तौर पर सेट किया जाता है.


इन वैल्यू को स्वीकार किया जाता है:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string सूचना किस तरह की है.

मान्य वैल्यू ये हैं:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
notification[].newDeviceEvent.dpcPackageName string डिवाइस पर मौजूद नीति ऐप्लिकेशन.
notification[].deviceReportUpdateEvent nested object डिवाइस रिपोर्ट के अपडेट से जुड़ी सूचनाएं.
notification[].deviceReportUpdateEvent.userId string उपयोगकर्ता का आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.deviceId string डिवाइस का Android आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report nested object डिवाइस की रिपोर्ट में ऐप्लिकेशन के नए वर्शन अपडेट हुए हैं. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Epoch के बाद से, पिछली रिपोर्ट के अपडेट का टाइमस्टैंप. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.appState[] list डिवाइस पर मैनेज किए गए ऐप्लिकेशन की सेट की गई ऐप्लिकेशन की स्थितियों की सूची. ऐप्लिकेशन के डेवलपर, ऐप्लिकेशन के स्टेटस के बारे में जानकारी देते हैं. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.appState[].packageName string ऐप्लिकेशन के पैकेज का नाम. यह फ़ील्ड हमेशा दिखेगा.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list ऐप्लिकेशन की मुख्य स्थितियों की सूची. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string इस बात की जानकारी देने के लिए कि ऐप्लिकेशन किस स्थिति की जानकारी दे रहा है. इस कुंजी का कॉन्टेंट, ऐप्लिकेशन के डेवलपर ने सेट किया है. XSS को रोकने के लिए, हमारी सलाह है कि कुंजी से कोई भी HTML दिखाने से पहले आप उसे हटा दें. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long समय का वह टाइमस्टैंप जब ऐप्लिकेशन, epoch के बाद से मिलीसेकंड में स्थिति सेट करता है. यह फ़ील्ड हमेशा मौजूद रहेगा.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string ऐप्लिकेशन की गंभीरता. यह फ़ील्ड हमेशा मौजूद रहेगा.

मान्य वैल्यू ये हैं:
  • "severityError"
  • "severityInfo"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string ऐप्लिकेशन की स्थिति बताने वाला फ़्री-फ़ॉर्म, पढ़ने में आसान मैसेज. उदाहरण के लिए, गड़बड़ी का कोई मैसेज. XSS को रोकने के लिए, हमारी सलाह है कि आप संदेश दिखाने से पहले ही किसी भी HTML को निकाल दें.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string मशीन से पढ़े जा सकने वाले डेटा के लिए अतिरिक्त फ़ील्ड. उदाहरण के लिए, कोई संख्या या JSON ऑब्जेक्ट. XSS को रोकने के लिए, हमारा सुझाव है कि आप किसी भी HTML को दिखाने से पहले उसे डेटा से हटा दें.
kind string