Method: notes.list
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
नोट की सूचियां.
हर सूची कॉल, नतीजों का एक पेज दिखाता है. इसमें, दिखाए गए आइटम की ऊपरी सीमा के तौर पर pageSize
होता है. pageSize
को शून्य पर सेट करने पर, सर्वर को ऊपरी सीमा चुनने की अनुमति मिलती है.
ListNotesResponse में ज़्यादा से ज़्यादा pageSize
एंट्री हो सकती हैं. अगर सूची में और चीज़ें जोड़नी हैं, तो यह nextPageToken
वैल्यू दिखाता है. (पेज टोकन, ओपेक वैल्यू होते हैं.)
नतीजों का अगला पेज पाने के लिए, नतीजे के nextPageToken
को अगले अनुरोध के pageToken
में कॉपी करें. यह प्रक्रिया तब तक दोहराएं, जब तक नतीजों वाले पेज के साथ दिखाया गया nextPageToken
खाली न हो जाए.
notes.list फ़ंक्शन, एक साथ होने वाले बदलावों के बावजूद एक जैसे नतीजे दिखाता है. इसके अलावा, ABORTED गड़बड़ी का कोड दिखाकर यह भी बताता है कि वह ऐसा नहीं कर सकता.
एचटीटीपी अनुरोध
GET https://keep.googleapis.com/v1/notes
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
क्वेरी पैरामीटर
पैरामीटर |
pageSize |
integer
कितने नतीजे दिखाने हैं.
|
pageToken |
string
पिछले पेज का nextPageToken फ़ील्ड.
|
filter |
string
सूची के नतीजों को फ़िल्टर करना. अगर कोई फ़िल्टर नहीं दिया जाता है, तो trashed फ़िल्टर डिफ़ॉल्ट रूप से लागू होता है. फ़िल्टर करने के लिए मान्य फ़ील्ड: createTime , updateTime , trashTime , और trashed . फ़िल्टर सिंटैक्स, Google AIP फ़िल्टरिंग स्पेसिफ़िकेशन का पालन करता है.
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
नोट के पेज की सूची बनाते समय मिलने वाला जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
{
"notes": [
{
object (Note )
}
],
"nextPageToken": string
} |
फ़ील्ड |
notes[] |
object (Note )
नोट वाला पेज.
|
nextPageToken |
string
अगले पेज का pageToken फ़ील्ड.
|
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/keep
https://www.googleapis.com/auth/keep.readonly
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-07-25 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-07-25 (UTC) को अपडेट किया गया."],[],[],null,["# Method: notes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNotesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists notes.\n\nEvery list call returns a page of results with `pageSize` as the upper bound of returned items. A `pageSize` of zero allows the server to choose the upper bound.\n\nThe ListNotesResponse contains at most `pageSize` entries. If there are more things left to list, it provides a `nextPageToken` value. (Page tokens are opaque values.)\n\nTo get the next page of results, copy the result's `nextPageToken` into the next request's `pageToken`. Repeat until the `nextPageToken` returned with a page of results is empty.\n\nnotes.list return consistent results in the face of concurrent changes, or signals that it cannot with an ABORTED error.\n\n### HTTP request\n\n`GET https://keep.googleapis.com/v1/notes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results to return. |\n| `pageToken` | `string` The previous page's `nextPageToken` field. |\n| `filter` | `string` Filter for list results. If no filter is supplied, the `trashed` filter is applied by default. Valid fields to filter by are: `createTime`, `updateTime`, `trashTime`, and `trashed`. Filter syntax follows the [Google AIP filtering spec](https://aip.dev/160). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response when listing a page of notes.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"notes\": [ { object (/workspace/keep/api/reference/rest/v1/notes#Note) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------|\n| `notes[]` | `object (`[Note](/workspace/keep/api/reference/rest/v1/notes#Note)`)` A page of notes. |\n| `nextPageToken` | `string` Next page's `pageToken` field. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/keep`\n- `https://www.googleapis.com/auth/keep.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]