利用開始

このセクションでは、組織のコスト管理を迅速に開始するために必要な最小限の設定について説明します。 組織 ( 組織 ) には、同じセキュリティ名前空間内のすべてのユーザー、アプリ、およびリソースが含まれています。 HERE platform にログインする場合は、組織 ID を入力する必要があります。

このセクションでは、コスト管理を使用してはじめに を迅速に作成する方法について説明します。

1. HERE アカウントを取得
2. 資格情報を入手する
3. アプリを登録します
4. OAuth トークンの入手
5. リクエストの送信
6. 次のステップ

HERE アカウントの取得

HERE platform Usage API にアクセスするには、 HERE アカウントを取得する必要があります。 詳細については 、「 HERE アカウントを取得する」を参照してください。

資格情報を入手します

REST API を使用するに credentials.properties は、ファイルが必要です。 このファイルは、 platform.here.com から入手できます。 credentials properties ファイルを作成したら、コンピューターの次のフォルダーに保存してください。

~/.here/credentials.properties

credentials.properties ファイルの入手方法の詳細については 、『 ID およびアクセス管理ガイド』を参照してください

アプリを登録します

アプリを登録するに は、『 ID およびアクセス管理ガイド』の「 OAuth トークン」の手順に従います。

アプリが登録されたので、 OAuth 2.0 トークンを取得してリクエストを認証できます。 HERE サービスへのリクエストごとに OAuth 2.0 トークン を取得するようにアプリケーションをコード化する必要があります。

OAuth トークンの入手

トークンを取得するには、複数の方法があります。

• CLI でトークンを入手できます
• SDK または API でトークンを入手できます

上記のいずれかの方法を実行した後、 API への REST リクエストの作成に使用するトークン を取得できました。

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

Authorization: Bearer <token>”

リクエストの送信

HERE アカウントを作成して資格情報 を取得したら、任意のリクエストを送信してアカウントをテストできます。 要求を送信する前に、 HTTP 認可ヘッダーにトークン を含めます。 リクエストに対する応答が成功すると、資格情報 が正しく設定されていることが確認されます。 たとえば、次のリクエストは、機能 ID を使用して使用状況を取得する方法を示しています。

機能 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

機能 ID での使用状況の取得に対する応答を次に示します。

    HTTP 20O 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
}

次のステップ

チュートリアルを参照 して、さまざまなコストシナリオを確認し、簡単な操作で Usage API を使用して組織ごとに使用できるようにする方法について説明することをお勧めします。 チュートリアルおよび応答で使用されるパラメータの詳細については 、『 API リファレンス』を参照してください。