YouTrack および Hub ヘルプの開発者ポータル

QueryAssist を入手する

リクエスト

GET [[[<REST API URL>|Hub-Rest-Api-URL.html]]]/usergroups/queryAssist?query=string&amp;caret=int

パラメーター

説明

query

オプション。検索クエリを指定して、返される結果をフィルタリングできます。サポートされている論理演算構文の定義については、照会の構文を参照してください。UserGroups では、以下のフィールドとタプルがサポートされています。

access ( project : project , with : role ) — 指定されたプロジェクトで指定されたロールを持つグループ

access ( project : project , with : permission ) — 指定されたプロジェクトで指定された権限を持つグループ

access ( project : project ) — 特定のプロジェクトで何らかのロールを持つグループ

access ( with : role ) — 指定されたロールが割り当てられたグループ

access ( with : permission ) — 与えられた権限がどこにでも付与されているグループ

has : ownRole — 独自のロールを持つグループ

has : user — ユーザーとのグループ

has : subgroup — サブグループを持つグループ

has : icon — アイコン付きのグループ

id : value — 指定された ID のグループ

is : allUsers — すべてのユーザーグループ

is : registeredUsers — 登録ユーザーグループ

is : autoJoin — 自動参加が有効になっているグループ

is : required2FA — 必要な二要素認証を使用するグループ

is : removedFromIdp — アイデンティティプロバイダから削除されたグループ

name : groupName — 名のグループ

ownRole : role — 独自のロールとして特定のロールを持つグループ

parent : group — 特定のグループのサブグループ

project : project — 特定のプロジェクトのグループ

subgroup : group — 指定されたグループをサブグループとして含むグループ

user : user — 特定のユーザーをすぐに含むグループ

caret

型 int のクエリパラメーター。

レスポンス

レスポンスコード

意味

200 OK

リクエストが成功しました。

400 不正な要求

リクエストパラメーターの少なくとも 1 つが無効です。例: 渡された JSON オブジェクトの必須フィールドがありません。詳細については、応答のエラーメッセージを確認してください。

403 禁止します

要求元は、要求されたリソースにアクセスできません。

404 お探しのページが見つかりませんでした

要求されたリソースが見つかりませんでした。

500 内部サーバーエラー

サーバーエラーのため、リクエストの処理に失敗しました。詳細については、応答のエラーメッセージを確認してください。

レスポンスボディ

{ "query": string, "caret": int, "styleRanges": [[[[queryStyleRange|HUB-REST-API_JSON-Scheme.html#queryStyleRange]]], ...], "suggestions": [[[[querySuggestItem|HUB-REST-API_JSON-Scheme.html#querySuggestItem]]], ...] }
2026 年 3 月 23 日