ガイドAPIリファレンス
ガイド
  1. コスト管理開発ガイド

コスト管理の利用開始

ここでは、組織のコスト管理を速やかに開始するための必要最低限のセットアップに関する情報について説明します。組織 (org) には同じセキュリティ名前空間内のすべてのユーザー、アプリ、リソースが含まれます。HEREプラットフォームにサインインする際には、組織IDを入力する必要があります。

📘

注

この文脈では、「レルム」とは「組織」のことを意味します。詳しくは、「個人または組織のプラットフォームアカウントを管理する」を参照してください。

コスト管理の使用を速やかに開始するには、次の手順を実行します。

ステップ1：HEREアカウントを取得する

組織管理者からの招待状を通じて、または弊社に連絡して利用を開始して、HEREプラットフォームへのアクセスを入手します。

  • 会社がすでにHEREプラットフォーム組織を設立している場合は、組織への参加に招待できる管理者に連絡してください。
  • 会社がまだHEREプラットフォーム組織を設立していない場合は、当社までお問い合わせください。

ステップ2：資格情報を取得する

コスト管理の使用量APIには、credentials.propertiesファイルが必要です。このファイルをコンピューターの以下のフォルダーに置く必要があります。

~/.here/credentials.properties

詳細については、Identity and Access Managementの開発者ガイドを参照してください。

ステップ3：アプリを登録する

アプリの登録方法については、Identity and Access Managementの開発者ガイドを参照してください アプリの登録が完了したら、リクエストを認証するためのOAuth 2.0トークンを取得できます。アプリをコーディングして、HEREサービスへのリクエストごとにOAuth 2.0トークンを取得する必要があります。

OAuth 2.0トークンを取得する

OAuth 2.0トークンの取得方法については、Identity & Access Management - 開発者ガイドを参照してください。

OAuth 2.0トークンをベアラートークンとしてリクエストのHTTP承認ヘッダーに含めます。

Authorization: Bearer <token>”

ステップ4：リクエストを送信する

フィーチャーIDを使用して使用量リクエストを送信するコード例を以下に示します。

サンプルコードでは、realmIdに_org123456789_を、featureIdに_hrn:here:service::org123456789:search-geocoding-1_を使用しています。

       GET https://usage.bam.api.here.com/v2/usage/realms/org123456789?startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&featureId=hrn:here:service::org123456789:search-geocoding-1

レスポンスHTTP 200 OK

リクエストは次のサンプルレスポンスを返します。

{
  "total": 10,
  "limit": 100,
  "items": [
    {
      "realmId": "org123456789",
      "billingSubscriptionId": "",
      "billingChargeNumber": "",
      "featureId": "hrn:here:service::org123456789:search-geocoding-1",
      "category": "service",
      "name": "Geocoder Autosuggest",
      "valueDriver": "Transactions",
      "usageValue": "10",
      "billableValue": "10"
    },
  ],
  "nextOffset": 0,
  "lastOffset": 0
}

次のステップ

このドキュメントのチュートリアルを確認します。チュートリアルでは、さまざまなコスト管理シナリオが説明されています。詳細については、コスト管理の使用量API v2 APIリファレンスを参照してください。

21 日前の更新