クリエイター分析情報機能を使用して、YouTube クリエイターに関する分析情報を検出して取得します。これは、ターゲット オーディエンスに関連するクリエイターを見つけたい広告代理店や広告主にとって有用です。
この API には次の 4 つの主な機能があります。
- クリエイターの検出可能性: 特定のトピック、ユーザー属性、オーディエンス、クリエイター属性に関連性の高いクリエイターを見つけます。
- クリエイターのトピックに関する分析情報: 指定されたトピックに関するコンテンツを作成している関連クリエイターに関する分析情報を取得します。
- クリエイターの分析情報: 特定の YouTube チャンネルに関する分析情報（チャンネル登録者数、視聴回数、視聴者のユーザー属性など）を取得します。
- トレンドの分析情報: 特定のオーディエンスやトピックに基づいて、特定のトレンドに関する分析情報を取得します。
トピックベースのクリエイター検出またはトレンド分析を使用し、補足データをリクエストすることで、ローカル クリエイター検出（特定の国に拠点を置くか、その国から投稿し、その国で視聴されているクリエイターを見つける）がサポートされます。補足データをリクエストすることで、トピックベースのトレンド分析情報に関するブランドの感情分析情報をリクエストすることもできます。
利用資格要件
GenerateCreatorInsights は、非独占的かつロイヤリティ フリーのデータ ライセンスで提供される Google Ads API の非公開コンポーネントです。契約済みのパートナーは、標準の Google 広告クライアント ライブラリを使用して、YouTube のクリエイターとコンテンツを検索できます。対象となるには、パートナーは次の条件を満たしている必要があります。
- Google Ads API を統合するプランニング ツールまたはユーザー インターフェースがある。
- API を使用して YouTube のコンテンツとクリエイターを調べ、広告掲載の機会を探します。
- 事前スクリーニング評価を完了して、利用資格を確認します。
- データ使用要件を遵守し、定期的なデータ監査を受けることに同意している。
- データ使用要件を法的に強制するデータ ライセンス契約に署名します。
- Google Ads API の利用規約に同意します。
詳しくは、Google 担当者にお問い合わせください。
クリエイターの分析情報を生成する
クリエイターの分析情報を生成するには、GenerateCreatorInsights メソッドにリクエストを送信します。このメソッドには、1 秒あたりのクエリ数（QPS）が 5 という上限があります。クリエイターの検出可能性を高めるか、トピック別にクリエイターを検索するか、クリエイターの分析情報を取得するかによって、入力の種類が異なります。データを取得する国のロケーションを指定する必要があります。
クリエイターの検出可能性: 年齢、性別、ユーザーの興味 / 関心（アフィニティ カテゴリ、購買意向の強いユーザー層、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、オーディエンスがこれらの属性に一致するクリエイターのリストを返します。クリエイター属性を指定して、入力したクリエイター属性にコンテンツが一致するクリエイターをフィルタすることもできます。
ListAudienceInsightsAttributesを使用して、利用可能なオーディエンス属性を取得できます。このとき、属性を取得するディメンション（インタレスト カテゴリのKNOWLEDGE_GRAPHなど）を指定します。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_attributesは、audience_combinationsと組み合わせて、ユーザー属性などの他の属性タイプに使用できます。クリエイターのトピックに関する分析情報:
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、YouTube チャンネル ハンドル（v25.2 以降）、またはその両方のリストを指定します。API は、これらの特定のチャネルに関する分析情報を返します。
補足データとローカル クリエイター
デフォルトでは、コア分析情報データのみが返されます。繰り返しフィールド supplemental_data を設定することで、レスポンスでオプション機能と追加データをリクエストできます。
たとえば、supplemental_data フィールドに LOCAL_CREATOR_DATA 列挙値を追加することで、ローカル クリエイターのデータをリクエストできます。search_topics を使用してクリエイターを検索する場合（トピックが 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 は、これらのユーザーのトレンドの分析情報のリストを返します。これには、比較期間におけるトレンドの値の変化率などの指標が含まれます。
ListAudienceInsightsAttributesを使用して、利用可能なオーディエンス属性を取得できます。たとえば、関心のあるトピックのKNOWLEDGE_GRAPHなど、属性を取得するディメンションを指定します。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_attributesを使用して、audience_combinationsと組み合わせて、ユーザー属性などの他の属性タイプを指定することはできます。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 を使用している場合、リクエストされたナレッジグラフ エンティティのトピックに BRAND 機能があるときに、supplemental_data を BRAND_SENTIMENT_DATA に設定すると、返された TrendInsight オブジェクトの brand_sentiment_insights フィールドに値が入力されます。ブランド トピックは、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機能があり、supplemental_dataでBRAND_SENTIMENT_DATAがリクエストされた場合にのみ入力されます。各BrandSentimentInsightオブジェクトには、次のものが含まれます。month: ブランドの感情を表す月（YYYY-MM形式）。has_insufficient_data: ブランドのセンチメントを計算するのに十分なデータがないかどうか。sentiment_distributions: 肯定的、否定的、中立的なセンチメントの分布。各センチメントでブランドに対応する動画の視聴回数の割合として計算されます。sentiment_summaries: ブランドに関連するコンテンツについて、ポジティブな点とネガティブな点を AI が要約したものです。各感情のサンプル動画も含まれます。要約は、肯定的なセンチメントと否定的なセンチメントに対してのみ生成され、中立的なセンチメントに対しては生成されません。