feat: add getAppStatistics api

[nameless-mc]

Why

kintone REST APIに2024年8月15日に追加された「アプリの使用状況を取得する」API (GET /k/v1/apps/statistics.json) をJava Clientでサポートするため。

ref: https://cybozu.dev/ja/kintone/docs/rest-api/apps/get-apps-statistics/

このAPIにより、アプリのレコード数、フィールド数、API呼び出し数、ストレージ使用量などの使用状況統計情報を取得できるようになります。

What

以下のクラスとメソッドを追加しました：

新規クラス:

• GetAppsStatisticsRequest - リクエストパラメータ（offset、limit）
• GetAppsStatisticsResponseBody - レスポンスボディ
• AppStatistics - アプリ使用状況統計情報のモデル
  • App ID、名前、スペース情報、ステータス、レコード更新日時、レコード数、フィールド数、日次API呼び出し数、ストレージ使用量、カスタマイズ有無、作成者/
    作成日時、更新者/更新日時
• AppStatisticsStatus - アプリステータスのenum（CHANGED、NOT_ACTIVATED、ACTIVATED）
• AppSpace - スペース情報のモデル（ID、名前）

変更:

• KintoneApi - GET_APPS_STATISTICSエンドポイントを追加
• AppClient - 以下の2つのメソッドを追加
  • getStatistics(GetAppsStatisticsRequest request) - パラメータ付きでアプリ統計情報を取得
  • getStatistics() - アプリの統計情報を取得（パラメータなし）

How to test

Checklist

• Read CONTRIBUTING.md at the repository.
• Updated documentation if it is required.
• Added/updated tests if it is required. (or tested manually)

[Copilot]

Pull Request Overview

This PR adds support for the kintone REST API's "Get Apps Statistics" endpoint (GET /k/v1/apps/statistics.json) that was added on August 15, 2024. This API allows retrieval of app usage statistics including record counts, field counts, API call counts, and storage usage.

Key changes:

• Added new model classes for app statistics data structures
• Added request/response classes for the new API endpoint
• Extended AppClient with two new methods to retrieve app statistics
• Added comprehensive unit tests for the new functionality

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
AppClient.java	Added getStatistics() methods with and without parameters to retrieve app usage statistics
KintoneApi.java	Added GET_APPS_STATISTICS enum constant for the new API endpoint
GetAppsStatisticsRequest.java	New request class with offset and limit parameters for pagination
GetAppsStatisticsResponseBody.java	New response class containing list of app statistics
AppStatistics.java	New model class representing detailed app usage statistics
AppStatisticsStatus.java	New enum defining app status values (CHANGED, NOT_ACTIVATED, ACTIVATED)
AppSpace.java	New model class for space information (ID and name)
AppClientTest.java	Added unit tests for the new statistics methods

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.