Use the Microsoft Search API to manage administrative answers
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
You can use Microsoft Graph to manage administrative search answer results in the Microsoft Search experience.
Requests to manage administrative search answers are performed by users with administrator roles, such as Search Administrators and Search Editors, or are performed on behalf of an application without the presence of a signed-in user, identified using an access token with application permission.
Common use cases
The use cases for the APIs in this section involve managing administrative answers such as acronyms, bookmarks, and QnAs for an organization.
| Use cases | REST resources |
|---|---|
| Search answer actions | |
| Create, update, or delete a search answer | acronym, bookmark, qna |
Supported language tags
A language tag of a bookmark or qna represents a geographically specific language in which that search answer (bookmark or qna) can be viewed. A language tag follows the pattern {language}-{region}. For information on the supported values for {language} and {region}, see RFC 4646.
Important
You must specify values for {language} and {region} in lower case.
The following table lists the language tags, locales, and the corresponding country or region that you can set in the Microsoft 365 admin center to publish a search answer. The Locale column describes the language as used in that country or region.
| Supported language tag | Locale | Choice of country or region in Microsoft 365 admin center |
|---|---|---|
es-ar |
Spanish (Argentina) | Argentina |
en-au |
English (Australia) | Australia |
de-at |
German (Austria) | Austria |
fr-be |
French (Belgium) | Belgium - French |
nl-be |
Dutch (Belgium) | Belgium - Dutch |
en-ca |
English (Canada) | Canada - English |
fr-ca |
French (Canada) | Canada - French |
fr-fr |
French (France) | France |
de-de |
German (Germany) | Germany |
zh-hk |
Chinese (Hong Kong) | Hong Kong |
en-in |
English (India) | India |
it-it |
Italian (Italy) | Italy |
pt-br |
Portuguese (Brazil) | Brazil |
en-id |
English (Indonesia) | Indonesia |
ja-jp |
Japanese (Japan) | Japan |
ko-kr |
Korean (South Korea) | Korea |
en-my |
English (Malaysia) | Malaysia |
es-mx |
Spanish (Mexico) | Mexico |
nl-nl |
Dutch (Netherlands) | Netherlands |
nb-no |
Norwegian Bokmål (Norway) | Norway |
zh-cn |
Chinese (China) | People's Republic of China |
pl-pl |
Polish (Poland) | Poland |
ru-ru |
Russian (Russia) | Russia |
ar-sa |
Arabic (Saudi Arabia) | Saudi Arabia |
sv-se |
Swedish (Sweden) | Sweden |
es-es |
Spanish (Spain) | Spain |
fr-ch |
French (Switzerland) | Switzerland - French |
de-ch |
German (Switzerland) | Switzerland - German |
en-za |
English (South Africa) | South Africa |
zh-tw |
Chinese (Taiwan) | Taiwan |
tr-tr |
Turkish (Turkey) | Turkey |
en-gb |
English (United Kingdom) | United Kingdom |
en-us |
English (United States) | United States - English |
es-us |
Spanish (United States) | United States - Spanish |
Next steps
- Learn about setting up administrative search answers for users in an organization.
- Drill down on the methods, properties, and relationships of the answer type resources: acronym, bookmark, and qna.
- See the Microsoft Search API overview.