使用創作者洞察功能，發掘並取得 YouTube 創作者的洞察資料。如果代理商和廣告主想尋找與目標對象相關的創作者，這項功能就非常實用。
這個 API 主要有四項功能：
- 創作者曝光度：根據一組主題、客層、目標對象或創作者屬性，尋找相關創作者。
- 創作者主題洞察：取得製作特定主題內容的相關創作者洞察資料。
- 創作者洞察：取得特定 YouTube 頻道的洞察資料，例如訂閱人數、觀看次數和觀眾客層。
- 熱門洞察：根據特定目標對象或主題，取得特定趨勢的洞察資料。
使用主題式創作者探索或熱門洞察資料時，只要要求補充資料，即可探索當地創作者 (尋找位於特定國家/地區或從該國家/地區發布內容，且在該國家/地區獲得觀看的創作者)。
資格規定
GenerateCreatorInsights 是 Google Ads API 的私有元件，提供非專屬免權利金的資料授權。簽約合作夥伴可使用標準 Google Ads 用戶端程式庫，探索 YouTube 創作者和內容。如要符合資格，合作夥伴必須滿足下列條件：
- 擁有可整合 Google Ads API 的規劃工具或使用者介面。
- 使用 API 探索 YouTube 內容和創作者，尋找潛在的廣告商機。
- 完成預先篩選評估，確認是否符合資格。
- 遵守資料使用規定，並願意接受定期資料稽核。
- 簽署資料授權協議，確保資料使用符合法律規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
生成創作者洞察資料
如要產生創作者洞察資料，請向 GenerateCreatorInsights 方法發出要求。這個方法的每秒查詢次數 (QPS) 上限為 5 次。視您想提高創作者曝光度、依主題搜尋相關創作者，或是取得創作者洞察資料而定，輸入內容的類型也會有所不同。您必須提供要從中取得資料的國家/地區位置。
創作者曝光度：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。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方法擷取支援的實體功能。附註：自 24.2 版起，
search_brand選項已遭淘汰，並在 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 方法發出要求。這個方法每秒查詢次數 (QPS) 上限為 5 次。視您想取得目標對象趨勢或主題趨勢而定，這項工具會採用兩種輸入內容。您必須提供要取得趨勢的特定國家/地區。
目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的熱門洞察資料清單，包括趨勢值的變化百分比等指標 (與比較期間相比)。
您可以透過
ListAudienceInsightsAttributes擷取可用的目標對象屬性，方法是提供您要取得屬性的維度，例如興趣主題的KNOWLEDGE_GRAPH。KNOWLEDGE_GRAPH屬性會有一或多個InsightsKnowledgeGraphEntityCapabilities標記。趨勢洞察支援的屬性會在回應中繼資料中顯示相關標記。請注意，如果開發人員有權存取
ContentCreatorInsightsService，也會自動獲得AudienceInsightsService.ListAudienceInsightsAttributes的存取權。AudienceInsightsService中的其他端點需要獨立的許可清單程序。如需
ListAudienceInsightsAttributes的其他說明文件，請參閱目標對象洞察指南。目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的熱門洞察資料清單，包括趨勢值的百分比變化等指標 (與比較期間相比)。
您可以提供要取得屬性的維度 (例如興趣主題的
KNOWLEDGE_GRAPH)，使用ListAudienceInsightsAttributes方法擷取可用的目標對象屬性。自 Google Ads API 第 23 版起，您可以使用
audience_combinations指定複雜的目標對象屬性關係。這個欄位可讓您使用audience_attributes無法提供的布林邏輯 (AND/OR) 定義目標對象。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搭配使用的人口統計資料。主題趨勢：提供內容主題清單。API 會傳回這些主題的熱門洞察資料清單，包括趨勢值在比較期間的百分比變化等指標。
增補資料和當地創作者
與生成創作者洞察資料類似，您可以在熱門洞察資料中設定重複欄位 supplemental_data 為 LOCAL_CREATOR_DATA，要求使用選用功能。
如果熱門搜尋要求使用 search_topics，系統會在傳回的 TrendInsight 物件中，填入 related_local_creators 欄位，提供與要求主題相關的當地創作者，這些創作者已同意分享位置資料。本機創作者探索功能適用於相同的定義和限制 (例如與 sub_country_locations 不相容)。