Enterprises: pullNotificationSet

অনুরোধের জন্য প্রমাণীকৃত পরিষেবা অ্যাকাউন্টের সাথে যুক্ত উদ্যোগগুলির জন্য একটি বিজ্ঞপ্তি সেট টানে এবং ফেরত দেয়। কোনো বিজ্ঞপ্তি মুলতুবি না থাকলে বিজ্ঞপ্তি সেট খালি হতে পারে।
প্রত্যাবর্তিত একটি বিজ্ঞপ্তি সেটটি 20 সেকেন্ডের মধ্যে Enterprises.AcknowledgeNotificationSet-এ কল করে স্বীকার করতে হবে, যদি না বিজ্ঞপ্তি সেটটি খালি থাকে৷
20 সেকেন্ডের মধ্যে স্বীকৃত নয় এমন বিজ্ঞপ্তিগুলি শেষ পর্যন্ত অন্য PullNotificationSet অনুরোধের প্রতিক্রিয়াতে আবার অন্তর্ভুক্ত করা হবে এবং যেগুলি কখনই স্বীকার করা হয় না সেগুলি শেষ পর্যন্ত Google ক্লাউড প্ল্যাটফর্ম পাব/সাব সিস্টেম নীতি অনুসারে মুছে ফেলা হবে৷
বিজ্ঞপ্তিগুলি পুনরুদ্ধার করার জন্য একাধিক অনুরোধ একযোগে সঞ্চালিত হতে পারে, এই ক্ষেত্রে মুলতুবি বিজ্ঞপ্তিগুলি (যদি থাকে) প্রতিটি কলারের মধ্যে বিভক্ত করা হবে, যদি কোনো মুলতুবি থাকে।
কোনো বিজ্ঞপ্তি উপস্থিত না থাকলে, একটি খালি বিজ্ঞপ্তি তালিকা ফেরত দেওয়া হয়। পরবর্তী অনুরোধগুলি উপলব্ধ হয়ে গেলে আরও বিজ্ঞপ্তি ফেরত দিতে পারে৷

অনুরোধ

HTTP অনুরোধ 

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
                }
              ]
            }
          ]
        }
      },
      "enterpriseUpgradeEvent": {
        "upgradeState": string
      }
    }
  ]
}
সম্পত্তির নাম মান বর্ণনা নোট
notificationSetId string বিজ্ঞপ্তি সেট আইডি, যা এন্টারপ্রাইজের সাথে প্রাপ্ত বিজ্ঞপ্তিটিকে চিহ্নিত করতে প্রয়োজন৷AcknowledgeNotification API৷ কোনো বিজ্ঞপ্তি উপস্থিত না থাকলে এটি বাদ দেওয়া হবে।
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 ডিভাইসটির অ্যান্ড্রয়েড আইডি। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
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 অ্যাপটি বর্তমানে যে অনুমতিগুলির জন্য অনুরোধ করছে তার সেট৷ অনুমতিগুলি ব্যবহার করুন৷ এই অনুমতিগুলি সম্পর্কে বিশদ বিবরণ পুনরুদ্ধার করতে EMM API এ যান৷
notification[].newPermissionsEvent. approvedPermissions[] list এন্টারপ্রাইজ প্রশাসক ইতিমধ্যেই এই অ্যাপ্লিকেশনটির জন্য অনুমোদিত অনুমতিগুলির সেট৷ অনুমতিগুলি ব্যবহার করুন৷ এই অনুমতিগুলি সম্পর্কে বিশদ বিবরণ পুনরুদ্ধার করতে EMM API এ যান৷
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 ডিভাইসটির অ্যান্ড্রয়েড আইডি। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
notification[].newDeviceEvent. managementType string বিভিন্ন স্থাপনার কনফিগারেশনে একটি Android EMM দ্বারা ডিভাইসটি কতটা নিয়ন্ত্রিত হয় তা শনাক্ত করে৷

সম্ভাব্য মান অন্তর্ভুক্ত:
  • " managedDevice ", একটি ডিভাইস যেখানে ডিপিসি ডিভাইসের মালিক হিসাবে সেট করা আছে,
  • " managedProfile ", একটি ডিভাইস যেখানে DPC প্রোফাইল মালিক হিসাবে সেট করা আছে।


গ্রহণযোগ্য মান হল:
  • " managedDevice "
  • " managedProfile "
notification[]. notificationType string বিজ্ঞপ্তির ধরন।

গ্রহণযোগ্য মান হল:
  • " appRestricionsSchemaChange চেঞ্জ"
  • " appUpdate "
  • " deviceReportUpdate "
  • " enterpriseUpgrade "
  • " installFailure "
  • " newDevice "
  • " newPermissions "
  • " productApproval "
  • " productAvailabilityChange "
  • " testNotification "
  • " unknown "
notification[].newDeviceEvent. dpcPackageName string ডিভাইসে নীতি অ্যাপ।
notification[]. deviceReportUpdateEvent nested object ডিভাইস রিপোর্ট আপডেট সম্পর্কে বিজ্ঞপ্তি.
notification[].deviceReportUpdateEvent. userId string ব্যবহারকারীর আইডি। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
notification[].deviceReportUpdateEvent. deviceId string ডিভাইসটির অ্যান্ড্রয়েড আইডি। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
notification[].deviceReportUpdateEvent. report nested object ডিভাইস রিপোর্ট সর্বশেষ অ্যাপ অবস্থার সাথে আপডেট করা হয়েছে. এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
notification[].deviceReportUpdateEvent.report. lastUpdatedTimestampMillis long যুগের পর থেকে মিলিসেকেন্ডে শেষ রিপোর্ট আপডেটের টাইমস্ট্যাম্প। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
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 যুগ থেকে কখন অ্যাপ মিলিসেকেন্ডে স্টেট সেট করে তার টাইমস্ট্যাম্প। এই ক্ষেত্র সবসময় উপস্থিত থাকবে.
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
notification[]. enterpriseUpgradeEvent nested object এন্টারপ্রাইজ আপগ্রেড সম্পর্কে বিজ্ঞপ্তি।
notification[].enterpriseUpgradeEvent. upgradeState string আপগ্রেড রাষ্ট্র.

গ্রহণযোগ্য মান হল:
  • " upgradeStateSucceeded "
  • " upgradeStateUnspecified "