- HTTP अनुरोध
- पथ पैरामीटर
- क्वेरी पैरामीटर
- निकाय से अनुरोध करें
- प्रतिक्रिया निकाय
- प्राधिकरण के दायरे
- इसे अजमाएं!
किसी दिए गए प्रोजेक्ट के लिए इतिहास सूचीबद्ध करता है।
इतिहास को संशोधन समय के अनुसार अवरोही क्रम में क्रमबद्ध किया जाता है। इतिहास को उसी संशोधन समय के साथ क्रमबद्ध करने के लिए हिस्ट्रीआईडी कुंजी का उपयोग किया जाएगा।
निम्नलिखित में से कोई भी विहित त्रुटि कोड लौटा सकता है:
- PERMISSION_DENIED - यदि उपयोगकर्ता प्रोजेक्ट पढ़ने के लिए अधिकृत नहीं है
- INVALID_ARGUMENT - यदि अनुरोध विकृत है
- NOT_FOUND - यदि इतिहास मौजूद नहीं है
HTTP अनुरोध
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।
पथ पैरामीटर
पैरामीटर | |
---|---|
projectId | एक प्रोजेक्ट आईडी. आवश्यक। |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageToken | अगले आइटम पर क्वेरी फिर से शुरू करने के लिए एक निरंतरता टोकन। वैकल्पिक। |
pageSize | लाने के लिए इतिहास की अधिकतम संख्या. डिफ़ॉल्ट मान: 20। यदि फ़ील्ड सेट नहीं है या उसका मान 0 है तो सर्वर इस डिफ़ॉल्ट का उपयोग करेगा। 100 से अधिक कोई भी मान 100 माना जाएगा। वैकल्पिक। |
filterByName | यदि सेट किया गया है, तो केवल दिए गए नाम के साथ इतिहास लौटाएँ। वैकल्पिक। |
निकाय से अनुरोध करें
अनुरोध का मुख्य भाग खाली होना चाहिए.
प्रतिक्रिया निकाय
हिस्ट्रीसर्विस.लिस्ट के लिए प्रतिक्रिया संदेश
सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:
JSON प्रतिनिधित्व |
---|
{
"histories": [
{
object ( |
खेत | |
---|---|
histories[] | इतिहास. |
nextPageToken | अगले आइटम पर क्वेरी फिर से शुरू करने के लिए एक निरंतरता टोकन। केवल तभी सेट किया जाएगा जब लाने के लिए और अधिक इतिहास हों। टोकन पहली सूची अनुरोध के समय से एक घंटे तक के लिए वैध हैं। उदाहरण के लिए, यदि आप दोपहर 1 बजे एक सूची अनुरोध करते हैं और 10 मिनट बाद इस पहले अनुरोध से टोकन का उपयोग करते हैं, तो इस दूसरी प्रतिक्रिया से टोकन केवल 50 मिनट के लिए वैध होगा। |
प्राधिकरण के दायरे
निम्नलिखित OAuth दायरे की आवश्यकता है:
-
https://www.googleapis.com/auth/cloud-platform
अधिक जानकारी के लिए, प्रमाणीकरण अवलोकन देखें।