YouTube クリエイター インサイト

注: この機能はベータ版であり、許可リストに登録されているデベロッパーのみが利用できます。

ContentCreatorInsightsService のクリエイター分析情報機能を使用して、YouTube クリエイターに関する分析情報を検出して取得します。このサービスは、代理店や広告主がターゲット オーディエンスに関連するクリエイターを見つけるのに役立ちます。

この API には、主に次の 4 つの機能があります。

1. クリエイターの見つけやすさ: 特定のトピック、ユーザー属性、オーディエンス、クリエイター属性に関連するクリエイターを検索します。
2. クリエイターのトピックに関する分析情報: 指定したトピックに関するコンテンツを制作している関連クリエイターに関する分析情報を取得します。
3. クリエイター インサイト: チャンネル登録者数、視聴回数、視聴者のユーザー属性など、特定の YouTube チャンネルに関するインサイトを取得します。
4. トレンドの分析情報: 特定のオーディエンスまたはトピックに基づいて、特定のトレンドに関する分析情報を取得します。

ローカル クリエイター検索機能（特定の国を拠点とするクリエイター、または特定の国から投稿し、その国で視聴されているクリエイターを検索する）は、トピックベースのクリエイター検索機能またはトレンド インサイトを使用する際に、補足データをリクエストすることでサポートされます。補足データをリクエストすることで、トピックベースのトレンド分析情報に関するブランド センチメント分析情報をリクエストすることもできます。

利用資格要件

GenerateCreatorInsights は、非独占的でロイヤリティフリーのデータ ライセンスで提供される Google Ads API のプライベート コンポーネントです。署名済みのパートナーは、標準の Google 広告クライアント ライブラリを使用して、YouTube クリエイターとコンテンツを検索できます。対象となるには、パートナーは次の条件を満たす必要があります。

• Google Ads API を統合したプランニング ツールまたはユーザー インターフェースがある。
• API を使用して YouTube のコンテンツとクリエイターを調査し、広告掲載の機会を見つけます。
• 事前審査評価を完了して、利用資格を確認します。
• データ使用要件を遵守し、定期的なデータ監査を受ける。
• Google Ads API の利用規約と、関連するデータ利用ポリシーに同意します。

詳しくは、Google 担当者にお問い合わせください。

クリエイター インサイトを生成する

クリエイターの分析情報を生成するには、GenerateCreatorInsights メソッドにリクエストを送信します。このメソッドには、1 秒あたり 5 クエリ（QPS）の上限があります。クリエイターの見つけやすさ、トピックベースのクリエイター検索、チャンネル固有のクリエイター インサイトのいずれを希望するかに応じて、異なる条件を受け入れます。対象国のロケーションを country_locations で指定する必要があります。

1. クリエイターの見つけやすさ（search_attributes）: search_attributes フィールドを使用して、オーディエンスの属性（年齢、性別、ユーザーの興味 / 関心（アフィニティ、購買意向、ライフイベント オーディエンスなど））のリストを指定し、オーディエンスがそれらの属性に一致するクリエイターを見つけます。クリエイター属性を指定して、コンテンツが特定の属性に一致するクリエイターをフィルタすることもできます。

   ListAudienceInsightsAttributes を使用して、必要なディメンション（関心のあるトピックの KNOWLEDGE_GRAPH など）を指定して、利用可能なオーディエンス属性を取得します。ブール値の AND グループと OR グループを使用して属性を組み合わせるには、複雑なオーディエンスの組み合わせで説明されているように audience_combinations を使用します。

2. クリエイターのトピック分析情報（search_topics）: search_topics フィールドを使用して、コンテンツ トピックのリストを提供します。この API は、指定されたトピックに関するコンテンツを制作している関連クリエイターを返します。データは、country_locations で指定された国に対して取得されます（このオプションでは、リクエストごとに 1 つの国がサポートされます）。

   search_topics でサポートされているエンティティには、CONTENT_TRENDING_INSIGHTS または CREATOR_TOPIC_INSIGHTS のいずれかの機能のタグを付ける必要があります。ListAudienceInsightsAttributes を使用して、サポートされているエンティティの機能を取得します。

   注: search_brand オプションは v24 で非推奨となり、v25 で削除されました。代わりに search_topics を使用してください。

3. クリエイター インサイト（search_channels）: search_channels フィールドを使用して、YouTube チャンネル ID、YouTube チャンネル ハンドル（youtube_channel_handles、v25 以降で使用可能）、またはその両方の組み合わせのリストを指定します。API は、それらの特定のチャネルに関する分析情報を返します。

複雑なオーディエンスの組み合わせ

GenerateCreatorInsights と GenerateTrendingInsights の両方で、audience_combinations を使用して複雑なオーディエンス属性の関係を定義できます。このフィールドを使用すると、audience_attributes のフラットな結合（OR）動作を超えて、ブールロジック（AND と OR）で統合オーディエンス属性を結合できます。

• audience_combinations 内の各 InsightsAudienceAttributeGroup は、その属性を論理 OR と組み合わせます。
• audience_combinations 内の複数の InsightsAudienceAttributeGroup 項目は、論理 AND と組み合わされます。

たとえば、（"Skin care" OR "Hair care"）AND "Cosmetics" に興味があるオーディエンスをターゲットにするには、audience_combinations に 2 つの InsightsAudienceAttributeGroup アイテムを含めます。

1. "Skin care" と "Hair care" のナレッジグラフ エンティティ属性を含むグループ 1。
2. "Cosmetics" のナレッジグラフ エンティティ属性（/m/014trl など）を含むグループ 2。

注: audience_combinations でナレッジグラフ エンティティ、商品とサービスのカテゴリ、ユーザーの興味 / 関心を指定する場合、audience_attributes でこれらの属性タイプを指定することはできません。audience_combinations とともに、ユーザー属性フィルタ（年齢や性別など）に audience_attributes を引き続き使用できます。

補足データとローカル クリエイター

デフォルトでは、コア インサイト データのみが返されます。繰り返しフィールド supplemental_data を設定することで、レスポンスでオプション機能と追加データをリクエストできます。

たとえば、LOCAL_CREATOR_DATA 列挙値を supplemental_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 オブジェクトには、次のものが含まれます。

• creator_name: クリエイターの名前。
• creator_channels: YouTubeChannelInsights オブジェクトのリスト。チャンネルの詳細と channel_metrics（YouTubeMetrics）は、creator_channels の各 YouTubeChannelInsights オブジェクト内に返されます。

YouTubeMetrics オブジェクトには、次のものが含まれます。

• チャンネル登録者数、視聴回数、動画数
• チャンネルのすべての動画における高評価、共有、コメントの合計数
• 全期間のエンゲージメント率（合計エンゲージメント数を合計視聴回数で割った値）
• 過去 28 日間の動画あたりの平均視聴回数、高評価数、共有数、コメント数
• ショート動画の視聴回数と動画数
• クリエイターがアクティブな YouTube ショート クリエイターまたはアクティブなライブ配信クリエイターであるかどうか（過去 90 日間に 1 本公開しているかどうか）
• パートナーシップの機会

エンゲージメント率、動画あたりの平均視聴回数、高評価数、コメント数は、クリエイターが共有に同意した場合にのみ入力される非公開の指標です。

クリエイターがオリジナル ブランドとの共同制作コンテンツのパートナーシップの対象かどうかを確認するには、partnership_opportunities を調べます。リストに CREATOR_PARTNERSHIPS が含まれている場合、クリエイターは対象となります。

YouTubeChannelInsights オブジェクトには、YouTube チャンネルに関する次の情報が含まれています。

• チャンネル名、ID、ハンドル、URL、説明、サムネイル URL
• チャンネルの作成日と関連付けられている国
• チャンネルの指標
• チャンネルの視聴者の属性（年齢、性別、ユーザーの興味や関心の内訳など）
• チャンネルの属性（チャンネルのコンテンツに関連付けられた属性）
• 人気の動画
• チャンネル タイプとコンテンツの言語
• 関連性スコア（急上昇ワード検索のみ）
• クリエイターが非公開の指標の共有に同意しているかどうか

GenerateCreatorInsights のリクエストとレスポンスのリファレンス

次のエンドポイントで ContentCreatorInsightsService の GenerateCreatorInsights を呼び出します。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

次の表に、GenerateCreatorInsightsRequest のフィールドをまとめます。

フィールドのパス	要件	形式と制限事項
customer_id	必須	10 桁のお客様 ID（string）（ハイフンなし）。
customer_insights_group	必須	計画対象の顧客またはブランドのユーザー定義名（string）。
country_locations[]	必須	国 LocationInfo オブジェクトのリスト（geo_target_constant、"geoTargetConstants/2840" など）。search_topics を使用する場合は、1 つの国を含める必要があります。
sub_country_locations[]	省略可	サブカントリー LocationInfo フィルタ。search_attributes でのみサポートされ、LOCAL_CREATOR_DATA とは互換性がありません。
search_attributes	criteria（oneof）	SearchAttributes には以下が含まれます。 • audience_attributes[]: age_range、gender、device、parental_status、income_range（audience_combinations が未使用の場合は user_interest、entity、category も）。 • audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup アイテム。 • creator_attributes[]: CREATOR_ATTRIBUTE 機能を備えたナレッジグラフ entity アイテム。
search_topics	criteria（oneof）	SearchTopics に entities[] が含まれている（AudienceInsightsEntity に knowledge_graph_machine_id が含まれ、CREATOR_TOPIC_INSIGHTS または CONTENT_TRENDING_INSIGHTS のタグが付いている）。
search_channels	criteria（oneof）	YouTubeChannels。youtube_channels[]（channel_id）または youtube_channel_handles[]（@ で始まるハンドル（"@youtubecreators" など））が含まれます。
supplemental_data[]	省略可	ContentCreatorInsightsSupplementalData 値。local_creator_insights[] を入力するには、単一国の search_topics リクエスト（CREATOR_TOPIC_INSIGHTS を含むエンティティの場合）で LOCAL_CREATOR_DATA を設定します。
insights_application_info	省略可	AdditionalApplicationInfo: リクエストを発行するアプリケーションに関するメタデータ。

GenerateCreatorInsightsResponse メッセージは、次のフィールドを返します。

レスポンス フィールド	タイプ	説明
creator_insights[]	YouTubeCreatorInsights	コア条件（creator_name と creator_channels[]）に一致するクリエイター。
local_creator_insights[]	YouTubeCreatorInsights	位置情報の共有に同意したローカル クリエイター（CREATOR_TOPIC_INSIGHTS を持つエンティティで search_topics を指定して LOCAL_CREATOR_DATA がリクエストされた場合に入力されます）。
creator_channels[]	YouTubeChannelInsights	メタデータ: display_name、youtube_channel.channel_id、handle、channel_url、publish_date、country_location、data_sharing_consent_given。 分析情報とコンテンツ: channel_audience_attributes[]（同意が必要）、channel_attributes[]、top_videos[]、language_distributions[]、relevance_score（search_topics を含む GenerateTrendingInsights の場合のみ入力）、channel_metrics。
channel_metrics	YouTubeMetrics	公開指標: subscriber_count、views_count、video_count、likes_count、shares_count、comments_count、shorts_views_count、shorts_video_count、is_active_shorts_creator、is_active_live_stream_creator、partnership_opportunities[]。 同意が必要な指標: engagement_rate、動画ごとの 28 日間の平均（average_views_per_video、average_likes_per_video、average_shares_per_video、average_comments_per_video）。

GenerateCreatorInsights REST リクエストとレスポンスの例

次の例では、searchAttributes を使用して、audienceAttributes（デモグラフィック）、audienceCombinations（ブール値、"Skin care" OR "Hair care"、AND "Cosmetics"）、creatorAttributes を使用してクリエイターを検出します。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

トピックベースのクリエイターとローカル クリエイターを取得するには、searchTopics を使用し、supplementalData に "LOCAL_CREATOR_DATA" を含めます。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

チャンネル ID またはハンドルで特定の YouTube チャンネルの分析情報を取得するには、searchChannels を使用します。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

GenerateCreatorInsightsResponse が成功すると、creatorInsights[] が返されます（LOCAL_CREATOR_DATA がリクエストされた場合は localCreatorInsights[] も返されます）。

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

トレンド インサイトを生成する

トレンド分析情報を生成するには、GenerateTrendingInsights メソッドにリクエストを送信します。このメソッドには、1 秒あたり 5 クエリ（QPS）の上限があります。オーディエンス トレンドとトピック トレンドのどちらを必要とするかに応じて、2 種類の入力を受け入れます。また、対象国の場所が必要です。

1. オーディエンス トレンド（search_audience）: search_audience の audience_attributes フィールドにオーディエンス属性（年齢、性別、ユーザーの興味 / 関心など）のリストを指定します。必要に応じて、audience_combinations を使用して、ブール値の AND / OR ロジックで属性を組み合わせます。API は、比較期間におけるトレンド値の変化率などの指標を含む、それらのオーディエンスのトレンド インサイトのリストを返します。

   ContentCreatorInsightsService にアクセスできるデベロッパーは、AudienceInsightsService の ListAudienceInsightsAttributes に自動的にアクセスできます（オーディエンス分析ガイドをご覧ください）。AudienceInsightsService の他のエンドポイントには、別の許可リストが必要です。

2. トピックのトレンド（search_topics）: search_topics フィールドにコンテンツ トピックのリストを指定します。API は、比較期間におけるトレンド値の変化率など、これらのトピックのトレンド分析情報を返します。supplemental_data を設定して、ローカル クリエイターまたはブランド センチメントの分析情報をリクエストすることもできます。

   ListAudienceInsightsAttributes によって返される KNOWLEDGE_GRAPH 属性には、1 つ以上の InsightsKnowledgeGraphEntityCapabilities タグが含まれます。CONTENT_TRENDING_INSIGHTS タグが付けられたエンティティは、GenerateTrendingInsights のトピックとしてサポートされます。

補足データとローカル クリエイター

クリエイター分析情報の生成と同様に、繰り返しフィールド supplemental_data を LOCAL_CREATOR_DATA または BRAND_SENTIMENT_DATA に設定することで、トレンド分析情報のオプション機能をリクエストできます。

• ローカル クリエイター（LOCAL_CREATOR_DATA）: 急上昇リクエストで search_topics を使用する場合（かつ、トピックが CREATOR_TOPIC_INSIGHTS 機能でタグ付けされたナレッジグラフ エンティティの場合）、supplemental_data を LOCAL_CREATOR_DATA に設定すると、返された TrendInsight オブジェクトの related_local_creators フィールドに、位置情報の共有に同意した関連するローカル クリエイターが入力されます。ローカル クリエイター検索機能は sub_country_locations に対応していません。
• ブランドのセンチメント（BRAND_SENTIMENT_DATA）: トレンド リクエストで search_topics を使用し、リクエストされたナレッジグラフ エンティティ トピックに BRAND 機能がある場合、supplemental_data を BRAND_SENTIMENT_DATA に設定すると、返された TrendInsight オブジェクトの brand_sentiment_insights フィールドに値が入力されます。

ブランド センチメントの測定では、Gemini AI モデルを使用して、ブランドに関連する YouTube 動画コンテンツを分析し、センチメントをポジティブ、ネガティブ、ニュートラルに分類します。分析されるのは動画コンテンツ自体のみで、ユーザーのコメントは含まれません。

トレンド インサイトのメタデータ

GenerateTrendingInsights メソッドは、TrendInsight オブジェクトのリストを返します。各オブジェクトには次のものが含まれます。

• trend_attribute: トレンドのプライマリ AudienceInsightsAttributeMetadata。
• trend_metrics: トレンドの指標（比較期間の変化率など）。
• trend: トレンドの方向を示す InsightsTrend 値（EMERGING、RISING、SUSTAINED、DECLINING）。変更のサイズについては、trend_metrics.trend_change_percent をご覧ください。
• trend_data_points: トレンドの過去のデータポイント。search_topics を使用するトレンドにのみ入力されます。
• related_videos: トレンドのトピックに関連する急上昇動画の AudienceInsightsAttributeMetadata オブジェクトのリスト（search_topics を使用するトレンドにのみ入力されます）。これらの属性の場合、ネストされた YouTubeVideoAttributeMetadata には、動画レベルのメタデータ（URL、サムネイル URL、視聴回数、高評価数）とチャンネルレベルのメタデータ（チャンネル ID、名前、URL）が入力されます。
• related_creators: トレンドのトピックに関連するクリエイターの YouTubeCreatorInsights オブジェクトのリスト（search_topics を使用するトレンドにのみ入力されます）。
• related_local_creators: トレンドのトピックに関連するローカル クリエイターの YouTubeCreatorInsights オブジェクトのリスト。これらのクリエイターは、位置情報の共有に同意しています。LOCAL_CREATOR_DATA がリクエストされた場合にのみ入力されます（補足データ、ローカル クリエイター、ブランド センチメントをご覧ください）。
• brand_sentiment_insights: トレンドの BrandSentimentInsight オブジェクトのリスト（リクエストが BRAND 機能を備えたエンティティに search_topics を使用し、BRAND_SENTIMENT_DATA をリクエストする場合に設定されます）。各 BrandSentimentInsight オブジェクトには次のものが含まれます。
  • month: ブランド センチメントが表す月（YYYY-MM 形式）。
  • has_insufficient_data: ブランドのセンチメントを計算するのに十分なデータがないかどうか。
  • sentiment_distributions: 肯定的、否定的、中立的なセンチメントの分布。各センチメントのブランドに対応する動画の視聴回数の割合として計算されます。
  • sentiment_summaries: ブランドに関連するコンテンツのポジティブなテーマとネガティブなテーマの AI 生成による要約と、各感情のサンプル動画。要約は、ニュートラルではなく、ポジティブなセンチメントとネガティブなセンチメントに対してのみ生成されます。

GenerateTrendingInsights のリクエストとレスポンスのリファレンス

次のエンドポイントで ContentCreatorInsightsService の GenerateTrendingInsights を呼び出します。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

次の表に、GenerateTrendingInsightsRequest のフィールドをまとめます。

フィールドのパス	要件	形式と制限事項
customer_id	必須	10 桁のお客様 ID（string）（ハイフンなし）。
customer_insights_group	必須	計画対象の顧客またはブランドのユーザー定義名（string）。
country_location	必須	単一の国 LocationInfo（geo_target_constant、例: "geoTargetConstants/2840"）。
sub_country_locations[]	省略可	サブカントリー LocationInfo フィルタ。search_audience でのみサポートされ、LOCAL_CREATOR_DATA とは互換性がありません。
search_audience	criteria（oneof）	SearchAudience。次の要素が含まれます。 • audience_attributes[]（必須）: age_range、gender、parental_status、income_range（audience_combinations が使用されていない場合は、user_interest、entity、category も）。 • audience_combinations[]（省略可）: AND-of-ORs 属性グループ。
search_topics	criteria（oneof）	entities[] を含む SearchTopics（CONTENT_TRENDING_INSIGHTS でタグ付けされた knowledge_graph_machine_id を含む AudienceInsightsEntity）。
supplemental_data[]	省略可	ContentCreatorInsightsSupplementalData の値: • LOCAL_CREATOR_DATA: search_topics エンティティの related_local_creators[] に CREATOR_TOPIC_INSIGHTS を入力します。 • BRAND_SENTIMENT_DATA: search_topics エンティティの brand_sentiment_insights[] に BRAND を入力します。
insights_application_info	省略可	AdditionalApplicationInfo: リクエストを発行するアプリケーションに関するメタデータ。

GenerateTrendingInsightsResponse メッセージは、trend_insights[] の TrendInsight エントリを返します。

TrendInsight フィールド	タイプ	説明
trend_attribute	AudienceInsightsAttributeMetadata	トレンドのプライマリ属性（dimension、display_name、attribute）。
trend_metrics	TrendInsightMetrics	3 か月の比較期間の指標（search_topics の views_count と views_indexed_value、search_audience の audience_share、trend_change_percent）。
trend	InsightsTrend	トレンドの方向（EMERGING、RISING、SUSTAINED、DECLINING）。
trend_data_points[]	TrendInsightDataPoint	月次の過去のデータ（YYYY-MM 形式の month と trend_metrics）。search_topics に入力されます。
related_videos[]	AudienceInsightsAttributeMetadata	YouTubeVideoAttributeMetadata を含む急上昇動画。search_topics のデータが入力されます。
related_creators[]	YouTubeCreatorInsights	トピックに関連するクリエイター。search_topics に入力されます。
related_local_creators[]	YouTubeCreatorInsights	同意しているローカル クリエイター。CREATOR_TOPIC_INSIGHTS を含むエンティティで LOCAL_CREATOR_DATA がリクエストされた場合に、search_topics に入力されます。
brand_sentiment_insights[]	BrandSentimentInsight	月次のブランド センチメント（month、has_insufficient_data、sentiment_distributions[]、sentiment_summaries[]）。BRAND 機能を備えたエンティティで BRAND_SENTIMENT_DATA がリクエストされた場合に、search_topics に入力されます。

GenerateTrendingInsights REST リクエストとレスポンスの例

次の例では、ナレッジグラフのブランド エンティティ（/g/11example_brand、CONTENT_TRENDING_INSIGHTS、CREATOR_TOPIC_INSIGHTS、BRAND のタグ付き）に searchTopics を使用して GenerateTrendingInsights を呼び出し、LOCAL_CREATOR_DATA と BRAND_SENTIMENT_DATA の両方をリクエストします。

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

GenerateTrendingInsightsResponse が成功すると、trendInsights[] に TrendInsight エントリが返されます。

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Google Issue Tracker

Google Issue Tracker を使用して、サポートに関する質問、バグの報告、機能リクエストの送信を行います。Google は、Issue Tracker でリクエストを直接追跡し、優先順位を付けて、更新情報を投稿します。詳細については、Google Issue Tracker で問題を作成するをご覧ください。

次のいずれかの Issue Tracker テンプレートを使用して問題を作成します。

• 一般的なサポートに関する質問をする、ドキュメントのフィードバックを送信する
• 技術的なバグを報告する
• API の機能リクエストを送信する

Google がリクエストを再現して優先順位を付けられるように、テンプレートのすべてのフィールドに詳細な情報を入力します。不完全なレポートはクローズされ、不足している詳細情報を記載した新しい問題を送信するよう求められることがあります。