Tealium Developer Portalの使い方

このチュートリアルでは、サインインから最初の認証済みAPIコールを行うまでの完全なセットアップフローを説明します。開始する前に、Tealium Developer Portalについてを読んで、アプリケーション、登録、スコープ、トークンがどのように関連しているかを理解してください。

サインイン

app.tealiumapis.comにアクセスし、アカウントタイプに合ったログイン方法を選択してください：

Tealiumユーザーとしてログイン： 既存のTealiumアカウントを持つユーザー向け。Tealium SSOまたはパスワード認証を使用します。
Developer Portalユーザーとしてログイン： Tealiumアカウントを持っていない外部開発者向け。Developer Portalユーザーアカウントを持っていない場合は、/registerにアクセスして、名、姓、メールアドレスでサインアップしてください。

アーリーアクセス中は、セルフサービスの登録が無効になっている場合があります。“Registration Unavailable"と表示された場合は、Tealiumに連絡してアクセスをリクエストしてください。

認証後、ダッシュボードにリダイレクトされます。ダッシュボードでは、利用可能なAPI、アプリケーション、アクティブな登録、最近のAPIトラフィックの概要が表示されます。

ステップ1: APIカタログを閲覧する

アプリケーションを作成する前に、必要なAPIを特定するためにAPIカタログを閲覧してください。

左サイドバーのAPIカタログをクリックするか、ダッシュボードからAPIカタログを閲覧をクリックしてください。

カタログでは、各APIがカードで表示され、その名前、バージョン、サポート終了日、簡単な説明が示されます。Model Context Protocol（MCP）をサポートするAPIにはMCPバッジが表示されます。

検索ボックスを使用して、名前や説明でフィルタリングします。すべてのバージョンドロップダウンを使用してバージョンでフィルタリングするか、MCPトグルを使用してMCP対応のAPIのみを表示します。

APIカードをクリックすると、その詳細ページが開きます。詳細ページはタブで整理されています：

説明： APIの説明と概要。
概要： バージョン、ステータス、所有者情報。
プラン： 利用可能な登録プランとそのセキュリティタイプ。
RESTエンドポイント： リソースごとにグループ化されたすべてのエンドポイント。グループを展開して個々の操作を表示します。
MCP： 利用可能なMCPツール、パラメータ、および予想される動作。
ドキュメント： APIリファレンスドキュメントへのリンク。

詳細については、APIカタログを参照してください。

ステップ2: アプリケーションを作成し、登録する

左サイドバーのアプリケーションをクリックし、アプリケーションを作成をクリックします。
アプリケーションの名前とオプションの説明を入力します。この統合が何をするかを反映する名前を選んでください。例えば、Analytics DashboardやData Pipelineなどです。作成をクリックします。
登録ウィザードで、登録したいAPIを選択し、次へ: スコープを構成をクリックします。
各APIセクションを展開して利用可能なスコープを表示します。アプリケーションが必要とするリソースとアクションのペアをチェックします。統合に必要なスコープのみをリクエストしてください。
Tealiumユーザーとしてログインしている場合、アカウントプロファイルステップが表示されます。この登録がカバーするTealiumアカウントとプロファイルを選択します。ポータルは、公開権限を持っているプロファイルのみを表示します。次へ: エンジンを選択または次へ: レビューをクリックします。
外部開発者はアカウントプロファイルとエンジンのステップをスキップします。彼らは自身のTealiumアカウントを持っていません。リソース所有者によってTealiumの顧客リソースへのアクセスが許可されます。サードパーティアプリアクセスを参照してください。
Context APIなどのエンジンアクセスが必要なAPIを選択した場合、エンジンを選択ステップが表示されます。エンジンはアカウントとプロファイルごとにグループ化されています。特定のエンジンを選択するか、後で作成されるエンジンも自動的に含めるために**すべてのエンジン（現在および将来）**を選択します。無効になっているエンジンも将来の使用のために選択できます。このステップをスキップして、後でエンジンアクセスを構成することもできます。
構成を確認して登録を作成をクリックします。
アプリケーションを表示をクリックして、新しいアプリケーションの詳細ページに移動します。

詳細については、アプリケーションを参照してください。

Tealiumの顧客のアカウントとプロファイルへのアクセスが必要な外部開発者の場合：

Tealiumの連絡先にアプリケーションIDを共有します。
Tealiumユーザーは、サードパーティアプリアクセスページからアカウント、プロファイル、エンジンへのアプリケーションアクセスを許可します。
アクセスが許可されると、トークンにはそれらのリソースのスコープが含まれます。

資格情報を保存する

アプリケーションの詳細ページには、クライアントIDとアプリケーションIDが表示されます。作成直後に表示される確認画面からクライアントシークレットをコピーします。その画面を離れると、シークレットはもう表示されません。

ナビゲートする前にクライアントシークレットをコピーしてください。シークレットマネージャーや環境変数に保存します。資格情報をソースコントロールにコミットしないでください。保存していない場合は、シークレットを回転して新しいものを生成します。古いシークレットは直ちに無効になります。

ステップ3: アクセストークンをリクエストする

アプリケーション画面から、またはクライアントIDとクライアントシークレットを使用してトークンエンドポイントからベアラートークンをリクエストすることでアクセストークンを生成します。TealiumのAPIはOAuth2クライアントクレデンシャルグラントを使用します。

スコープは {account}:{profile}:{apiFamily}:{apiVersion}:{resource}:{action} の形式を使用します。詳細については、スコープを参照してください。

curl -X POST \
https://api.tealiumapis.com/oauth/token \
-u '{client_id}:{client_secret}' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'scope={space-separated-scopes}'

例えば：

curl -X POST \
https://api.tealiumapis.com/oauth/token \
-u 'a1b2c3d4e5f6:s3cr3tk3y' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'scope=acme-corp:main:cdp-api:2026-07:audiences:read acme-corp:main:cdp-api:2026-07:labels:read'

成功したレスポンスはJSONオブジェクトを返します：

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 7200,
  "scope": "my-account:main:cdp-api:2026-07:audiences:read my-account:main:cdp-api:2026-07:labels:read"
}

access_token の値はあなたのベアラートークンです。これは7200秒（2時間）後に期限切れになります。キャッシュして後続のリクエストで再利用してください。APIコールごとに新しいトークンをリクエストすると、スロットリングが発生します。

詳細については、認証を参照してください。

ステップ4: APIコールを行う

各リクエストの Authorization ヘッダーにアクセストークンを含めます：

curl -X GET \
https://api.tealiumapis.com/{version}/{api}/{api-endpoint} \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept: application/json'

成功したレスポンスは 2xx ステータスコードとデータを返します。リクエストが失敗した場合は、エラーコードと解決策の完全なリストについてエラーレスポンスを参照してください。

開発者ポータルからテストする

コードを書かずに開発者ポータルから直接APIコールをテストすることもできます。

左サイドバーの API Reference に移動し、APIを開きます。
アクションを展開し、エンドポイントを選択します。
画面の右下隅にある ⋮ アイコンをクリックし、次に Bearer Token キーアイコンをクリックします。
ドロップダウンからアプリケーションを選択し、Generate Token をクリックします。
Copy Token をクリックし、ダイアログを閉じます。
アクション画面の Token フィールドにトークンを貼り付け、必要なパラメータを入力し、Send API Request をクリックします。

API Reference page showing an expanded endpoint with the Get Bearer token flow

詳細については、APIリファレンスからベアラートークンを生成するを参照してください。