Copilot使用状況メトリック API では、事前に集計された 1 つのチーム レポートは発行されません。 チーム レベルのメトリックは、(特定の日の各ユーザーのチーム メンバーシップを一覧表示する) ユーザー チーム レポートと ユーザーごとの使用状況メトリック レポート (その日の各ユーザーの Copilot アクティビティを含む) を結合することによって構築されます。 結合された行を team_id で集計すると、チーム レベルのメトリックが生成されます。
この結合レシピは、必要なあらゆるチームレベルの切り出しに対応しています。たとえば、(team, day) ごと、(team, day, language) ごと、(team, day, IDE) ごと、ローリング ウィンドウ単位などです。
メモ
チーム レベルの導入の UI ベースのビューのみが必要な場合、影響ダッシュボードのユーザー チーム マッピングは、この記事で説明する結合を構築しなくても、チーム レベルの導入コーホート データをネイティブに表示します。 「Copilot影響ダッシュボードの表示」を参照してください。 カスタム BI レポートや、導入コーホートを超えたチーム レベルのメトリックなど、チームごとの生の NDJSON データが必要な場合は、以下で説明する手動参加を使用します。
レポートを取得しています
このガイドで参照されている 2 つのレポートは、2 つの手順でダウンロードされます。 最初に、必要な日に REST エンドポイントを呼び出します。 エンドポイントは、レポート ファイルをダウンロードできる時間制限付きの署名付き URL を返します。 次に、これらの URL が指す改行区切り JSON (NDJSON) ファイルをダウンロードします。 ユーザー チームとユーザーごとの行は、これらの NDJSON ファイル内にあります。これらは、REST エンドポイントによってインラインで返されません。
| レポート | エンドポイント |
|---|---|
| 組織のユーザー チーム | GET / |
| エンタープライズ ユーザー チーム | GET / |
| 組織のユーザーごとの使用状況メトリック | GET / |
| エンタープライズユーザーごとの使用状況メトリック | GET / |
各エンドポイントは、次の形式の応答を返します。
{
"download_links": [
"https://example.com/copilot-user-teams-report-1.ndjson"
],
"report_day": "2026-05-07"
}
リンクの有効期限ウィンドウ内の各 URL にファイルをダウンロードして、そのレポートの行を取得します。
完全な要求と応答のスキーマ、認証要件、および関連するエンドポイントについては、 Copilot使用状況メトリックの REST API エンドポイント を参照してください。 個々の使用状況メトリック フィールドの定義方法の概要については、 Copilot使用状況メトリックで使用可能なデータ を参照してください。
複数日の期間の場合は、1 日に 1 回毎日のエンドポイントを呼び出し、毎日の結果を集計します。 以下のローリングウィンドウ チーム レポートの作成を参照してください。
関連するレポート
チーム レベルのメトリックは、チーム メンバーシップのユーザー チーム レポートと、アクティビティのユーザーごとの使用状況メトリック レポートという 2 つのレポート ファミリに参加した場合に生じます。
ユーザー チーム レポート
これらのレポートには、特定の日に各ユーザーのチーム メンバーシップが一覧表示されます。
| レポート | Scope | 主要なフィールド |
|---|---|---|
organization_ | その日の組織、チームへの参加。 組織チームのみが含まれます。 | |
user_id、 user_login、 day、 organization_id、 team_id、 slug | ||
enterprise_user_ | その日のエンタープライズ チーム メンバーシップ。 エンタープライズ チームとビジネス チームの両方が含まれます。 | |
user_id、 user_login、 day、 enterprise_id、 team_id、 slug |
同じ日に複数のチームに属するユーザーは、複数の行 ( (user, team) ペアごとに 1 行) に表示されます。
重要
ユーザーが座っている Copilot が 5 人未満のチームは、ユーザー チーム レポートから除外されます。
影響：
- 特定の日に座っているユーザーが 5 人未満のチームは、メンバーがアクティビティを Copilot している場合でも、その日のユーザー チーム レポートには表示されません。 アクティビティはユーザーごとの使用状況メトリック レポートに残りますが、結合結果にチーム行は存在しません。
- 複数日の期間にしきい値を超えるチームは、一部の日に存在し、他のチームには存在しません。 チームがしきい値を超えている日のみが、その合計に影響します。
- チームの行を合計して企業または組織の合計と比較すると、合計はエンティティの合計よりも低くなります。 不足は、サブしきい値のチームにのみ属するユーザーからのアクティビティであり、参加結果にチーム行がないため、アクティビティはどのチーム集計にも表されません。
ユーザーごとの使用状況メトリック レポート
これらのレポートには、特定の日の各ユーザーの Copilot アクティビティが含まれます。
| レポート | Scope | 主要なフィールド |
|---|---|---|
organization_ | その日の組織内のユーザーの(user_id, day, organization_id)アクティビティを含むCopilotごとに 1 行。 | |
user_id、 day、 organization_id、 enterprise_id、アクティビティ カウンター、ブレークダウン配列 | ||
users_1_day | ||
(user_id, day, enterprise_id)ごとに 1 行、その日のエンタープライズ内でユーザーのCopilotアクティビティが表示されます。 | ||
user_id、 day、 enterprise_id、アクティビティ カウンター、ブレークダウン配列 |
これらのレポートで使用できるフィールドの完全な一覧については、 Copilot使用状況メトリックで使用可能なデータ を参照してください。
警告
ローリング 28 日間のユーザーごとのレポート (users_28_day、organization_users_28_day) を日次のユーザー チーム レポートと結合しないでください。 ユーザー チーム レポートには 1 日のチーム メンバーシップが反映されるため、1 日のメンバーシップ スナップショットに対して 28 日間のアクティビティに参加すると、ユーザーが参加日に属するチームに対する 28 日間のアクティビティの完全な属性が設定されます。 この誤った属性により、ウィンドウの間にチーム メンバーシップが変更されるたびに、アクティビティが間違ったチームに与えられます。 必ず日々の活動を日々のユーザーチームごとに集計し、その後、希望する期間ごとに集計してください。
エンティティ レベルのレポート
エンティティ レベルのレポート (enterprise_28_day、 organization_28_day、 enterprise_1_day、 organization_1_day) は、企業全体または組織全体の集計済みの合計です。
user_idやteam_idは含まれません。また、ユーザー チーム レポートに参加してチームごとの内訳を生成することはできません。 エンタープライズまたは組織の合計が必要な場合は、それらを直接使用します。チーム レベルの合計では、以下で説明する日単位のユーザー チーム + 毎日のユーザーごとのメトリック参加を使用します。
例
この最小限のエンドツーエンドの例では、1 日分の組織チームメトリックが生成されます。 各入力レポートの下のサンプル NDJSON 行は、そのレポートのいずれかの download_links からダウンロードしたファイルで見つかる行と似ています (上記の レポートのフェッチを 参照)。
2 人のユーザーは、組織のCopilotで 2026-05-07 に999アクティビティを行っています。
- Alice (
user_id=1001) は、frontend(team_id=42) とbackend(team_id=43) の 2 つのチームに属しています。 - Bob (
user_id=1002) は、frontend(team_id=42) にのみ属しています。
入力: organization_user_teams_1_day
{"user_id": 1001, "user_login": "alice", "day": "2026-05-07"