Method: projects.histories.list

किसी दिए गए प्रोजेक्ट के लिए इतिहास सूचीबद्ध करता है।

इतिहास को संशोधन समय के अनुसार अवरोही क्रम में क्रमबद्ध किया जाता है। इतिहास को उसी संशोधन समय के साथ क्रमबद्ध करने के लिए हिस्ट्रीआईडी ​​कुंजी का उपयोग किया जाएगा।

निम्नलिखित में से कोई भी विहित त्रुटि कोड लौटा सकता है:

  • PERMISSION_DENIED - यदि उपयोगकर्ता प्रोजेक्ट पढ़ने के लिए अधिकृत नहीं है
  • INVALID_ARGUMENT - यदि अनुरोध विकृत है
  • NOT_FOUND - यदि इतिहास मौजूद नहीं है

HTTP अनुरोध

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।

पथ पैरामीटर

पैरामीटर
projectId

string

एक प्रोजेक्ट आईडी.

आवश्यक।

क्वेरी पैरामीटर

पैरामीटर
pageToken

string

अगले आइटम पर क्वेरी फिर से शुरू करने के लिए एक निरंतरता टोकन।

वैकल्पिक।

pageSize

integer

लाने के लिए इतिहास की अधिकतम संख्या.

डिफ़ॉल्ट मान: 20। यदि फ़ील्ड सेट नहीं है या उसका मान 0 है तो सर्वर इस डिफ़ॉल्ट का उपयोग करेगा। 100 से अधिक कोई भी मान 100 माना जाएगा।

वैकल्पिक।

filterByName

string

यदि सेट किया गया है, तो केवल दिए गए नाम के साथ इतिहास लौटाएँ।

वैकल्पिक।

निकाय से अनुरोध करें

अनुरोध का मुख्य भाग खाली होना चाहिए.

प्रतिक्रिया निकाय

हिस्ट्रीसर्विस.लिस्ट के लिए प्रतिक्रिया संदेश

सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:

JSON प्रतिनिधित्व
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
खेत
histories[]

object ( History )

इतिहास.

nextPageToken

string

अगले आइटम पर क्वेरी फिर से शुरू करने के लिए एक निरंतरता टोकन।

केवल तभी सेट किया जाएगा जब लाने के लिए और अधिक इतिहास हों।

टोकन पहली सूची अनुरोध के समय से एक घंटे तक के लिए वैध हैं। उदाहरण के लिए, यदि आप दोपहर 1 बजे एक सूची अनुरोध करते हैं और 10 मिनट बाद इस पहले अनुरोध से टोकन का उपयोग करते हैं, तो इस दूसरी प्रतिक्रिया से टोकन केवल 50 मिनट के लिए वैध होगा।

प्राधिकरण के दायरे

निम्नलिखित OAuth दायरे की आवश्यकता है:

  • https://www.googleapis.com/auth/cloud-platform

अधिक जानकारी के लिए, प्रमाणीकरण अवलोकन देखें।