अनुरोध के लिए पुष्टि किए गए सेवा खाते से जुड़े एंटरप्राइज़ के लिए
सूचना सेट करता है और दिखाता है. अगर कोई सूचना लंबित नहीं है, तो हो सकता है कि सूचना सेट
खाली हो.
एंटरप्राइज़ सेट को खाली छोड़ने पर,
एंटरप्राइज़ सेट को कॉल करके, सूचना सेट को 20 सेकंड के अंदर स्वीकार करना
होगा.
ऐसी सूचनाएं जिन्हें 20 सेकंड के अंदर स्वीकार नहीं किया जाता, उन्हें दूसरे पुल नोटिफ़िकेशन सेट के अनुरोध के जवाब में फिर से शामिल कर लिया जाता है.
जिन सूचनाओं को स्वीकार नहीं किया जाता उन्हें Google Cloud Platform के Pub/Sub सिस्टम की नीति के तहत मिटा दिया जाता है.
सूचनाएं पाने के लिए एक साथ कई अनुरोध किए जा सकते हैं.
इस स्थिति में, अगर कोई अनुरोध पूरा नहीं हुआ है, तो वह सूचना हर कॉलर में बंट जाएगी.
अगर कोई सूचना मौजूद नहीं है, तो एक खाली सूचना सूची दिखेगी.
बाद के अनुरोध, ज़्यादा सूचनाएं मिल सकती हैं.
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet
पैरामीटर
पैरामीटर का नाम | वैल्यू | ब्यौरा |
---|---|---|
वैकल्पिक क्वेरी पैरामीटर | ||
requestMode |
string |
सूचनाएं पाने का अनुरोध मोड.
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 |
प्रॉडक्ट स्वीकार किया गया था या अस्वीकार किया गया था. यह फ़ील्ड हमेशा मौजूद रहेगा.
मान्य वैल्यू ये हैं:
|
|
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 |
इंस्टॉलेशन की गड़बड़ी की वजह. यह फ़ील्ड हमेशा मौजूद रहेगा.
मान्य वैल्यू ये हैं:
|
|
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 |
प्रॉडक्ट की नई स्थिति. यह फ़ील्ड हमेशा मौजूद रहेगा.
मान्य वैल्यू ये हैं:
|
|
notification[].newDeviceEvent |
nested object |
नए डिवाइसों के बारे में सूचनाएं. | |
notification[].newDeviceEvent.userId |
string |
उपयोगकर्ता का आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
notification[].newDeviceEvent.deviceId |
string |
डिवाइस का Android आईडी. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
notification[].newDeviceEvent.managementType |
string |
यह बताता है कि डिप्लॉयमेंट कॉन्फ़िगरेशन में किसी डिवाइस को Android ईएमएम से किस हद तक कंट्रोल किया जा सकता है. ये वैल्यू हो सकती हैं:
इन वैल्यू को स्वीकार किया जाता है:
|
|
notification[].notificationType |
string |
सूचना किस तरह की है.
मान्य वैल्यू ये हैं:
|
|
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 |
ऐप्लिकेशन की गंभीरता. यह फ़ील्ड हमेशा मौजूद रहेगा.
मान्य वैल्यू ये हैं:
|
|
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message |
string |
ऐप्लिकेशन की स्थिति बताने वाला फ़्री-फ़ॉर्म, पढ़ने में आसान मैसेज. उदाहरण के लिए, गड़बड़ी का कोई मैसेज. XSS को रोकने के लिए, हमारी सलाह है कि आप संदेश दिखाने से पहले ही किसी भी HTML को निकाल दें. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data |
string |
मशीन से पढ़े जा सकने वाले डेटा के लिए अतिरिक्त फ़ील्ड. उदाहरण के लिए, कोई संख्या या JSON ऑब्जेक्ट. XSS को रोकने के लिए, हमारा सुझाव है कि आप किसी भी HTML को दिखाने से पहले उसे डेटा से हटा दें. | |
kind |
string |