このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(102.4, 38%, 19%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ERH%3C/text%3E%3C/svg%3E)
Graph API にて提供している以下のSharePointの「サイト名を検索する」の機能に関して、
仕様の確認をしたい項目がございます。
https://learn.microsoft.com/ja-jp/graph/api/site-search?view=graph-rest-1.0&tabs=http
GET https://graph.microsoft.com/v1.0/sites?search={query}
上記のGETメソッドではsearchのパラメータに"name"(サイト名)を指定すると、サイトを検索できますが、"displayName"(サイト表示名)を指定して検索することはできますか。
また、できない場合、"displayName"でサイトを検索する手段を他に提供していますか。
削除されてしまったので、再度。。
Search Sites APIはドキュメントにもある通り、
というものなので、displayNameも検索の対象です（逆に言うと、displayNameのみが検索対象ではない点にご注意ください）。
ご回答いただき、ありがとうございます。
検索のAPIに関して、以下の方法①および②を試行錯誤したのですが、気になる点があったので、追加で質問させていただけませんか。
方法①
GET 'https://graph.microsoft.com/v1.0/sites?search="キーワード"'
方法②
POST 'https://graph.microsoft.com/v1.0/search/query'
'Content-Type: application/json' \
{
"requests": [
{
"entityTypes": [
"site"
],
"query": {
"queryString": "キーワード" },
"fields": [
"id",
"displayName",
"name",
"createdDateTime",
"lastModifiedDateTime"
],
"sortProperties": [
{
"name": "CreatedDateTime",
"isDescending": false
}
]
}
]
}'
方法①および②の"キーワード"と記載された部分に"displayName"として検索したい文字列を置き換えてAPIを実行しました。
その結果、同じキーワードを指定したとしても、①と②のレスポンスから取得できるsiteが一致しませんでした。(①のみで取得できるものもあれば、②のみで取得できるものもありました。)
検索対象が"displayName"だけではないことはわかりますが、"displayName"に含まれている文字列をキーワードとして指定したのに、取得できてない場合があることが気になっています。
API呼び出しの方法の誤りや、上記現象の原因に関して、記載した情報からわかることがあったらご指摘いただけませんか。
また、情報が足りず、原因がわからない場合は、原因の特定に必要な情報としてほかに何があるか教えていただけませんか。
呼び出し方には間違いがありません。遭遇されている検索結果の違いは、端的に言うと利用している検索機能が違うためです。
GET /sites/search?query=... は、キーワードに一致するサイトを検索します。
Search across a SharePoint tenant for sites that match keywords provided. https://learn.microsoft.com/en-us/graph/api/site-search?view=graph-rest-1.0&tabs=http
対してPOST /search/query は、Microsoft Search にあるデータに対してクエリを実行します。
The Microsoft Search API provides a query method to search across your data in Microsoft Search, where you pass a searchRequest in the request body, defining the specifics of your search. https://learn.microsoft.com/en-us/graph/api/resources/search-api-overview?view=graph-rest-1.0#common-use-cases
確かに同じ結果を出してくれそうですが、このMicrosoft Searchは、Graph APIを参考にしつつも、ユーザーがアクセス可能な、そのユーザーに関連性のある結果を表示するため、同じものが出るとは限らない、ということが起こりえます。
Microsoft Search uses insights from the Microsoft Graph to show results that are relevant to each user. Each user might see different results, even if they search for the same words. They only see results that they already have access to, Microsoft Search doesn't change permissions.（Microsoft Graph からのインサイトを使って、各ユーザーに関連性のある結果を表示する。 各ユーザーが同じ単語を検索しても、それぞれの結果は異なる可能性がある。 既にアクセスできる結果のみを表示する。） https://learn.microsoft.com/ja-jp/microsoftsearch/overview-microsoft-search
ですので、何を検索対象にするか、によって使い分ける必要があります。
回答いただきありがとうございます。
たびたび申し訳ないですが、追加で質問がございます。
上記の質問から、私が検索したい対象を考慮すると、GET /sites/search?query=...が適切だとわかりました。
ここで、上記のAPIを用いて、検索時のトークン化のロジックを考慮して検索を試してみました。
結果は以下なのですが、期待結果と異なる部分があります。
こちらはなぜ期待結果と異なったか教えたいただけませんか。
・サイトのDisplayName：001(51メンバー) ・期待結果：「001(51メンバー)」、「メンバー」と「001」も全部ヒットできること ・実際の結果：「001」しかヒットできない
また、情報が足りず、原因がわからない場合は、原因の特定に必要な情報としてほかに何があるか教えていただけませんか。
このコメントは当社の行動規範に違反したため削除されました。 アクションを実行する前にこのコメントを手動で報告したか、自動検出機能により特定しました。 詳細については、当社の行動規範を参照してください。
テスト条件、サイトの構成がわからないので以下の前提でコメントします。
インデックス作成に時間がかかるため、001であればすぐにヒットしますが、メンバーなどのキーワードでヒットしないことがあります。とはいえ、時間が経過するとヒットします。
ご回答いただき、ありがとうございます。
回答を受け、別のアカウントで新たに"displayName": "001(51メンバー)"のsiteを作成し、Search Sites APIを実行したところ、示していただいた通り、各検索ワードで対象のsiteをヒットさせることができました。
ここで、新たに作成したsiteではヒットすることができたのに、その前に使用していたアカウントのsiteはヒットしなかったことが気になっており、その原因を考えています。
大雑把な質問になってしまい、大変申し訳ないのですが、siteの設定に関する部分(権限やsiteの種類、言語設定など)に関して、Search Sites APIでヒットしなかった原因など思い当たるものはありますでしょうか。
考えられるのは以下のあたりですが、ユーザー委任によるアクセス許可を使っていないのであれば（client_credentialsを使っているならば）、検索にヒットするはずです。
ご回答ありがとうございます。
現在検索にヒットするか検証中で、検証状況が以下の表のようになっています。
site名の文字列の一部で検索した際にヒットするものとヒットしないものがあり、その原因も、siteの設定からなかなか特定できてない状況です。
以下の表から原因として考えられることはありますでしょうか。
重ね重ね質問ばかりになってしまい申し訳ないのですが、教えていただけますと幸いです。
| site名 | 001(51メンバー) | 001(51メンバー) | 002(51メンバー) | 003(61メンバー) |
|---|---|---|---|---|
| 001(51メンバー)アカウント：****@5h81lf.onmicrosoft.com | 001(51メンバー)アカウント：****@lzjv.onmicrosoft.com | 002(51メンバー)アカウント：****@lzjv.onmicrosoft.com | 003(61メンバー)アカウント：****@lzjv.onmicrosoft.com | |
| サイトの種類 | チーム | コミュニケーション | コミュニケーション | チーム |
| プライバシー設定 | パブリック | - | - | プライベート |
| 権限設定 | 所有者 | 編集 | 編集 | メンバー |
| 言語設定 | 日本語 | 日本語 | 英語 | 英語 |
| 「00X」で検索できるか？ | 〇 | 〇 | 〇 | 〇 |
| 「メンバー」、またはsiteのフルネームで検索できるか？ | × | 〇 | × | 〇 |
事象の発生条件が見えない（たしかにバラバラに見える）ということですね。このあたりになると、製品サポートに問い合わせるのがよろしいかと思います。