> ## Documentation Index > Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt > Use this file to discover all available pages before exploring further. # get_brand_identity > get_brand_identity はブランドエージェントからブランドデータを取得する AdCP タスク。ロゴ、カラー、フォント、ビジュアルガイドライン、トーン、音声合成設定をパブリックと認可アクセスのティアで返します。 ブランドエージェントからブランドアイデンティティデータを取得します。コアアイデンティティ（ハウス、名前、説明、ロゴ）は常にパブリック — 認証なしで任意のエージェントがブランドが誰であるかを発見できます。リンクされたアカウントはより深いデータを取得できる: 高解像度アセット、音声合成設定、トーンガイドライン、権利の可用性。 ## スキーマ * **リクエスト**: [`get-brand-identity-request.json`](https://adcontextprotocol.org/schemas/latest/brand/get-brand-identity-request.json) * **レスポンス**: [`get-brand-identity-response.json`](https://adcontextprotocol.org/schemas/latest/brand/get-brand-identity-response.json) ## 応答時間 アイデンティティデータは通常2秒以内。大きなアセットコレクションを含む認可レスポンスはより時間がかかる場合があります。 ## デフォルトでパブリック ブランドアイデンティティはパブリックデータです。任意のエージェントがリンクされたアカウントなしで `get_brand_identity` を呼び出し、ブランドのコアアイデンティティを受け取ることができる: ハウス、名前、説明、業界、基本的なロゴ。これは `brand.json` で利用可能なものと同じデータ — `get_brand_identity` はファイルを取得してパースするよりも構造化された呼び出しを好むエージェントのために MCP 経由で提供します。 レジストリはこれを適用する: `brand.json` からインデックス化されたすべてのブランドはパブリックに発見可能です。ブランドがどのハウスに属するか、何と呼ばれるか、何をするかを常に確認できます。 認可された呼び出し元（[`sync_accounts`](/docs/accounts/overview) でリンクされた）はパブリックのベースラインの上にさらに深いデータを取得できます。 アカウントリンクは一度限りのセットアップ: バイヤーエージェントがブランドエージェントで [`sync_accounts`](/docs/accounts/tasks/sync_accounts) を呼び出してブランド参照を提供します。その後、バイヤーの `get_brand_identity` リクエストは認可済みと認識されます。 | レベル | 取得できるもの | | ------------------------------ | ------------------------------------------------- | | **パブリック**（リンクされたアカウントなし） | ハウス、名前、説明、業界、keller\_type、基本的なロゴ、タグライン | | **認可**（`sync_accounts` でリンク済み） | 上記すべて、プラス: 高解像度アセット、音声合成、トーンガイドライン、コンテンツ制限、権利の可用性 | リクエストに呼び出し元が持っていない認可が必要な `fields` が含まれている場合、それらのフィールドは黙って省略されます。レスポンスには `available_fields` が含まれ、存在するが返されなかったセクションを一覧表示する — これにより呼び出し元はアカウントをリンクすることで何が得られるかを知ることができます。 ## クイックスタート ```json リクエスト（パブリック） theme={null} { "brand_id": "daan_janssen" } ``` ```json レスポンス（パブリック） theme={null} { "brand_id": "daan_janssen", "house": { "domain": "lotientertainment.com", "name": "Loti Entertainment" }, "names": [{"en": "Daan Janssen"}], "description": "Dutch Olympic speed skater, 2x gold medalist", "industries": ["sports"], "keller_type": "independent", "logos": [ { "url": "https://cdn.lotientertainment.com/janssen/headshot.jpg", "variant": "primary" } ], "tagline": [{"en-US": "Speed is a choice"}, {"nl-NL": "Snelheid is een keuze"}], "available_fields": ["tone", "voice_synthesis", "assets", "rights"] } ``` ```json リクエスト（認可済み、特定フィールド） theme={null} { "brand_id": "daan_janssen", "fields": ["logos", "tone", "voice_synthesis"], "use_case": "endorsement" } ``` ```json レスポンス（認可済み） theme={null} { "brand_id": "daan_janssen", "house": { "domain": "lotientertainment.com", "name": "Loti Entertainment" }, "names": [{"en": "Daan Janssen"}], "logos": [ { "url": "https://cdn.lotientertainment.com/janssen/headshot.jpg", "variant": "primary" }, { "url": "https://assets.lotientertainment.com/janssen/hero_01_highres.jpg", "variant": "full-lockup", "width": 3000, "height": 2000 } ], "voice_synthesis": { "provider": "elevenlabs", "voice_id": "janssen_v2", "settings": { "stability": 0.7 } }, "tone": { "voice": "enthusiastic, warm, competitive", "attributes": ["athletic", "Dutch pride", "approachable"], "dos": ["Reference athletic achievements", "Use Dutch cultural touchpoints"], "donts": ["No injury references", "No competitor comparisons"] } } ``` ```json リクエスト（クリエイティブ制作） theme={null} { "brand_id": "daan_janssen", "fields": ["colors", "fonts", "visual_guidelines"], "use_case": "creative_production" } ``` ```json レスポンス（認可済み） theme={null} { "brand_id": "daan_janssen", "house": { "domain": "lotientertainment.com", "name": "Loti Entertainment" }, "names": [{"en": "Daan Janssen"}], "colors": { "primary": "#FF6600", "secondary": "#1A1A2E", "accent": "#FBA007" }, "fonts": { "primary": "Montserrat", "secondary": "Open Sans", "font_urls": ["https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700"] }, "visual_guidelines": { "photography": { "realism": "photorealistic", "lighting": "bright, natural", "framing": ["medium shot", "action shot"] }, "restrictions": [ "Never place text over the athlete", "No competitor brand logos in frame" ] } } ``` ```json レスポンス（エラー） theme={null} { "errors": [ { "code": "brand_not_found", "message": "No brand with id 'unknown_brand' in this agent's roster" } ] } ``` ## パラメーター ### リクエスト | フィールド | 型 | 必須 | 説明 | | ---------- | --------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `brand_id` | string | Yes | エージェントの brand.json の brands 配列からのブランド識別子 | | `fields` | string\[] | No | 含めるオプションセクション（例: `logos`、`colors`、`fonts`、`visual_guidelines`、`tone`）。すべての認可セクションには省略します。コアフィールド（`brand_id`、`house`、`names`）は常に返され、リクエストする必要はない。 | | `use_case` | string | No | 意図するユースケース（例: "endorsement"、"voice\_synthesis"、"likeness"）。エージェントは返されたセクション内のコンテンツを調整する — "likeness" ユースケースはアクション写真を返し、"voice\_synthesis" ユースケースは音声設定を返します。`fields` をオーバーライドしません。 | 有効な `fields` 値: `description`、`industries`、`keller_type`、`logos`、`colors`、`fonts`、`visual_guidelines`、`tone`、`tagline`、`voice_synthesis`、`assets`、`rights` 推奨 `use_case` 値: | 値 | エージェントの動作 | | --------------------- | ------------------------------------------------ | | `endorsement` | アクション写真、エンドースメントトーン、ブランドストーリーを優先 | | `voice_synthesis` | 音声合成設定、発音ガイドを返す | | `likeness` | 高解像度写真、外見ガイドライン | | `creative_production` | 完全なビジュアルアイデンティティ: カラー、フォント、visual\_guidelines、ロゴ | | `media_planning` | 基本的なアイデンティティと権利可用性のサマリー | `use_case` は参考情報 — 返されたセクション内のコンテンツを調整するが `fields` をオーバーライドしません。 ### レスポンス レスポンスはエージェントがコントロールする動的データで拡張された brand.json のブランド定義を反映する: | フィールド | 型 | 必須 | 説明 | | ------------------- | --------- | --- | -------------------------------------------------------------------------------------------------------------- | | `brand_id` | string | Yes | ブランド識別子 | | `house` | object | Yes | ハウス（法人組織）: `domain` と `name` | | `names` | object\[] | Yes | ローカライズされた名前 | | `description` | string | No | ブランドの説明 | | `industries` | string\[] | No | 業界またはカテゴリー | | `keller_type` | string | No | ブランドアーキテクチャタイプ: `master`、`sub_brand`、`endorsed`、`independent` | | `logos` | object\[] | No | ブランドロゴ（brand.json のロゴ形状に準拠: `url`、`variant`、`orientation`、`background`、`tags`） | | `colors` | object | No | 構造化されたロール（`primary`、`secondary`、`accent`、`background`、`text`）を持つブランドカラーパレット | | `fonts` | object | No | ブランドタイポグラフィ（`primary`、`secondary`、`font_urls`） | | `visual_guidelines` | object | No | 写真、グラフィックスタイル、カラーウェイ、タイプスケール、モーションルール、制限 | | `tone` | object | No | ブランドの声とメッセージガイドライン。サブフィールド: `voice`（個性を表す形容詞）、`attributes`（プロンプトガイダンスの特性）、`dos`（承認されたアプローチ）、`donts`（禁止されたトピック） | | `tagline` | string | No | ブランドのタグラインまたはスローガン | | `voice_synthesis` | object | No | TTS 音声合成設定（`provider`、`voice_id`、`settings`） | | `assets` | object\[] | No | 利用可能なブランドアセット — brand.json アセット形状に準拠（`asset_id`、`asset_type`、`url`、`tags`） | | `rights` | object | No | 権利の可用性サマリー（価格には `get_rights` を使用） | | `available_fields` | string\[] | No | 認可レベルにより返されなかったが利用可能なセクション。アカウントをリンクすることで何がアンロックされるかを呼び出し元に伝える。 | ## ユースケース * **DAM**: 高解像度アセット、現在のキャンペーンガイドライン、季節ごとのクリエイティブツールキットを返す * **エンタープライズブランドエージェント**: 承認されたコピー、ブランドボイスガイドライン、現在のタグラインを返す * **権利管理エージェント**: タレントアイデンティティを返す — トーン、音声合成、写真、権利の可用性 ## 次のステップ 価格付きでライセンス可能な権利を検索します。 契約上のクリアランスで権利を取得します。