---
title: iQプロファイルAPIについて
description: このセクションでは、APIを通じてiQ構成を管理する方法について説明します。iQプロファイルAPIを使用して、プロファイル構成をプログラムで制御および更新します。
url: https://docs.tealium.com/ja/api/v3/iq-profiles/about/
---
## 仕組み

iQプロファイルは、iQタグ管理構成をプログラムで利用可能にするAPIエンドポイントです。このエンドポイントを使用して、タグ、拡張機能、ロードルール、イベント、変数などの特定の構成コンポーネントを取得し、限定されたコンポーネントの追加、編集、削除を行います。

このAPIを使用して、プロファイルのバージョンと変更履歴にアクセスし、独自のSDLCを統合します。

iQプロファイルは現在、以下の2つのリクエストをサポートしています：

* **GET**  
iQタグ管理アカウントプロファイルについての特定の内容を返します。これには、ロードルール、タグ、タグテンプレート、イベント、拡張機能、変数、バージョンIDが含まれます。
* **PATCH**  
構成コンポーネントの限定されたサブセットに対して作成、更新、削除操作を実行します。この方法を使用すると、プロファイルの新しい保存バージョンが生成されます。

## 同時ユーザーとAPIユーザー

プロファイルを更新する際、iQプロファイルは同時ユーザーをスキャンし、同時変更に対する保護のためにプロファイルをAPIユーザーに対してロックします。別のユーザーが同じプロファイルを閲覧している場合や、プロファイルが更新されたばかりの場合（15秒以内）、PATCHメソッドはエラーを受け取ります。

## 保存、バージョニング、および公開

PATCHリクエストを使用してプロファイルを更新すると、アプリケーション内に新しいバージョンまたは更新されたバージョンが作成されます。APIによって生成されたバージョンとアプリケーションで作成されたバージョンを区別するために、APIはバージョン名を `API | {TIMESTAMP}` としてフォーマットします。

PATCHコールが成功した後、このプロファイルを公開するには、アプリケーションにログインし、パッチ後に保存されたプロファイルの最新バージョンに移動して公開します。

## 権限要件

* **GETプロファイル**  
新しいバージョンとして保存および保存する権限
* **PATCHプロファイル**  
既存のバージョンを保存する権限または新しいバージョンとして保存する権限

## 認証


<blockquote>
APIキーではなく、すべてのAPI呼び出しを認証するためにベアラートークンが使用されます。APIキーは認証呼び出しでのみ使用されます。ベアラートークンに加えて、認証応答には、後続のサーバーサイドAPI呼び出しで使用する必要がある地域固有のホスト名が含まれています。
</blockquote>


APIキーからベアラートークンを生成する方法については、[認証](https://docs.tealium.com/api/v3/getting-started/authentication/)を参照してください。