appIdによる使用量のcsv取得方法

このチュートリアルでは、appIdによるcsv形式での使用量の取得方法を説明します。

このサンプルリクエストでは、realmIdに_org12346789_、startDateに_2021-07-01T10:39:51_、endDateに_2021-08-30T10:39:51_、appIdに_j1dasda012edasfgne_を使用しています。

    GET https://usage.bam.api.here.com/v2/usage/realms/org123456789/csv?startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&appId=j1dasda012edasfgne

パラメーター

ここに示されているパラメーターは、このサンプルリクエストに必要なパラメーターのみです。パラメーターの全リストは、コスト管理の使用量API v2 APIリファレンスを参照してください。


realmId required	文字列[ 5 ...30 ]文字。 _例：_org123456789 組織ID。
startDate 必須	文字列"date-time"。例：startDate=yyyy-MM-dd'T'HH:mm:ss 検索する期間の開始日。
endDate 必須	文字列"date-time"。例：endDate=yyyy-MM-dd'T'HH:mm:ss 検索する期間の終了日。
appId	128文字以下の文字列例：appId=j1dasda012edasfgne クライアントアプリID。これはプラットフォームが作成したアプリIDです。

ヘッダーパラメーター


X-Request-ID	string サービスに送信された単一のリクエストまたは一連のリクエストを追跡するユーザー提供のトークン。
X-Correlation-ID 必須	string 自動生成されるID。リクエストを一意に識別し、レスポンスで利用可能。サポートチームに特定のリクエストの問い合わせを行う場合は、このヘッダーの値を共有します。こちらは問題のトラブルシューティングで役に立ちます。

レスポンス：HTTP 200 OK

csv形式のレスポンスには、次の列が一覧表示されます。

カテゴリー (category)：カテゴリーとは選択した請求可能なサービスの名前で、位置情報サービス、コンテンツ、SDK、データ、パイプラインなどです。
サービス名またはリソース名：Navigate SDK、Network Positioning、3D Buildingsなどのサービス。
請求タグ (billingTag)：コストの結合に使用されるユーザー定義の一意の文字列。
プロジェクトID (projectHrn)：(任意) 作業とリソースを管理するための一意の識別子。これはプロジェクトHRNとも呼ばれます。
開始日 (startDate)：使用の開始日。
終了日 (endDate)：使用の終了日。
使用量 (billableValue)：発生した請求可能な使用量。
単位 (valueDriver)：請求可能な単位 (GBなど)。
単位あたりの料金：単位あたりの請求可能料金。
合計価格：算出された使用量コスト。

パートナーの場合はcsv出力にもう1列追加されます。追加される列は組織の名前 (orgName) です。