使用創作者洞察功能，發掘並取得 YouTube 創作者的洞察資料。如果代理商和廣告主想尋找與目標對象相關的創作者，這項功能就非常實用。
這個 API 主要有四項功能：
- 創作者曝光度：根據一組主題、客層、目標對象或創作者屬性，尋找相關創作者。
- 創作者主題洞察：取得製作特定主題內容的相關創作者洞察資料。
- 創作者洞察：取得特定 YouTube 頻道的洞察資料，例如訂閱人數、觀看次數和觀眾客層。
- 熱門洞察：根據特定目標對象或主題，取得特定趨勢的洞察資料。
使用主題式創作者探索或熱門洞察資料時，只要要求補充資料，即可探索當地創作者 (尋找位於特定國家/地區或從該國家/地區發布內容，且在該國家/地區獲得觀看的創作者)。你也可以要求補充資料，取得主題式熱門趨勢洞察資料的品牌情緒洞察資料。
資格規定
GenerateCreatorInsights 是 Google Ads API 的私有元件，提供非專屬免權利金的資料授權。簽約合作夥伴可以使用標準的 Google Ads 用戶端程式庫，探索 YouTube 創作者和內容。如要符合資格，合作夥伴必須滿足下列條件：
- 擁有可整合 Google Ads API 的規劃工具或使用者介面。
- 使用 API 探索 YouTube 內容和創作者，尋找潛在的廣告商機。
- 完成預先篩選評估，確認是否符合資格。
- 遵守資料使用規定，並願意接受定期資料稽核。
- 簽署資料授權協議，確保資料使用符合法律規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
生成創作者洞察資料
如要產生創作者洞察資料，請向 GenerateCreatorInsights 方法發出要求。這個方法的限制為每秒查詢次數 (QPS)。視您想提高創作者曝光度、依主題搜尋相關創作者，還是取得創作者洞察資料而定，輸入內容的類型也會有所不同。您必須提供要從中取得資料的國家/地區位置。
創作者曝光度：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回目標對象符合這些屬性的創作者清單。您也可以提供創作者屬性，篩選出內容與輸入的創作者屬性相符的創作者。
您可以透過
ListAudienceInsightsAttributes擷取可用的目標對象屬性，方法是提供您要取得屬性的維度，例如興趣主題的KNOWLEDGE_GRAPH。自 Google Ads API 第 23 版起，您可以使用
audience_combinations指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是audience_attributes無法做到的。audience_attributes適合根據聯集 (以 OR 組合) 屬性清單指定目標 (例如對「運動」或「旅遊」或...感興趣的使用者)，而audience_combinations則提供更精細的控制選項。InsightsAudienceAttributeGroup內的每個InsightsAudienceAttributeGroup都會以邏輯 OR 結合屬性。這些群組隨後會以邏輯 AND 結合。audience_combinations舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在
audience_combinations中使用兩個InsightsAudienceAttributeGroup項目。「護膚」、「護髮」和「化妝品」是興趣主題，由知識圖譜實體代表 (例如化妝品的/m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。請注意，如果在
audience_attributes中指定 Knowledge Graph 實體、產品和服務類別或使用者興趣，就無法使用audience_combinations。如果使用audience_combinations，就必須在audience_combinations中指定這些屬性，而非audience_attributes；不過，您仍可將audience_attributes用於其他屬性類型，例如與audience_combinations搭配使用的人口統計資料。創作者主題洞察：使用
search_topics欄位提供內容主題清單。API 會傳回製作指定主題內容的相關創作者。系統會根據country_locations中指定的國家/地區擷取資料。請注意，這個選項只能搜尋一個國家/地區。SearchTopics欄位中支援的實體必須標記CONTENT_TRENDING_INSIGHTS或CREATOR_TOPIC_INSIGHTS功能。使用ListAudienceInsightsAttributes方法擷取支援的實體功能。注意：
search_brand選項已在 24.2 版中淘汰，並在 25 版中移除。請改用search_topics。創作者洞察：使用
search_channels欄位提供 YouTube 頻道 ID 清單。API 會傳回這些特定通路的洞察資料。
增補資料和當地創作者
根據預設，系統只會傳回核心洞察資料。您可以設定重複欄位 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 物件都包含下列建立者資訊：
- 創作者名稱
- YouTube 頻道
- 創作者指標總數
- YouTube 頻道洞察資料清單
YouTubeMetrics 物件包含下列指標：
- 訂閱人數
- 觀看次數
- 影片數量
- 是活躍的 Shorts 創作者
- 合作夥伴商機 (從第 23 版開始)
如要判斷創作者是否符合原創品牌內容合作夥伴資格，請檢查 partnership_opportunities；如果清單包含 CREATOR_PARTNERSHIPS 值，即表示創作者符合資格。
YouTubeChannelInsights 物件包含 YouTube 頻道的下列資訊：
- 頻道名稱
- 頻道 ID
- 頻道網址
- 頻道說明
- 管道指標
- 頻道觀眾屬性 (例如年齡、性別和使用者興趣細分)
- 熱門影片
- 管道類型
- 與頻道內容相關聯的語言
- 相關分數 (僅限主題趨勢搜尋)
- 創作者是否同意分享非公開指標
生成熱門趨勢洞察資料
如要生成熱門洞察，請向 GenerateTrendingInsights 方法發出要求。這個方法的限制為每秒 5 次查詢 (QPS)。視您想取得目標對象趨勢或主題趨勢而定，系統會要求您提供兩種輸入內容。您必須提供要取得趨勢的特定國家/地區。
目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的熱門洞察資料清單，包括趨勢值的變化百分比等指標 (與比較期間相比)。
您可以透過
ListAudienceInsightsAttributes擷取可用的目標對象屬性，方法是提供您要取得屬性的維度，例如興趣主題的KNOWLEDGE_GRAPH。自 Google Ads API 第 23 版起，您可以使用
audience_combinations指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是audience_attributes無法做到的。audience_attributes適合根據聯集 (以 OR 組合) 屬性清單指定目標 (例如對「運動」或「旅遊」或...感興趣的使用者)，而audience_combinations則提供更精細的控制選項。InsightsAudienceAttributeGroup內的每個InsightsAudienceAttributeGroup都會以邏輯 OR 結合屬性。這些群組隨後會以邏輯 AND 結合。audience_combinations舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在
audience_combinations中使用兩個InsightsAudienceAttributeGroup項目。「護膚」、「護髮」和「化妝品」是興趣主題，由知識圖譜實體代表 (例如化妝品的/m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。請注意，如果在
audience_attributes中指定 Knowledge Graph 實體、產品和服務類別或使用者興趣，就無法使用audience_combinations。如果使用audience_combinations，就必須在audience_combinations中指定這些屬性，而非audience_attributes；不過，您仍可將audience_attributes用於其他屬性類型，例如與audience_combinations搭配使用的人口統計資料。KNOWLEDGE_GRAPH屬性會有一或多個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，即可在要求的知識圖譜實體主題具備 BRAND 功能時，填入傳回的 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，其中包含影片層級中繼資料 (例如影片網址、縮圖網址，以及觀看次數或按讚次數) 和頻道層級中繼資料 (例如頻道 ID、名稱和網址)。brand_sentiment_insights：趨勢的BrandSentimentInsight物件清單。只有在趨勢要求使用search_topics、知識圖譜實體主題具有BRAND功能，且BRAND_SENTIMENT_DATA是在supplemental_data中要求時，才會填入這個值。每個BrandSentimentInsight物件都包含：month：以YYYY-MM格式表示品牌情緒的月份。has_insufficient_data：是否有足夠資料可供計算品牌情緒。sentiment_distributions：正面、負面和中立情緒的分布情況，計算方式為與品牌相應的影片觀看次數比例。sentiment_summaries：AI 生成的摘要，說明與品牌相關內容的正面和負面評價，以及每種情緒的範例影片。摘要只會針對正面和負面觀感生成，不會針對中立觀感生成。