You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The `search` query string option is available for consumer notebooks only.
78
-
79
77
The default sort order for pages is `lastModifiedTime desc`.
80
78
81
79
The default query expands the parent section and selects the section's `id`, `name`, and `self` properties.
@@ -288,7 +286,7 @@ For more information about GET requests, see the following resources in the Micr
288
286
289
287
## Example GET requests
290
288
291
-
You can query for OneNote entities and search page content to get just the information you need. The following examples show some ways you can use [supported query string options](#supported-odata-query-string-options) in GET requests to Microsoft Graph.
289
+
You can query for OneNote entities to get just the information you need. The following examples show some ways you can use [supported query string options](#supported-odata-query-string-options) in GET requests to Microsoft Graph.
292
290
293
291
**Remember:**
294
292
@@ -304,20 +302,19 @@ You can query for OneNote entities and search page content to get just the infor
304
302
305
303
**Example**: `filter=tolower(name) eq 'spring'`
306
304
307
-
### search & filter
308
-
309
-
Get all pages that contain the term *recipe* that were created by a specific app (`search` is available for consumer notebooks only).
305
+
### filter
310
306
307
+
Get all pages that were created by a specific app.
Get the title, OneNote client links, and **contentUrl** link for all pages that contain the term *golgi app* (`search` is available for consumer notebooks only).
314
+
Get the title, OneNote client links, and **contentUrl** link for all pages.
Get the five newest pages created since January 1, 2015 that contain the phrase *cell division*. The API returns 20 entries by default with a maximum of 100. The default sort order for pages is `lastModifiedTime desc` (`search` is available for consumer notebooks only).
438
+
Get the five newest pages created since January 1, 2015. The API returns 20 entries by default with a maximum of 100. The default sort order for pages is `lastModifiedTime desc`.
442
439
443
440
```
444
-
[GET] ../pages?search="cell division"&filter=createdTime ge 2015-01-01&top=5
441
+
[GET] ../pages?filter=createdTime ge 2015-01-01&top=5
445
442
```
446
443
447
-
### search & filter & top & skip
444
+
### filter & top & skip
448
445
449
-
Get the next five pages in the result set (`search` is available for consumer notebooks only).
446
+
Get the next five pages in the result set .
450
447
451
448
```
452
-
[GET] ../pages?search=biology&filter=createdTime ge 2015-01-01&top=5&skip=5
449
+
[GET] ../pages?filter=createdTime ge 2015-01-01&top=5&skip=5
453
450
```
454
451
455
452
<br/>
456
453
457
-
And the next five (`search` is available for consumer notebooks only).
454
+
And the next five.
458
455
459
456
```
460
-
[GET] ../pages?search=biology&filter=createdTime ge 2015-01-01&top=5&skip=10
457
+
[GET] ../pages?filter=createdTime ge 2015-01-01&top=5&skip=10
461
458
```
462
459
463
460
> [!NOTE]
464
-
> If both **search** and **filter** are applied to the same request, the results include only those entities that match both criteria.
461
+
> If both **top** and **filter** are applied to the same request, the results include only those entities that match both criteria.
465
462
466
463
### select
467
464
@@ -522,7 +519,6 @@ When sending GET requests to Microsoft Graph, you can use OData query string opt
522
519
| expand | <p>`expand=sections,sectionGroups`</p><p>The navigation properties to return inline in the response. The following properties are supported for **expand** expressions:<br /> - Pages: **parentNotebook**, **parentSection**<br /> - Sections: **parentNotebook**, **parentSectionGroup**<br /> - Section groups: **sections**, **sectionGroups**, **parentNotebook**, **parentSectionGroup**<br /> - Notebooks: **sections**, **sectionGroups**</p><p>By default, GET requests for pages expands **parentSection** and select the section's **id**, **name**, and **self** properties. Default GET requests for sections and section groups expand both **parentNotebook** and **parentSectionGroup**, and select the parents' **id**, **name**, and **self** properties. </p><p>Can be used for a single entity or a collection.<br />Separate multiple properties with commas.<br />Property names are case-sensitive.</p> |
523
520
| filter | <p>`filter=isDefault eq true`</p><p>A Boolean expression for whether to include an entry in the result set. Supports the following OData operators and functions:<br /> - Comparison operators: **eq**, **ne**, **gt**, **ge**, **lt**, **le**<br /> - Logical operators: **and**, **or**, **not**<br /> - String functions: **contains**, **endswith**, **startswith**, **length**, **indexof**, **substring**, **tolower**, **toupper**, **trim**, **concat**</p><p>[Property](#onenote-entity-properties) names and OData string comparisons are case-sensitive. We recommend using the OData **tolower** function for string comparisons.<br /><br />**Example**: `filter=tolower(name) eq 'spring'`</p> |
524
521
| orderby | <p>`orderby=title,createdTime desc`</p><p>The [properties](#onenote-entity-properties) to sort by, with an optional **asc** (default) or **desc** sort order. You can sort by any property of the entity in the requested collection.</p><p>The default sort order for notebooks, section groups, and sections is `name asc`, and for pages is `lastModifiedTime desc` (last modified page first).</p><p>Separate multiple properties with commas, and list them in the order that you want them applied. Property names are case-sensitive.</p> |
525
-
| search | <p>`search=cell div`</p><p>Available for consumer notebooks only.</p><p>The term or phrase to search for in the page title, page body, image alt text, and image OCR text. By default, search queries return results sorted by relevance.</p><p>OneNote uses Bing full-text search to support phrase search, stemming, spelling forgiveness, relevance and ranking, word breaking, multiple languages, and other full-text search features. Search strings are case-insensitive.</p><p>Applies only to pages in notebooks owned by the user. Indexed content is private and can only be accessed by the owner. Password-protected pages are not indexed. Applies only to the `pages` endpoint.</p> |
526
522
| select | <p>`select=id,title`</p><p>The [properties](#onenote-entity-properties) to return. Can be used for a single entity or for a collection. Separate multiple properties with commas. Property names are case-sensitive.</p> |
527
523
| skip | <p>`skip=10`</p><p>The number of entries to skip in the result set. Typically used for paging results.</p> |
528
524
| top | <p>`top=50`</p><p>The number of entries to return in the result set, up to a maximum of 100. The default value is 20.</p> |
0 commit comments