---
title: 開発者ポータルのサブスクリプション
description: Tealium開発者ポータルでアプリケーションのAPIサブスクリプションを管理します。
url: https://docs.tealium.com/ja/administration/early-access/developer-portal/dev-portal-subscriptions/
---
サブスクリプションは、アプリケーションをTealium APIに接続します。サブスクライブする際には、アプリケーションのアクセストークンがカバーするリソースとアクションを決定するスコープを選択します。APIにサブスクライブする前に、少なくとも1つのアプリケーションを作成する必要があります。詳細については、[アプリケーション](https://docs.tealium.com/dev-portal-applications/)と[スコープ](https://docs.tealium.com/dev-portal-scopes/)を参照してください。


<blockquote>
アプリケーションプロセスを通じてAPIにサブスクライブすることをお勧めします。詳細については、[アプリケーション](https://docs.tealium.com/dev-portal-applications/)を参照してください。
</blockquote>


## APIカタログからAPIにサブスクライブする

すでに構成されたアプリケーションがある場合、APIカタログから直接APIにサブスクライブできます：

1. **APIカタログ**に移動し、APIを選択します。
1. **サブスクライブ**をクリックします。
1. プランを選択し、**次へ: スコープを選択**をクリックします。プランはセキュリティメカニズム（例：OAuth2またはJWT）を決定し、異なるレート制限があります。
1. スコープを選択し、**次へ: アプリケーションを選択**をクリックします。アプリケーションが必要とするリソースとアクションのペアを確認します。トークンには選択したスコープのみが含まれます。
1. このサブスクリプションのアプリケーションを選択し、**次へ: レビュー**をクリックします。
1. Tealiumユーザーとしてログインしている場合、APIがアカウントスコープのアクセスを要求する場合、**アカウントプロファイル**ステップが表示されます。このサブスクリプションにアクセスする必要があるTealiumアカウントとプロファイルを選択し、次に**次へ: エンジンを選択**または**次へ: レビュー**をクリックします。
   
<blockquote>
外部開発者はこのステップをスキップします。Tealiumの顧客リソースへのアクセスは、リソース所有者によって[サードパーティアプリアクセス](https://docs.tealium.com/dev-portal-third-party-app-access/)を通じて付与されます。
</blockquote>

1. 選択したAPIのいずれかがプレビュー中の場合、レビュー画面に警告が表示されます。組織がTealiumと早期アクセス契約を締結していること、およびアクセスを許可するアカウントプロファイルを確認したことを確認するボックスにチェックを入れます。**サブスクリプションを作成**ボタンは、ボックスにチェックを入れるまで無効のままです。
1. レビューを行い、**サブスクリプションを確認**をクリックします。

## 既存のアプリケーションに追加のAPIをサブスクライブする

1. **アプリケーション**に移動し、アプリケーションを選択します。
1. **APIにサブスクライブする**をクリックします。
1. サブスクライブしたいAPIを選択し、**次へ: スコープを構成**をクリックします。
1. スコープを選択します。アプリケーションが必要とする各リソースとアクションのペアを確認します。トークンには選択したスコープのみが含まれます。アプリケーションが必要とするもののみを要求します。
1. Tealiumユーザーとしてログインしている場合、**次へ: アカウントプロファイル**をクリックします。このサブスクリプションがカバーするTealiumアカウントとプロファイルを選択し、次に**次へ: エンジンを選択**または**次へ: レビュー**をクリックします。
   
<blockquote>
外部開発者は**次へ: レビュー（Nアプリが選択されました）**を見て、アカウントプロファイルとエンジンのステップをスキップします。
</blockquote>

1. エンジンを選択します（該当する場合）。Context APIなど、エンジンレベルのアクセスが必要なAPIの場合、**エンジンを選択**ステップが表示されます。エンジンはアカウントとプロファイル別にグループ化されます。特定のエンジンを選択するか、後で追加されるエンジンも含むように**すべてのエンジン（現在および将来）**を選択します。無効になっているエンジンも将来の使用のために選択できます。このステップをスキップして、後でエンジンアクセスを付与することもできます。
1. 選択したAPIのいずれかがプレビュー中の場合、レビュー画面に警告が表示されます。組織がTealiumと早期アクセス契約を締結していること、およびアクセスを許可するアカウントプロファイルを確認したことを確認するボックスにチェックを入れます。**サブスクリプションを作成**ボタンは、ボックスにチェックを入れるまで無効のままです。
1. 構成を確認し、確認します。

## エンジン選択

サブスクリプションに含まれる1つ以上のAPIがエンジンレベルの承認を要求する場合、エンジン選択ステップが表示されます。エンジンはアカウントとプロファイル別にグループ化されます。

* 名前またはIDで個々のエンジンを選択します。
* サブスクリプション後に作成されるエンジンを自動的に含むように**すべてのエンジン（現在および将来）**を選択します。
* 無効になっているエンジンも選択できます。それらは無効バッジとともに表示されます。
* エンジン選択はオプションです。サブスクリプション作成後にエンジンアクセスを追加または変更することができます。

サブスクリプションが作成された後、アプリケーション詳細ページの**エンジンアクセス**セクションからエンジンアクセスを更新できます。詳細については、[エンジンアクセス管理](https://docs.tealium.com/dev-portal-applications/#engine-access-management)を参照してください。

外部開発者の場合、アプリケーションにアクセスを許可するTealiumユーザーも承認フローで**エンジンを選択**ステップを完了します。詳細については、[サードパーティアプリアクセス](https://docs.tealium.com/dev-portal-third-party-app-access/)を参照してください。

## サブスクリプションの状態

APIにサブスクライブすると、サブスクリプションは次のいずれかの状態になります：

| 状態 | 意味 |
|---|---|
| 承認済み | アクティブで使用可能です。アプリケーションはサブスクライブしたスコープでトークンを要求できます。 |
| 保留中 | 処理を待っています。サブスクリプションは自動的に承認され、この状態は通常すぐに解決されます。 |
| 終了 | サブスクリプションは終了しました。これ以上API呼び出しを行うことはできません。アクセスを取り戻すには、新しいサブスクリプションを作成してください。 |

## サブスクリプションの管理

サイドバーの**サブスクリプション**に移動して、アプリケーション全体のすべてのサブスクリプションを表示します。ページ上部のドロップダウンを使用して、アプリケーションまたはAPI別にリストをフィルタリングできます。スコープチップにカーソルを合わせると、そのサブスクリプションに割り当てられた特定の権限が表示されます。

サブスクリプションを編集または終了するには、アプリケーションの詳細ページに移動し、**サブスクリプション**セクションを開きます。

## サブスクリプションの編集

アクティブなサブスクリプションのスコープをいつでも更新できます。

1. アプリケーションの詳細ページに移動します。
1. **サブスクリプション**セクションを開きます。
1. サブスクリプションの隣にある編集アイコンをクリックします。
1. 必要に応じてスコープを追加または削除します。
1. **保存**をクリックします。


<blockquote>
既存のアクセストークンは、有効期限が切れるまで元のスコープで引き続き機能します。トークンは2時間後に期限切れになります。新しいトークンリクエストは更新されたスコープセットを使用します。リソース所有者がアカウントにアプリケーションのアクセスを許可している場合、スコープの変更により、変更を確認するためのスコープドリフト通知がトリガーされる場合があります。
</blockquote>


アプリケーションがアクセスできるTealiumアカウントとプロファイルを編集するには、アプリケーションの詳細ページの**アカウントアクセス**セクションを使用します。詳細については、[アカウントアクセスの編集](https://docs.tealium.com/dev-portal-applications/#edit-account-access)を参照してください。