クリエイター インサイト機能を使用すると、YouTube クリエイターに関する分析情報を検出して取得できます。これは、ターゲット オーディエンスに関連するクリエイターを見つけたい代理店や広告主にとって便利です。
この API には主に 4 つの機能があります。
- クリエイターの検出: 指定されたトピック、ユーザー層、オーディエンス、クリエイターの属性に関連するクリエイターを見つけます。
- クリエイターのトピックに関する分析情報: 指定されたトピックに関するコンテンツを作成している関連クリエイターに関する分析情報を取得します。
- クリエイターの分析情報: 特定の YouTube チャンネルに関する分析情報（チャンネル登録者数、視聴回数、オーディエンスのユーザー層など）を取得します。
- トレンドの分析情報: 特定のオーディエンスまたはトピックに基づいて、特定のトレンドに関する分析情報を取得します。
補足データをリクエストすることで、トピック ベースのクリエイター検出またはトレンドの分析情報を使用する場合に、ローカル クリエイター検出（特定の国に拠点を置くか、その国から投稿し、その国で視聴されているクリエイターを見つける）がサポートされます。補足データをリクエストすることで、トピック ベースのトレンドの分析情報についてブランドのセンチメントの分析情報をリクエストすることもできます。
利用資格要件
GenerateCreatorInsights は、非独占的でロイヤリティ フリーのデータ ライセンスで提供される Google Ads API の非公開コンポーネントです。契約済みの
パートナー様は、標準のGoogle Ads クライアント ライブラリを使用して
YouTube のクリエイターとコンテンツを探索できます。対象となるパートナー様は、次の条件を満たす必要があります。
- Google Ads API を統合するプランニング ツールまたはユーザー インターフェースがある。
- API を使用して、潜在的な広告掲載の機会について YouTube のコンテンツとクリエイターを探索する。
- 利用資格を確認するための事前スクリーニングを完了する。
- データ使用要件を遵守し、定期的なデータ監査を受けることに同意する。
- データ使用要件を法的に強制するデータ ライセンス契約に署名する。
- Google Ads API 利用規約に同意する。
詳しくは、Google 担当者にお問い合わせください。
クリエイターの分析情報を生成する
クリエイターの分析情報を生成するには、
GenerateCreatorInsights メソッドにリクエストを送信します。このメソッドの秒間クエリ数（QPS）の上限は 5 件です。クリエイターの検出、トピックによる関連クリエイターの検索、クリエイターの分析情報の取得のいずれを行うかによって、さまざまな種類の入力を使用します。データを取得する国を指定する必要があります。
クリエイターの検出: 年齢、性別、ユーザーの興味関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、オーディエンスがこれらの属性に一致するクリエイターのリストを返します。クリエイターの属性を指定して、入力したクリエイターの属性にコンテンツが具体的に一致するクリエイターをフィルタすることもできます。
利用可能なオーディエンス属性を取得するには、属性を取得するディメンション（興味関心のあるトピックの
KNOWLEDGE_GRAPHなど）を指定して、ListAudienceInsightsAttributesを使用します。Google Ads API v23 以降では、
audience_combinationsを使用して複雑なオーディエンス属性の関係を指定できます。このフィールドを使用すると、audience_attributesでは不可能なブール論理演算（AND/OR）でオーディエンスを定義できます。audience_attributesは、結合された（OR で結合された）属性のリストに基づくターゲティング（「スポーツ」または「旅行」または...に関心のあるユーザーなど）に適していますが、audience_combinationsではより詳細な制御が可能です。audience_combinations内の各InsightsAudienceAttributeGroupは、属性を論理 OR で結合します。これらのグループは、論理 AND で結合されます。たとえば、（「スキンケア」または「ヘアケア」）に関心があり、かつ「化粧品」にも関心のあるオーディエンスをターゲットに設定するには、
audience_combinationsで 2 つのInsightsAudienceAttributeGroupアイテムを使用します。「スキンケア」、「ヘアケア」、「化粧品」は興味関心のあるトピックであり、ナレッジグラフ エンティティ（化粧品の場合は/m/014trlなど）で表されます。最初のグループには「スキンケア」と「ヘアケア」のナレッジグラフ エンティティ属性が含まれ、2 番目のグループには「化粧品」のナレッジグラフ エンティティ属性が含まれます。ナレッジグラフ エンティティ、商品とサービスのカテゴリ、またはユーザーの興味関心を
audience_attributesで指定した場合、audience_combinationsは使用できません。audience_combinationsを使用する場合は、これらの属性をaudience_attributesではなくaudience_combinationsで指定する必要があります。ただし、audience_combinationsと組み合わせて、ユーザー層などの他の属性タイプにaudience_attributesを使用することはできます。クリエイターのトピックに関する分析情報:
search_topicsフィールドを使用して、コンテンツ トピックのリストを指定します。API は、指定されたトピックに関するコンテンツを作成している関連クリエイターを返します。取得されるデータは、country_locationsで指定された国に基づいています。このオプションでは、1 つの国のみを検索できます。SearchTopicsフィールドでサポートされているエンティティには、CONTENT_TRENDING_INSIGHTSまたはCREATOR_TOPIC_INSIGHTSのいずれかの機能のタグを付ける必要があります。ListAudienceInsightsAttributesメソッドを使用して、サポートされているエンティティの機能を取得します。注:
search_brandオプションは v24.2 で非推奨となり、v25 で削除されました。代わりにsearch_topicsを使用してください。クリエイターの分析情報:
search_channelsフィールドを使用して、YouTube チャンネル ID のリストを指定します。API は、これらの特定のチャンネルに関する分析情報を返します。
補足データとローカル クリエイター
デフォルトでは、コアの分析情報データのみが返されます。繰り返しフィールド
supplemental_dataを設定することで、レスポンスでオプション機能と追加データをリクエストできます。
たとえば、LOCAL_CREATOR_DATA 列挙値を supplemental_data
フィールドに追加することで、ローカルのクリエイターデータをリクエストできます。`search_topics`search_topicsを使用してクリエイターを検索する場合（トピックが
`CREATOR_TOPIC_INSIGHTS`CREATOR_TOPIC_INSIGHTS機能のタグが付いたナレッジグラフ
エンティティである場合）、API は
位置情報データの共有に同意したローカルクリエイターを使用して、レスポンスの
local_creator_insightsフィールドに入力します。
ローカル クリエイター検出の仕様は次のとおりです。
- 定義: 「ローカル クリエイター」とは、選択した国に拠点を置くか、その国から投稿し、その国で視聴されているクリエイターです。
- 制約: リクエストで
sub_country_locationsが設定されている場合、ローカル クリエイター検出はサポートされません。 - 機能: サポートされているナレッジグラフ
エンティティとその機能のリストは、
ListAudienceInsightsAttributesを使用して取得できます。
generateCreatorInsights メソッドは GenerateCreatorInsightsResponse
オブジェクトを返します。このオブジェクトには次のフィールドが含まれます。
creator_insights: コアの条件に一致するYouTubeCreatorInsightsオブジェクトのリスト。local_creator_insights: ローカル クリエイターのYouTubeCreatorInsightsオブジェクトのリスト。これは、LOCAL_CREATOR_DATAがリクエストされ、使用された条件がsearch_topicsの場合にのみ入力されます。
各 YouTubeCreatorInsights オブジェクトには、クリエイターに関する次の情報が含まれます。
- クリエイターの名前
- YouTube チャンネル
- クリエイターの指標の合計
- YouTube チャンネルに関する分析情報のリスト
YouTubeMetrics オブジェクトには次の指標が含まれます。
- チャンネル登録者数
- 視聴回数
- 動画数
- アクティブな YouTube ショート クリエイターである
- パートナーシップの機会（v23 以降）
クリエイターがオリジナル ブランドとの共同制作コンテンツのパートナーシップの対象となるかどうかを確認するには、
partnership_opportunitiesを確認します。
リストに
CREATOR_PARTNERSHIPS値が含まれている場合、クリエイターは対象となります。
YouTubeChannelInsights オブジェクトには、YouTube チャンネルに関する次の情報が含まれます。
- チャンネル名
- チャンネル ID
- チャンネル URL
- チャンネルの説明
- チャンネルの指標
- チャンネルのオーディエンス属性（年齢、性別、ユーザーの興味関心の内訳など）
- 人気の動画
- チャネルのタイプ
- チャンネル コンテンツに関連付けられた言語
- 関連性スコア（トピックのトレンド検索の場合のみ）
- クリエイターが非公開の指標の共有に同意しているかどうか
トレンドの分析情報を生成する
トレンドの分析情報を生成するには、
GenerateTrendingInsights メソッドにリクエストを送信します。このメソッドの秒間クエリ数（QPS）の上限は 5 件です。オーディエンスのトレンドを取得するか、トピックのトレンドを取得するかによって、2
種類の入力を使用します。トレンドを取得する特定の国を指定する必要があります。
オーディエンスのトレンド: 年齢、性別、ユーザーの興味関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、これらのオーディエンスのトレンドの分析情報のリストを返します。これには、比較期間におけるトレンドの値の変化率などの指標が含まれます。
利用可能なオーディエンス属性を取得するには、属性を取得するディメンション（興味関心のあるトピックの
KNOWLEDGE_GRAPHなど）を指定して、ListAudienceInsightsAttributesを使用します。Google Ads API v23 以降では、
audience_combinationsを使用して複雑なオーディエンス属性の関係を指定できます。このフィールドを使用すると、audience_attributesでは不可能なブール論理演算（AND/OR）でオーディエンスを定義できます。audience_attributesは、結合された（OR で結合された）属性のリストに基づくターゲティング（「スポーツ」または「旅行」または...に関心のあるユーザーなど）に適していますが、audience_combinationsではより詳細な制御が可能です。audience_combinations内の各InsightsAudienceAttributeGroupは、属性を論理 OR で結合します。これらのグループは、論理 AND で結合されます。たとえば、（「スキンケア」または「ヘアケア」）に関心があり、かつ「化粧品」にも関心のあるオーディエンスをターゲットに設定するには、
audience_combinationsで 2 つのInsightsAudienceAttributeGroupアイテムを使用します。「スキンケア」、「ヘアケア」、「化粧品」は興味関心のあるトピックであり、ナレッジグラフ エンティティ（化粧品の場合は/m/014trlなど）で表されます。最初のグループには「スキンケア」と「ヘアケア」のナレッジグラフ エンティティ属性が含まれ、2 番目のグループには「化粧品」のナレッジグラフ エンティティ属性が含まれます。ナレッジグラフ エンティティ、商品とサービスのカテゴリ、またはユーザーの興味関心を
audience_attributesで指定した場合、audience_combinationsは使用できません。audience_combinationsを使用する場合は、これらの属性をaudience_attributesではなくaudience_combinationsで指定する必要があります。ただし、audience_combinationsと組み合わせて、ユーザー層などの他の属性タイプにaudience_attributesを使用することはできます。KNOWLEDGE_GRAPH属性には、1 つ以上のInsightsKnowledgeGraphEntityCapabilitiesタグが含まれます。トレンドの分析情報でサポートされている属性には、レスポンス メタデータに関連するタグが含まれます。ContentCreatorInsightsServiceにアクセスできるデベロッパーは、AudienceInsightsService.ListAudienceInsightsAttributesにも自動的にアクセスできます。AudienceInsightsServiceの他のエンドポイントには、個別の許可リスト プロセスが必要です。ListAudienceInsightsAttributesの詳細については、 オーディエンス分析ガイドをご覧ください。トピックのトレンド: コンテンツ トピックのリストを指定します。API は、これらのトピックのトレンドの分析情報のリストを返します。これには、比較期間におけるトレンドの値の変化率などの指標が含まれます。補足データをリクエストすることで、ブランド トピックのブランドのセンチメントの分析情報をリクエストすることもできます。
補足データ、ローカル クリエイター、ブランドのセンチメント
クリエイターの分析情報を生成する場合と同様に、
繰り返しフィールド
supplemental_data を LOCAL_CREATOR_DATA または
BRAND_SENTIMENT_DATA に設定することで、トレンドの分析情報でオプション機能をリクエストできます。
トレンドのリクエストで search_topics を使用する場合、supplemental_data を
LOCAL_CREATOR_DATA に設定すると、返された TrendInsight オブジェクト
の
related_local_creators
フィールドに、リクエストされたトピックに関連するローカル クリエイター（位置情報データの共有に同意している）が入力されます。ローカル
クリエイター検出には、同じ定義と制約（sub_country_locations との非互換性など）が適用されます。
トレンドのリクエストで search_topics を使用する場合、supplemental_data を
BRAND_SENTIMENT_DATA に設定すると、返された TrendInsight オブジェクトの
brand_sentiment_insights
フィールドに入力されます。リクエストされたナレッジグラフ エンティティ トピックに BRAND 機能がある場合。ブランド
トピックは、
BRAND
機能のタグが付いたエンティティです。サポートされているエンティティの機能は、
ListAudienceInsightsAttributes メソッドを使用して取得できます。
ブランドのセンチメントを測定するには、AI モデル（Gemini 搭載）を使用して、ブランドに関連する YouTube 動画コンテンツを分析し、センチメントを肯定的、否定的、中立的に分類します。分析されるのは動画コンテンツ自体のみで、ユーザー コメントは含まれません。
トレンドの分析情報のメタデータ
GenerateTrendingInsights メソッドは、TrendInsight オブジェクトのリストを返します。各オブジェクトには次のものが含まれます。
trend_attribute: トレンドのプライマリAudienceInsightsAttributeMetadata。trend_metrics: トレンドの指標（比較期間の変化率など）。trend_data_points: トレンドの過去のデータポイント。search_topicsを使用するトレンドの場合にのみ入力されます。related_videos: トレンドのトピックに関連付けられたトレンドの動画のAudienceInsightsAttributeMetadataオブジェクトのリスト。search_topicsを使用するトレンドの場合にのみ入力されます。これらの属性の場合、ネストされたYouTubeVideoAttributeMetadataが 入力されます。これには、動画レベルのメタデータ（動画 URL、 サムネイル URL、視聴回数、高評価数など）とチャンネルレベルのメタデータ（ チャンネル ID、名前、URL など）が含まれます。brand_sentiment_insights: トレンドのBrandSentimentInsightオブジェクトのリスト。トレンド リクエストでsearch_topicsが使用され、 ナレッジグラフ エンティティ トピックにBRAND機能があり、BRAND_SENTIMENT_DATAがsupplemental_dataでリクエストされている場合にのみ入力されます。各BrandSentimentInsightオブジェクトには次のものが含まれます。month: ブランドのセンチメントを表す月（YYYY-MM形式）。has_insufficient_data: ブランドのセンチメントを計算するのに十分なデータがないかどうか。sentiment_distributions: 肯定的、否定的、中立的なセンチメントの分布。各センチメントのブランドに対応する動画の視聴回数の割合として計算されます。sentiment_summaries: ブランドに関連するコンテンツの肯定的な点と否定的な点に関する AI 生成の要約と、各センチメントのサンプル動画。要約は、肯定的なセンチメントと否定的なセンチメントに対してのみ生成され、中立的なセンチメントに対しては生成されません。