(レガシー)事前承認済みリソースのリストの取得 retrieve-list-of-preauthorized-resources
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
IMPORTANT
製品のお知らせページに集約された最新のAdobe Pass認証製品のお知らせや廃止予定タイムラインについて、常に情報を提供するようにします。
NOTE
REST API の実装には、 スロットルメカニズムという制限があります。
REST API エンドポイント clientless-endpoints
< レジストリ_FQDN>:
- 実稼動 – api.auth.adobe.com
- ステージング - api.auth-staging.adobe.com
<SP_FQDN>:
- 実稼動 – api.auth.adobe.com
- ステージング - api.auth-staging.adobe.com
説明 description
Adobe Pass Authentication に対するリクエストで、事前に許可されたリソースのリストを取得します。
API には、ストリーミングアプリまたはプログラマーサービス用の API セットと、2 番目の画面の web アプリ用の API セットの 2 つのセットがあります。 ここでは、ストリーミングアプリまたはプログラマーサービスの API について説明します。
エンドポイント
呼び出
元
元
入力
パラメーター
パラメーター
HTTP
メソッド
メソッド
応答
HTTP
Response
Response
<SP_FQDN>/api/v1/事前承認
ストリーミングアプリ
プログラマ
サービス
プログラマ
サービス
1. リクエスター(必須)
2. deviceId (必須)
3. resource (必須)
4. device_info/X-Device-Info (必須)
5. deviceType
6. deviceUser (非推奨)
7. appId (非推奨)
2. deviceId (必須)
3. resource (必須)
4. device_info/X-Device-Info (必須)
5. deviceType
6. deviceUser (非推奨)
7. appId (非推奨)
GET
個々の事前認証の決定やエラーの詳細が含まれる XML または JSON。 以下のサンプルを参照してください。
200 - Success
400 - Bad request
401 - Unauthorized
405 - Method not allowed
412 - Precondition failed
500 – 内部サーバーエラー
400 - Bad request
401 - Unauthorized
405 - Method not allowed
412 - Precondition failed
500 – 内部サーバーエラー
入力パラメーター
説明
要求者
この操作が有効なプログラマ requestorId です。
deviceId
デバイス ID のバイト。
resource
ユーザーがアクセス可能で、MVPD認証エンドポイントによって認識されるコンテンツを識別する resourceId のコンマ区切りリストを含む文字列。
device_info/
X-Device-Info
X-Device-Info
ストリーミングデバイス情報。
注意:これは device_info を URL パラメーターとして渡す場合がありますが、このパラメーターの潜在的なサイズとGET URL の長さに関する制限により、http ヘッダーで X-Device-Info として渡す必要があります。
詳しくは、「デバイスと接続情報の受け渡し を参照してください。
注意:これは device_info を URL パラメーターとして渡す場合がありますが、このパラメーターの潜在的なサイズとGET URL の長さに関する制限により、http ヘッダーで X-Device-Info として渡す必要があります。
詳しくは、「デバイスと接続情報の受け渡し を参照してください。
deviceType
デバイスタイプ(Roku、PC など)。
このパラメーターを正しく設定すると、ESM では、クライアントレスの使用時に デバイスタイプごとに分類される指標を提供するので、Roku、AppleTV、Xbox など、様々なタイプの分析を実行できます。
参照 パス指標でクライアントレスデバイスタイプパラメーターを使用するメリット
注意:
このパラメーターを正しく設定すると、ESM では、クライアントレスの使用時に デバイスタイプごとに分類される指標を提供するので、Roku、AppleTV、Xbox など、様々なタイプの分析を実行できます。
参照 パス指標でクライアントレスデバイスタイプパラメーターを使用するメリット
注意:
device_info
はこのパラメーターを置き換えます。deviceUser
デバイスユーザー識別子。
appId
アプリケーション ID/名前。
注意:このパラメーターは device_info に置き換えられます。
注意:このパラメーターは device_info に置き換えられます。
応答のサンプル sample-response
XML:
HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/xml; charset=utf-8
<resources>
<resource>
<id>TestStream1</id>
<authorized>true</authorized>
</resource>
<resource>
<id>TestStream2</id>
<authorized>false</authorized>
<error>
<status>403</status>
<code>authorization_denied_by_mvpd</code>
<message>User not authorized</message>
<details>Your subscription package does not include the "TestStream3" channel.</details>
<helpUrl>https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes</helpUrl>
<trace>0453f8c8-167a-4429-8784-cd32cfeaee58</trace>
<action>none</action>
</error>
</resource>
</resources>
JSON:
HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/json; charset=utf-8
{
"resources" : [
{
"id" : "TestStream1",
"authorized" : true
},
{
"id" : "TestStream3",
"authorized" : false,
"error" : {
"status" : 403,
"code" : "authorization_denied_by_mvpd",
"message" : "User not authorized",
"details" : "Your subscription package does not include the "TestStream3" channel.",
"helpUrl" : "https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes",
"trace" : "0453f8c8-167a-4429-8784-cd32cfeaee58",
"action" : "none"
}
}
]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b