使用創作者洞察功能，發掘及擷取 YouTube 創作者的洞察資料。如果代理商和廣告主想尋找與目標對象相關的創作者，這項功能就非常實用。
這項 API 主要有四項功能：
- 創作者曝光度：根據特定主題、客層、目標對象或創作者屬性，找出頂尖創作者。
- 創作者品牌洞察：取得與特定品牌相關的創作者洞察資料。
- 創作者洞察：取得特定 YouTube 頻道的洞察資料，例如訂閱人數、觀看次數和觀眾客層。
- 熱門洞察：根據特定目標對象或主題，取得特定趨勢的洞察資料。
資格規定
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私有元件，提供非專屬免版稅的資料授權。簽約合作夥伴可以使用標準的 Google Ads 用戶端程式庫，探索 YouTube 創作者和內容。如要符合資格，合作夥伴必須符合下列條件：
- 擁有可整合 API 的規劃工具或使用者介面。
- 使用 API 探索 YouTube 內容和創作者，尋找潛在的廣告商機。
- 完成初步篩選評估，確認是否符合資格。
- 遵守資料使用規定，並願意接受定期資料稽核。
- 簽署資料授權協議，確保資料使用符合法律規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
生成創作者洞察資料
如要產生創作者洞察資料，請向 ContentCreatorInsightsService.GenerateCreatorInsights 方法發出要求。這個方法每秒最多可查詢 5 次，並根據您想進行創作者探索、創作者品牌洞察或取得創作者洞察資料，採用三種輸入類型。您必須提供要取得資料的國家/地區位置。
- 創作者曝光度：您可以提供目標對象屬性清單，例如年齡、性別和興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回一份清單，列出目標對象符合這些屬性的創作者。你也可以提供創作者屬性，篩選出內容與輸入的創作者屬性相符的創作者。
- 創作者品牌洞察：提供品牌名稱，搜尋頂尖創作者。API 會傳回相符頻道的洞察資料。
- 創作者洞察：提供 YouTube 頻道 ID 清單。API 會傳回這些特定頻道的洞察資料。
generateCreatorInsights 方法會傳回 GenerateCreatorInsightsResponse 物件。這個物件包含 YouTubeCreatorInsights 物件清單。每個 YouTubeCreatorInsights 物件都包含下列建立者資訊：
- 創作者名稱
- YouTube 頻道
- 創作者指標總數
- YouTube 頻道洞察資料清單
YouTubeMetrics 物件包含下列指標：
- 訂閱人數
- 觀看次數
- 影片數量
- 是否為活躍的 Shorts 創作者
YouTubeChannelInsights 物件包含 YouTube 頻道的下列資訊：
- 頻道名稱
- 頻道 ID
- 頻道網址
- 頻道說明
- 管道指標
- 頻道觀眾屬性 (例如年齡、性別和使用者興趣分析)
- 熱門影片
- 管道類型
- 與頻道內容相關聯的語言
- 關聯性分數 (僅限主題趨勢搜尋)
生成熱門洞察資料
如要生成熱門洞察，請向 ContentCreatorInsightsService.GenerateTrendingInsights 方法發出要求。這個方法的每秒查詢次數 (QPS) 上限為 5 次，並會根據您要取得的對象趨勢或主題趨勢，採用兩種輸入類型。您必須提供要取得趨勢的特定國家/地區。
- 目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的熱門洞察資料清單，包括趨勢值的變化百分比等指標 (與比較期間相比)。
- 主題趨勢：提供內容主題清單。API 會傳回這些主題的熱門洞察資料清單，包括趨勢值在比較期間的百分比變化等指標。