iQ ロードルール API
iQ 変数 API を使用すると、iQ タグ管理プロファイルでロードルールをプログラムで作成、更新、削除できます。
この API と利用可能なオブジェクトフィールドについての詳細は、iQ プロファイル API および iQ プロファイルオブジェクト を参照してください。
動作方法
PATCH
メソッドを使用して、iQ プロファイルオブジェクトのロードルールを作成、更新、削除します。
PATCH /v3/tiq/accounts/{ACCOUNT}/profiles/{PROFILE}
PATCH メソッドを使用すると、保存または名前を付けて保存を使用してプロファイルのロードルールをプログラムで変更します。API を使用して変更した後でも、アプリケーションにログインして公開する必要があります。
cURL リクエストの例
curl --location --request PATCH 'https://platform.tealiumapis.com/v3/tiq/accounts/{ACCOUNT}/profiles/{PROFILE}' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUx...MiJ9' \
--header 'Content-Type: application/json' \
--data '
認証
API キーではなく、すべての API 呼び出しを認証するためにベアラートークンが使用されます。API キーは認証呼び出しでのみ使用されます。ベアラートークンに加えて、認証応答には、後続のサーバーサイド API 呼び出しで使用する必要がある地域固有のホスト名が含まれています。
API キーからベアラートークンを生成する方法については、認証 を参照してください。
プロファイルフィールド
プロファイルロードルールは、以下の可能なフィールドを含む JSON オブジェクトです:
フィールド | タイプ | 必須 | 説明 |
---|---|---|---|
versionTitle |
文字列 | 任意 | 結果として保存されるバージョンのタイトル。saveType が saveAs に構成されている場合のデフォルト : API | {TIMESTAMP} saveType が save に構成されている場合のデフォルト: 既存のバージョンタイトル |
saveType |
文字列 | 任意 | PATCH リクエストで実行する保存のタイプ:save または saveAs 。デフォルトは saveAs 。 |
notes |
文字列 | 必須 | 公開バージョンに関する追加の注記。 |
op |
文字列 | 必須 | 実行する操作:add 、replace 、または remove 。 |
path |
文字列 | 必須 | 更新するコンポーネントタイプと ID、形式:/loadRules 。 |
value.object |
文字列 | 必須 | 更新されるオブジェクトタイプ:variable 、loadRule 、または extension 。 |
value.name |
文字列 | 必須 (add/replace の場合) | ロードルールの名前。 |
value.status |
文字列 | 必須 | オン/オフの状態:active または inactive 。 |
value.notes |
文字列 | 任意 | ロードルールに関する注記。 |
value.startDate |
日付 | value.endDate が空の場合は任意。 |
スケジュールされたロードルールの開始日。日付形式は yyyyMMddHHmm 。 |
value.endDate |
日付 | 任意 | スケジュールされたロードルールの終了日。日付形式は yyyyMMddHHmm 。 |
value.conditions |
オブジェクトの配列 | 必須 | 変数名、演算子、値を含むオブジェクトの配列。配列内の各オブジェクトは and 演算子で関連付けられ、配列内の各配列は or 演算子で関連付けられます。次の演算子は値を受け付けません:is defined is badge assigned is badge not assigned is not defined is not populated |
リクエストの例
{
"versionTitle": "Adding Rule",
"saveType": "saveAs",
"notes": "version notes here",
"operationList": [
{
"op": "add",
"path": "/loadRules",
"value":{
"object": "loadRule",
"name": "new rule API Dom variable",
"status": "active",
"notes": "Load Rule notes here",
"startDate": "202202020000",
"endDate": "202202020000",
"conditions": [
[
{
"variable": "udo.new_name",
"operator": "does_not_equal",
"value": 10
}
]
]
}
}
]
}
PATCH 操作パラメータ
POST
、PUT
、DELETE
メソッドの代わりに、PATCH
メソッドは op
パラメータを使用して実行するアクションを指定します。
op
パラメータは次の値をサポートしています:
add
- コンポーネントを作成します。replace
- コンポーネントを更新します。remove
- コンポーネントを削除します。
コンポーネントのタイプと ID を指定するには、path
パラメータを使用します。path
パラメータの形式は /{TYPE}/{ID}
です。
例えば、ロードルールを追加するには:
"op" : "add",
"path" : "/loadRules"
特定のロードルールを更新するには、パスに ID を追加します:
"op" : "replace",
"path" : "/loadRules/503"
ロードルールの作成
この PATCH メソッドは、プロファイルロードルールオブジェクトと追加のロードルールフィールドを取ります。
リクエストの例
{
"versionTitle": "Adding Rule",
"saveType": "saveAs",
"notes": "version notes here",
"operationList": [
{
"op": "add",
"path": "/loadRules",
"value":{
"object": "loadRule",
"name": "new rule API Dom variable",
"status": "active",
"notes": "Load Rule notes here",
"startDate": "202202020000",
"endDate": "202202020000",
"conditions": [
[
{
"variable": "udo.new_name",
"operator": "does_not_equal",
"value": 10
}
]
]
}
}
]
}
ロードルールの更新
この PATCH メソッドは、プロファイルロードルールオブジェクトと追加のロードルールフィールドを取ります。
リクエストの例
{
"versionTitle": "Adding Rule",
"saveType": "saveAs",
"notes": "version notes here",
"operationList": [
{
"op": "replace",
"path": "/loadRules/49",
"value":{
"object": "loadRule",
"name": "new rule API Dom variable",
"status": "active",
"notes": "Load Rule notes here",
"startDate": "202202020000",
"endDate": "202202020000",
"conditions": [
[
{
"variable": "udo.new_name",
"operator": "does_not_equal",
"value": 10
}
]
]
}
}
]
}
ロードルールの削除
この PATCH メソッドは、プロファイルロードルールオブジェクトと追加のロードルールフィールドを取ります。
リクエストの例
{
"versionTitle": "Adding Rule",
"saveType": "saveAs",
"notes": "version notes here",
"operationList": [
{
"op": "remove",
"path": "/loadRules/49",
"value":{
"object": "loadRule"
}
}
]
}
エラーメッセージ
このエンドポイントの潜在的なエラーメッセージ:
エラーコード | エラーメッセージ |
---|---|
400 | "パッチリクエストの検証に失敗しました:%s" "存在しないタグでタグスコープ拡張を構成できません、id: {ID} - {ACCOUNT} | profile: {PROFILE}" "構成がオンになっていない場合、拡張スコープを同期に構成できません - {ACCOUNT} | profile: {PROFILE}" "次の拡張 ID の取得エラー - {ACCOUNT} | profile: {PROFILE}" "プロファイルライブラリが古くなっています、パッチングプロファイルの前に変更をマージしてください - {ACCOUNT} | profile: {PROFILE}" "サポートされていません" "patchProfile.arg2.notes: 空であってはなりません" |
404 | "アカウント: {ACCOUNT}, プロファイル: {PROFILE} が見つかりません" |
409 | "同じアカウントを現在閲覧しているユーザー: {ACCOUNT} プロファイル: {PROFILE}" プロファイルの保存エラー: {PROFILE} アカウント: {ACCOUNT}, 重複バージョン: {VERSIONS} |
500 | "エラーが発生しました" "プロファイル: {PROFILE} はライブラリプロファイルから継承されています" "リクエストを呼び出すことができません: 不明なホスト、詳細はログを参照してください。" "プロファイルメタデータの保存エラー - アカウント: {ACCOUNT} | プロファイル: {PROFILE}" "プロファイルの保存エラー - アカウント: {ACCOUNT} | プロファイル: {PROFILE}" "プロファイルの保存エラー(レガシー) - {ACCOUNT} | プロファイル: {PROFILE}" |
最終更新日 :: 2025年August月27日