ドキュメントAdobe PassAdobe Pass 認証

（レガシー） ユーザーメタデータ user-metadata

最終更新日： 2026年10月8日
NOTE
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
IMPORTANT
製品のお知らせ ページに集計されている最新のAdobe Pass認証製品のお知らせと廃止予定について、常に情報を得てください。
NOTE
REST APIの実装は​ スロットル メカニズム ​によって制限されています

REST API エンドポイント clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

説明 description

MVPDが認証済みユーザーについて共有したメタデータを取得します。

エンドポイント
様に呼び出されました
入力
パラメーター
HTTP
メソッド
応答
HTTP
応答
<SP_FQDN>/api/v1/tokens/usermetadata
ストリーミングアプリ

または

プログラマーサービス
​1. 依頼者
2。 deviceId （必須）
3。 device_info/X-Device-Info （必須）
4. deviceType
5。 deviceUser （非推奨）
6。 appId （非推奨）
GET
失敗した場合のユーザーのメタデータまたはエラーの詳細を含むXMLまたはJSON。

200 – 成功

404 - メタデータが見つかりません

412 – 無効なAuthN トークン （期限切れのトークンなど）

入力パラメーター
説明
依頼者
この操作が有効なプログラマの依頼者Id。
deviceId
デバイス ID バイト。

device_info/

X-Device-Info

ストリーミング デバイス情報。

注意：​これはdevice_infoをURL パラメーターとして渡すことができますが、このパラメーターの潜在的なサイズとGET URLの長さに制限があるため、http ヘッダーのX-Device-Infoとして渡す必要があります。

詳しくは、​ デバイスと接続情報の受け渡しを参照してください。
deviceType
デバイスの種類（Roku、PCなど）。

このパラメーターが正しく設定されている場合、ESMはクライアントレスを使用する際にデバイスタイプ 🔗ごとに分割された指標を提供します。これにより、Roku、AppleTV、Xboxなどのさまざまなタイプの分析を実行できます。

「​ パス指標でクライアントレスデバイスタイプパラメーターを使用するメリット ​

」を参照してください 注： device_infoはこのパラメーターに置き換わります。
deviceUser
デバイス ユーザーID。

メモ：​使用する場合、deviceUserは登録コードの作成 リクエストと同じ値を持つ必要があります。
appId
アプリケーション ID/名前。

注： device_infoはこのパラメーターに置き換わります。 使用する場合、appIdは、登録コードの作成要求と同じ値を持つ必要があります。
NOTE
ユーザーメタデータ情報は、認証フローが完了した後に使用できますが、MVPDおよびメタデータタイプに応じて、認証フローで更新できます。

応答サンプル sample-response

呼び出しが成功すると、サーバーはXML （デフォルト）またはJSON オブジェクトを使用して、以下のような構造で応答します。

    {
        updated: 1334243471,
        encrypted: ["encryptedProp"],
        data: {
              zip: ["12345", "34567"],
              maxRating: {
                  "MPAA": "PG-13",
                  "VCHIP": "TV-Y",
                  "URL": "http://exam.pl/e/manage/ratings"
                         },
              householdID: "3456",
              userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
              channelID: ["channel-1", "channel-2"]
              }
    }

オブジェクトのルートには3つのノードがあります。

  • updated: メタデータが最後に更新された時刻を表すUNIX タイムスタンプを指定します。 このプロパティは、認証フェーズでメタデータを生成する際に、サーバーによって最初に設定されます。 その後の呼び出し（メタデータが更新された後）は、タイムスタンプが増分されます。
  • data：実際のメタデータ値が含まれています。
  • encrypted：暗号化されたプロパティを一覧表示する配列。 特定のメタデータ値を復号するには、プログラマはメタデータに対してBase64復号を実行し、その結果の値に対して独自の秘密鍵を使用してRSA復号を適用する必要があります（Adobeは、プログラマの公開証明書を使用してサーバ上のメタデータを暗号化します）。

エラーが発生した場合、サーバーは詳細なエラーメッセージを指定するXMLまたはJSON オブジェクトを返します。

詳しくは、​ ユーザーメタデータ ​を参照してください。

REST API リファレンスに戻る

recommendation-more-help
pass-help-authentication