使用創作者洞察功能，發掘並取得 YouTube 創作者的洞察資料。如果代理商和廣告主想尋找與目標對象相關的創作者，這項功能就非常實用。
這個 API 主要有四項功能：
- 創作者曝光度：根據特定主題、客層、目標對象或創作者屬性，找出頂尖創作者。
- 創作者品牌洞察：取得與特定品牌相關的創作者洞察資料。
- 創作者洞察資料：取得特定 YouTube 頻道的洞察資料，例如訂閱人數、觀看次數和目標對象客層。
- 熱門洞察：根據特定目標對象或主題，取得特定趨勢的洞察資料。
資格規定
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私有元件，提供非專屬免權利金的資料授權。簽約合作夥伴可以使用標準的 Google Ads 用戶端程式庫，探索 YouTube 創作者和內容。如要符合資格，合作夥伴必須符合下列條件：
- 擁有可整合 Google Ads API 的規劃工具或使用者介面。
- 使用 API 探索 YouTube 內容和創作者，尋找潛在的廣告商機。
- 完成預先篩選評估，確認是否符合資格。
- 遵守資料使用規定，並願意接受定期資料稽核。
- 簽署資料授權協議，確保資料使用符合法律規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
生成創作者洞察資料
如要產生創作者洞察資料，請向 ContentCreatorInsightsService.GenerateCreatorInsights 方法發出要求。這個方法的每秒查詢次數 (QPS) 上限為 5 次，並會根據您想進行創作者探索、創作者品牌洞察或取得創作者洞察資訊，採用三種輸入類型。你必須提供要從中取得資料的國家/地區位置。
產生 CreatorInsights 輸入內容：您可以提供要取得屬性的維度 (例如感興趣的主題
KNOWLEDGE_GRAPH)，使用AudienceInsightsService.ListAudienceInsightsAttributes擷取可用屬性。KNOWLEDGE_GRAPH屬性會有一或多個InsightsKnowledgeGraphEntityCapabilities標記。創作者洞察資料支援的屬性，會在回應中繼資料中顯示相關標記。請注意，如果開發人員有權存取
ContentCreatorInsightsService，也會自動獲得AudienceInsightsService.ListAudienceInsightsAttributes的存取權。AudienceInsightsService中的其他端點則需要獨立的許可清單程序。如需
ListAudienceInsightsAttributes的其他說明文件，請參閱目標對象洞察指南。創作者曝光度：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回目標對象符合這些屬性的創作者清單。您也可以提供創作者屬性，篩選出內容與輸入的創作者屬性相符的創作者。
自 Google Ads API 第 23 版起，您可以使用
audience_combinations指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是audience_attributes無法做到的。audience_attributes適合根據聯集 (以 OR 組合) 屬性清單指定目標，例如對「運動」或「旅遊」或 ... 感興趣的使用者，而audience_combinations則提供更精細的控制選項。audience_combinations中的每個InsightsAudienceAttributeGroup都會以邏輯 OR 組合屬性。這些群組隨後會以邏輯 AND 組合。舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在
audience_combinations中使用兩個InsightsAudienceAttributeGroup項目。「護膚」、「護髮」和「化妝品」是興趣主題，以知識圖譜實體表示 (例如化妝品的/m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。請注意，如果您在
audience_attributes中指定知識圖譜實體、產品與服務類別或使用者興趣，就無法使用audience_combinations。如果您使用audience_combinations，就必須在audience_combinations中指定這些屬性，而不是在audience_attributes中指定；不過，您還是可以將audience_attributes用於其他屬性類型 (例如客層)，並搭配audience_combinations使用。創作者品牌洞察：提供品牌名稱，搜尋頂尖創作者。API 會傳回符合條件的頻道洞察資料。
創作者洞察：提供 YouTube 頻道 ID 清單。API 會傳回這些特定頻道的洞察資料。
generateCreatorInsights 方法會傳回 GenerateCreatorInsightsResponse 物件。這個物件包含 YouTubeCreatorInsights 物件的清單。每個 YouTubeCreatorInsights 物件都包含下列建立者資訊：
- 創作者名稱
- YouTube 頻道
- 創作者指標總數
- YouTube 頻道洞察資料清單
YouTubeMetrics 物件包含下列指標：
- 訂閱人數
- 觀看次數
- 影片數量
- 是活躍的 Shorts 創作者
- 合作夥伴商機 (自 23 版起)
如要判斷創作者是否符合原創品牌內容合作夥伴資格，請檢查 partnership_opportunities；如果清單包含 CREATOR_PARTNERSHIPS 值，即表示創作者符合資格。
YouTubeChannelInsights 物件包含 YouTube 頻道的下列資訊：
- 頻道名稱
- 頻道 ID
- 頻道網址
- 頻道說明
- 管道指標
頻道觀眾屬性 (例如年齡、性別和使用者興趣)
細目)
熱門影片
管道類型
與頻道內容相關聯的語言
關聯性分數 (僅限主題趨勢搜尋)
生成熱門趨勢洞察
如要產生熱門洞察，請向 ContentCreatorInsightsService.GenerateTrendingInsights 方法傳送要求。這個方法的每秒查詢次數 (QPS) 上限為 5 次，並會根據您想取得目標對象趨勢或主題趨勢，採用兩種輸入類型。您必須提供要取得趨勢的特定國家/地區位置。
產生熱門搜尋洞察輸入內容：您可以透過
AudienceInsightsService.ListAudienceInsightsAttributes擷取可用屬性，方法是提供您要取得屬性的維度，例如感興趣的主題KNOWLEDGE_GRAPH。KNOWLEDGE_GRAPH屬性會有一或多個InsightsKnowledgeGraphEntityCapabilities標記。趨勢洞察支援的屬性會在回應中繼資料中顯示相關標記。請注意，如果開發人員有權存取
ContentCreatorInsightsService，也會自動獲得AudienceInsightsService.ListAudienceInsightsAttributes的存取權。AudienceInsightsService中的其他端點則需要獨立的許可清單程序。如需
ListAudienceInsightsAttributes的其他說明文件，請參閱目標對象洞察指南。目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的趨勢洞察清單，包括趨勢值在比較期間的百分比變化等指標。
自 Google Ads API 第 23 版起，您可以使用
audience_combinations指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是audience_attributes無法做到的。audience_attributes適合根據聯集 (以 OR 組合) 屬性清單指定目標，例如對「運動」或「旅遊」或 ... 感興趣的使用者，而audience_combinations則提供更精細的控制選項。audience_combinations中的每個InsightsAudienceAttributeGroup都會以邏輯 OR 組合屬性。這些群組隨後會以邏輯 AND 組合。舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在
audience_combinations中使用兩個InsightsAudienceAttributeGroup項目。「護膚」、「護髮」和「化妝品」是興趣主題，以知識圖譜實體表示 (例如化妝品的/m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。請注意，如果您在
audience_attributes中指定知識圖譜實體、產品與服務類別或使用者興趣，就無法使用audience_combinations。如果您使用audience_combinations，就必須在audience_combinations中指定這些屬性，而不是在audience_attributes中指定；不過，您還是可以將audience_attributes用於其他屬性類型 (例如客層)，並搭配audience_combinations使用。主題趨勢：提供內容主題清單。API 會傳回這些主題的熱門洞察資料清單，包括趨勢值在比較期間的百分比變化等指標。