Tealium開発者ポータルでアプリケーションのAPIサブスクリプションを管理します。
サブスクリプションは、アプリケーションをTealium APIに接続します。サブスクライブする際には、アプリケーションのアクセストークンがカバーするリソースとアクションを決定するスコープを選択します。APIにサブスクライブする前に、少なくとも1つのアプリケーションを作成する必要があります。詳細については、アプリケーションとスコープを参照してください。
アプリケーションプロセスを通じてAPIにサブスクライブすることをお勧めします。詳細については、アプリケーションを参照してください。
APIカタログからAPIにサブスクライブする
すでに構成されたアプリケーションがある場合、APIカタログから直接APIにサブスクライブできます:
APIカタログに移動し、APIを選択します。
サブスクライブをクリックします。
プランを選択し、次へ: スコープを選択をクリックします。プランはセキュリティメカニズム(例:OAuth2またはJWT)を決定し、異なるレート制限があります。
スコープを選択し、次へ: アプリケーションを選択をクリックします。アプリケーションが必要とするリソースとアクションのペアを確認します。トークンには選択したスコープのみが含まれます。
このサブスクリプションのアプリケーションを選択し、次へ: レビューをクリックします。
Tealiumユーザーとしてログインしている場合、APIがアカウントスコープのアクセスを要求する場合、アカウントプロファイルステップが表示されます。このサブスクリプションにアクセスする必要があるTealiumアカウントとプロファイルを選択し、次に次へ: エンジンを選択または次へ: レビューをクリックします。
外部開発者はこのステップをスキップします。Tealiumの顧客リソースへのアクセスは、リソース所有者によってサードパーティアプリアクセスを通じて付与されます。
選択したAPIのいずれかがプレビュー中の場合、レビュー画面に警告が表示されます。組織がTealiumと早期アクセス契約を締結していること、およびアクセスを許可するアカウントプロファイルを確認したことを確認するボックスにチェックを入れます。サブスクリプションを作成ボタンは、ボックスにチェックを入れるまで無効のままです。
レビューを行い、サブスクリプションを確認をクリックします。
既存のアプリケーションに追加のAPIをサブスクライブする
アプリケーションに移動し、アプリケーションを選択します。
APIにサブスクライブするをクリックします。
サブスクライブしたいAPIを選択し、次へ: スコープを構成をクリックします。
スコープを選択します。アプリケーションが必要とする各リソースとアクションのペアを確認します。トークンには選択したスコープのみが含まれます。アプリケーションが必要とするもののみを要求します。
Tealiumユーザーとしてログインしている場合、次へ: アカウントプロファイルをクリックします。このサブスクリプションがカバーするTealiumアカウントとプロファイルを選択し、次に次へ: エンジンを選択または次へ: レビューをクリックします。
外部開発者は**次へ: レビュー(Nアプリが選択されました)**を見て、アカウントプロファイルとエンジンのステップをスキップします。
エンジンを選択します(該当する場合)。Context APIなど、エンジンレベルのアクセスが必要なAPIの場合、エンジンを選択ステップが表示されます。エンジンはアカウントとプロファイル別にグループ化されます。特定のエンジンを選択するか、後で追加されるエンジンも含むように**すべてのエンジン(現在および将来)**を選択します。無効になっているエンジンも将来の使用のために選択できます。このステップをスキップして、後でエンジンアクセスを付与することもできます。
選択したAPIのいずれかがプレビュー中の場合、レビュー画面に警告が表示されます。組織がTealiumと早期アクセス契約を締結していること、およびアクセスを許可するアカウントプロファイルを確認したことを確認するボックスにチェックを入れます。サブスクリプションを作成ボタンは、ボックスにチェックを入れるまで無効のままです。
構成を確認し、確認します。
エンジン選択
サブスクリプションに含まれる1つ以上のAPIがエンジンレベルの承認を要求する場合、エンジン選択ステップが表示されます。エンジンはアカウントとプロファイル別にグループ化されます。
- 名前またはIDで個々のエンジンを選択します。
- サブスクリプション後に作成されるエンジンを自動的に含むように**すべてのエンジン(現在および将来)**を選択します。
- 無効になっているエンジンも選択できます。それらは無効バッジとともに表示されます。
- エンジン選択はオプションです。サブスクリプション作成後にエンジンアクセスを追加または変更することができます。
サブスクリプションが作成された後、アプリケーション詳細ページのエンジンアクセスセクションからエンジンアクセスを更新できます。詳細については、エンジンアクセス管理を参照してください。
外部開発者の場合、アプリケーションにアクセスを許可するTealiumユーザーも承認フローでエンジンを選択ステップを完了します。詳細については、サードパーティアプリアクセスを参照してください。
サブスクリプションの状態
APIにサブスクライブすると、サブスクリプションは次のいずれかの状態になります:
| 状態 | 意味 |
|---|---|
| 承認済み | アクティブで使用可能です。アプリケーションはサブスクライブしたスコープでトークンを要求できます。 |
| 保留中 | 処理を待っています。サブスクリプションは自動的に承認され、この状態は通常すぐに解決されます。 |
| 終了 | サブスクリプションは終了しました。これ以上API呼び出しを行うことはできません。アクセスを取り戻すには、新しいサブスクリプションを作成してください。 |
サブスクリプションの管理
サイドバーのサブスクリプションに移動して、アプリケーション全体のすべてのサブスクリプションを表示します。ページ上部のドロップダウンを使用して、アプリケーションまたはAPI別にリストをフィルタリングできます。スコープチップにカーソルを合わせると、そのサブスクリプションに割り当てられた特定の権限が表示されます。
サブスクリプションを編集または終了するには、アプリケーションの詳細ページに移動し、サブスクリプションセクションを開きます。
サブスクリプションの編集
アクティブなサブスクリプションのスコープをいつでも更新できます。
- アプリケーションの詳細ページに移動します。
- サブスクリプションセクションを開きます。
- サブスクリプションの隣にある編集アイコンをクリックします。
- 必要に応じてスコープを追加または削除します。
- 保存をクリックします。
既存のアクセストークンは、有効期限が切れるまで元のスコープで引き続き機能します。トークンは2時間後に期限切れになります。新しいトークンリクエストは更新されたスコープセットを使用します。リソース所有者がアカウントにアプリケーションのアクセスを許可している場合、スコープの変更により、変更を確認するためのスコープドリフト通知がトリガーされる場合があります。
アプリケーションがアクセスできるTealiumアカウントとプロファイルを編集するには、アプリケーションの詳細ページのアカウントアクセスセクションを使用します。詳細については、アカウントアクセスの編集を参照してください。
最終更新日 :: 2026年September月23日