[comment]: # translation:outdated

[comment]: # ({669b84c5-669b84c5})
# trend.get

[comment]: # ({/669b84c5-669b84c5})

[comment]: # ({2eafea1f-b49a69bd})
### 説明

`integer/array trend.get(object parameters)`

このメソッドでは、指定されたパラメーターを基にトレンドデータを取得できます。

::: noteclassic
このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で
取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。
:::

[comment]: # ({/2eafea1f-b49a69bd})

[comment]: # ({9df42989-e33350ec})
### パラメータ

`(object)` 目的の出力を定義するパラメーター

このメソッドは、次のパラメーターをサポートします。

|パラメータ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|itemids|string/array|指定されたアイテムIDのトレンドのみを返します|
|time\_from|timestamp|指定された時間以降またはその時点で収集された値のみを返します|
|time\_till|timestamp|指定された時間より前またはその時点で収集された値のみを返します|
|countOutput|boolean|取得したオブジェクトの数を数えます|
|limit|integer|取得するオブジェクトの量を制限します|
|output|query|出力フィールドを設定します|

[comment]: # ({/9df42989-e33350ec})

[comment]: # ({7223bab1-7223bab1})
### 戻り値

`(integer/array)` 次のいずれかを返します:

-   オブジェクトの配列
-   `countOutput`パラメータが使用されている場合、取得されたオブジェクトの数

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### 例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({60283432-98fd9c3f})
#### アイテムのトレンドデータ取得

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "trend.get",
    "params": {
        "output": [
            "itemid",
            "clock",
            "num",
            "value_min",
            "value_avg",
            "value_max",
        ],
        "itemids": [
            "23715"
        ],
        "limit": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "23715",
            "clock": "1446199200",
            "num": "60",
            "value_min": "0.165",
            "value_avg": "0.2168",
            "value_max": "0.35",
        }
    ],
    "id": 1
}
```

[comment]: # ({/60283432-98fd9c3f})

[comment]: # ({852a9753-852a9753})
### ソース

CTrend::get() in *ui/include/classes/api/services/CTrend.php*.

[comment]: # ({/852a9753-852a9753})