--- title: ホストされたデータレイヤーAPIについて description: ホストされたデータレイヤーAPIを使用すると、Tealiumのサーバー上でデータレイヤーオブジェクトまたはJSONファイルをアップロードし、アクセスすることができます。 url: https://docs.tealium.com/ja/api/v2/hosted-data-layer/about/ ---## 仕組み ホストされたデータレイヤーオブジェクトは静的なJavaScriptファイルで、ウェブサイトから取得してページ上のデータレイヤーを補完することができます。JSONファイルは、データを効率的に伝送するためのさまざまなアプリケーションで使用できます。 始める前に、[ホストされたデータレイヤー機能の主要な概念](https://docs.tealium.com/about-hosted-data-layer/)について読むことをお勧めします。 このAPIは、通常、[ホストされたデータレイヤー拡張](https://docs.tealium.com/hosted-data-layer-extension/)と併用して使用されます。 ## 権限要件 * 保存/名前を付けて保存 ## 命名ガイドライン ホストされたデータレイヤーオブジェクトをアップロードする前に、オブジェクトの名前とルックアップ変数の値を知っておく必要があります。ホストされたデータレイヤーオブジェクトの名前は、ページ上のルックアップ変数の予想される値と一致する必要があります。ルックアップ変数の名前は、`datalayer_id`パラメータの値となり、これがページ上のデータレイヤーとホストされたデータレイヤーオブジェクトとの間の共有リンクとなります。 ページ上のデータレイヤーと直接関連しないホストされたJSONファイルは、次の表で説明されるURI制限に準拠した任意の名前を持つことができます： |値| 説明| |---| ---| |`product_id`| * ルックアップ変数。 | |`prod123456`| * ページ上で入力される値。 | |`utag_data.product_id = ["prod123456"];`| * ページ上のデータレイヤー。 | |`prod123456`| * ホストされたデータレイヤーオブジェクトの名前。 * オブジェクト名には空白や次のUniform Resource Identifier (URI)予約文字を含めることはできません：/ : ? # [ ] @ ! $ & ' ( ) \* + , ; = % . " | ## APIレート制限 TealiumはAPIのレート制限を強制しませんが、安定した統合を維持するために、このAPIへの自身のアクセスを1秒あたり100リクエスト以下に制限することをお勧めします。 ## 認証
ベアラートークンは、すべてのAPI呼び出しを認証するために使用され、APIキーではありません。APIキーは認証呼び出しでのみ使用されます。
APIキーからベアラートークンを生成する方法については、[はじめに](https://docs.tealium.com/api-authentication/)ガイドを参照してください。