プロジェクト統計

プラン: Free、Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

プロジェクト統計へのすべてのAPIコールは、認証されなければなりません。これらの統計を取得するには、リポジトリへの読み取りアクセスが必要です。

パーソナルアクセストークンで使用するには、read_apiスコープのトークンを使用します。グループアクセストークンの場合、レポーターロールとread_apiスコープを使用できます。

このAPIは、プロジェクトがHTTPメソッドでクローンまたはプルされた回数を取得します。SSHのフェッチは含まれていません。

過去30日間の統計情報を取得する

過去30日間のプロジェクトのクローンとプルの統計情報を取得します。

GET /projects/:id/statistics

サポートされている属性は以下のとおりです:

属性	型	必須	説明
`id`	整数または文字列	はい	プロジェクトのIDまたはURLエンコードされたパス。

成功した場合、200 OKと次のレスポンス属性を返します:

属性	型	説明
`fetches`	オブジェクト	プロジェクトのフェッチ統計。
`fetches.days`	配列	毎日のフェッチ統計の配列。
`fetches.days[].count`	整数	特定の日付のフェッチ数。
`fetches.days[].date`	文字列	形式の日付（`YYYY-MM-DD`）。
`fetches.total`	整数	過去30日間のフェッチの合計数。

リクエスト例:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/42/statistics"

レスポンス例:

{
  "fetches": {
    "total": 50,
    "days": [
      {
        "count": 10,
        "date": "2018-01-10"
      },
      {
        "count": 10,
        "date": "2018-01-09"
      },
      {
        "count": 10,
        "date": "2018-01-08"
      },
      {
        "count": 10,
        "date": "2018-01-07"
      },
      {
        "count": 10,
        "date": "2018-01-06"
      }
    ]
  }
}