メインコンテンツへスキップ
GET
消費量分析を取得する
これはv2 エンドポイントで、リクエストボディでサービスキーを使用する v1 Analytics API とは異なり、Bearerトークン認証とクエリパラメータを使用します。詳細は以下のAuthenticationを参照してください。
このエンドポイントはリアルタイムの使用量監視向けではありません。データは1時間単位で集計され、 レート制限も低く設定されています (チームごとに1時間あたり10リクエスト) 。定期レポートや一括エクスポートに利用してください。

認証

このエンドポイントでは、Bearer token認証を利用します。Authorization ヘッダーにサービスキーを含めてください。
サービスキーには、Analytics Read 権限が付与されている必要があります。チーム設定 の “Service Keys” で作成してください。

請求方式

レスポンスの形式は、チームの請求方式によって異なります。 message_count フィールド (consumption 内) は、請求方式に関係なく常に設定されます。

グループ化と粒度

granularitygroup_by を利用して、返されるデータの形式を制御できます。
  • 粒度やグループ化の指定なし — 日付範囲全体を集計した単一の行を返します
  • granularity=daily — 各行に YYYY-MM-DD 形式の timestamp が含まれます
  • granularity=monthly — 各行に YYYY-MM 形式の timestamp が含まれます
  • group_by=user — 各行に user_iduser_email が含まれます
  • group_by=user,model_uid — 各行に user_iduser_emailmodel_uid が含まれます
  • group_by=ide — 各行に ide が含まれます
  • group_by=ide,ide_version — 各行に ideide_version が含まれます (ide_version でグループ化するには、ide も含める必要があります)
結果は、デフォルトで 1,000 行 (最大 10,000 行) ごとにページ分割されます。さらに結果がある場合、レスポンスの pagination オブジェクトには next_page_cursor が含まれます。次のページを取得するには、これを page_cursor クエリ パラメータとして渡します。 ページカーソルは 24 時間で失効します。後続のページリクエストは、レート制限に対する新たなクエリとしてはカウントされません。

キャッシュ

レスポンスには ETag ヘッダーが含まれます。不要なデータ転送を避けるには、以前の ETag 値を指定した If-None-Match ヘッダーを含めてください。データが変更されていない場合、サーバーは 304 Not Modified を返します。

レート制限

このエンドポイントには、チームごとに1時間あたり10リクエストのレート制限があります。この 制限を超えると、サーバーは Retry-After ヘッダーとともに 429 Too Many Requests を返します。 前にクエリした結果のページネーション (next_page_cursor に従うこと) は、この制限にはカウントされません— カウントされるのは、各レポートに対して初回にクエリする場合のみです。制限値が低く設定されているのは、このエンドポイントが 定期的なレポート用であり、リアルタイムの使用量監視を目的としたものではないためです。

承認

Authorization
string
header
必須

Authorization ヘッダーで Bearer トークンとして渡す、Analytics Read 権限を持つサービスキー。

サービスキーは、チーム設定 の「Service Keys」セクションで作成します。

ヘッダー

If-None-Match
string

以前のレスポンスの ETag 値。データが変更されていない場合、サーバーは 304 Not Modified を返します。

クエリパラメータ

start_date
string<date>
必須

日付範囲の開始日(この日を含む)。形式は YYYY-MM-DD です。

end_date
string<date>
必須

日付範囲の終了日(この日を含む)。形式は YYYY-MM-DD です。範囲は 90 日を超えてはいけません。

product
enum<string>
必須

消費量をクエリする対象の product。

利用可能なオプション:
agent
granularity
enum<string>

結果をグループ化する時間粒度。指定した場合、各行に timestamp フィールドが含まれます。 省略した場合、結果は日付範囲全体で集計されます。

利用可能なオプション:
daily,
monthly
group_by
string

結果のグループ化に利用するディメンションのカンマ区切りリスト。サポートされているディメンション:

  • user — 各行に user_iduser_email が含まれます
  • model_uid — 各行に model_uid が含まれます
  • ide — 各行に ide が含まれます
  • ide_version — 各行に ide_version が含まれます。ide も含める必要があります
models
string

結果の絞り込み対象とする model UID のカンマ区切りリスト。

group_id
string

結果を特定の group に属する user に絞り込みます。サービスキーにはこの group へのアクセス権が必要です。

user_id
string

結果を特定の user(auth UID)に絞り込みます。

page_size
integer
デフォルト:1000

1 ページあたりに返す最大行数。

必須範囲: 1 <= x <= 10000
page_cursor
string

次のページを取得するための、以前のレスポンスの pagination.next_page_cursor に含まれる不透明なカーソル。

レスポンス

消費量データが正常に返されました。

data
object[]
必須

消費量データ行の配列。

pagination
object
必須
metadata
object
必須