रिपोर्ट एपीआई: अनुमति देने वाले टोकन की गतिविधि की रिपोर्ट

अनुमति देने वाले टोकन की गतिविधि की रिपोर्ट से, तीसरे पक्ष की उन वेबसाइटों और ऐप्लिकेशन के बारे में जानकारी मिलती है जिनका ऐक्सेस आपके उपयोगकर्ताओं ने दिया है. हर रिपोर्ट, रिपोर्ट के हिसाब से पैरामीटर के साथ रिपोर्ट एंडपॉइंट के बुनियादी अनुरोध का इस्तेमाल करती है. जैसे, तीसरे पक्ष का डोमेन या अनुमति के दायरे. हर रिपोर्ट के लिए, ज़्यादा से ज़्यादा समयावधि पिछले 180 दिन हो सकती है.

OAuth टोकन की गतिविधि की रिपोर्ट का इस्तेमाल, सिर्फ़ आपके ग्राहक समझौते के मुताबिक कानूनी मकसदों के लिए किया जा सकता है.

किसी डोमेन के लिए, ऑथराइज़ेशन टोकन के सभी इवेंट वापस पाना

तीसरे पक्ष के ऐप्लिकेशन के लिए, अनुमति से जुड़े सभी इवेंट वापस पाने के लिए, यहां दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताए गए अनुमति टोकन को शामिल करें. अनुरोध क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें. आसानी से पढ़ने के लिए, नीचे दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

नीचे दिए गए उदाहरण में, पिछले 180 दिनों के लिए आपके खाते के सभी अनुमति इवेंट की रिपोर्ट मिलती है. maxResults क्वेरी पैरामीटर की मदद से, यह रिपोर्ट हर पेज पर 25 नतीजे दिखाती है.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25

इवेंट के नाम के हिसाब से, अनुमति देने वाले टोकन के इवेंट वापस पाना

कुछ मामलों में, आपको कुछ खास इवेंट वापस पाने की ज़रूरत पड़ सकती है. जैसे, किसी ऐप्लिकेशन का ऐक्सेस रद्द किया गया है या नहीं. इसके लिए, इस फ़ॉर्म के GET एचटीटीपी अनुरोध का इस्तेमाल करें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?maxResults=maximum number of events returned on a response page
&eventName=name of the OAuth token event

यहां दिए गए उदाहरण में, किसी डोमेन के लिए सभी revoke इवेंट को वापस पाने का तरीका बताया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25