--- title: "POST /v23/customers/{+customerId}:generateInsightsFinderReport" method: POST path: "/v23/customers/{+customerId}:generateInsightsFinderReport" tags: ["customers"] --- # POST /v23/customers/{+customerId}:generateInsightsFinderReport `POST /v23/customers/{+customerId}:generateInsightsFinderReport` Creates a saved report that can be viewed in the Insights Finder tool. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [QuotaError]() [RangeError]() [RequestError]() ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesGenerateInsightsFinderReportRequest — Request message for AudienceInsightsService.GenerateInsightsFinderReport. - `specificAudience` GoogleAdsSearchads360V23ServicesInsightsAudience — A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService. - `incomeRanges` GoogleAdsSearchads360V23CommonIncomeRangeInfo[] — Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `subCountryLocations` GoogleAdsSearchads360V23CommonLocationInfo[] — Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the country_locations and no further. - `geoTargetConstant` string — The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `lineups` GoogleAdsSearchads360V23CommonAudienceInsightsLineup[] — Lineups representing the YouTube content viewed by the audience. - `lineupId` string — Required. The numeric ID of the lineup. - `countryLocations` GoogleAdsSearchads360V23CommonLocationInfo[] — Required. The countries for the audience. - `geoTargetConstant` string — The geo target constant resource name. - `topicAudienceCombinations` GoogleAdsSearchads360V23ServicesInsightsAudienceAttributeGroup[] — A combination of entity, category and user interest attributes defining the audience. The combination has a logical AND-of-ORs structure: Attributes within each InsightsAudienceAttributeGroup are combined with OR, and the combinations themselves are combined together with AND. For example, the expression (Entity OR Affinity) AND (In-Market OR Category) can be formed using two InsightsAudienceAttributeGroups with two Attributes each. - `attributes` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute[] — Required. A collection of audience attributes to be combined with logical OR. Attributes need not all be the same dimension. Only Knowledge Graph entities, Product & Service Categories, and Affinity and In-Market audiences are supported in this context. - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup — A YouTube Lineup. - `lineupId` string — Required. The numeric ID of the lineup. - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity — A Knowledge Graph entity, represented by its machine id. - `knowledgeGraphMachineId` string — Required. The machine ID (mid) of the Knowledge Graph entity. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo — An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo — An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory — A Product and Service category. - `categoryId` string — Required. The criterion ID of the category. - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo — A YouTube Video criterion. - `videoId` string — YouTube video id as it appears on the YouTube watch page. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo — A YouTube Channel criterion. - `channelId` string — The YouTube uploader channel id or the channel code of a YouTube channel. - `location` GoogleAdsSearchads360V23CommonLocationInfo — A location criterion. - `geoTargetConstant` string — The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo — Represents a particular interest-based topic to be targeted. - `userInterestCategory` string — The UserInterest resource name. - `ageRanges` GoogleAdsSearchads360V23CommonAgeRangeInfo[] — Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. - `customerInsightsGroup` string — The name of the customer being planned for. This is a user-defined value. - `insightsApplicationInfo` GoogleAdsSearchads360V23CommonAdditionalApplicationInfo — Additional information about the application/tool issuing the request. This field is only used by ContentCreatorInsightsService, AudienceInsightsService, and ReachPlanService APIs. - `applicationInstance` 'UNSPECIFIED' | 'UNKNOWN' | 'DEVELOPMENT_AND_TESTING' | 'PRODUCTION' — The instance type of the application sending the request. - `applicationId` string — The unique identifier of the agency proprietary application. This identifier is generated by Google. Reach out to your Google representative to request an application_id for each new application being integrated. - `baselineAudience` GoogleAdsSearchads360V23ServicesInsightsAudience — A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService. - `incomeRanges` GoogleAdsSearchads360V23CommonIncomeRangeInfo[] — Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `subCountryLocations` GoogleAdsSearchads360V23CommonLocationInfo[] — Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the country_locations and no further. - `geoTargetConstant` string — The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `lineups` GoogleAdsSearchads360V23CommonAudienceInsightsLineup[] — Lineups representing the YouTube content viewed by the audience. - `lineupId` string — Required. The numeric ID of the lineup. - `countryLocations` GoogleAdsSearchads360V23CommonLocationInfo[] — Required. The countries for the audience. - `geoTargetConstant` string — The geo target constant resource name. - `topicAudienceCombinations` GoogleAdsSearchads360V23ServicesInsightsAudienceAttributeGroup[] — A combination of entity, category and user interest attributes defining the audience. The combination has a logical AND-of-ORs structure: Attributes within each InsightsAudienceAttributeGroup are combined with OR, and the combinations themselves are combined together with AND. For example, the expression (Entity OR Affinity) AND (In-Market OR Category) can be formed using two InsightsAudienceAttributeGroups with two Attributes each. - `attributes` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute[] — Required. A collection of audience attributes to be combined with logical OR. Attributes need not all be the same dimension. Only Knowledge Graph entities, Product & Service Categories, and Affinity and In-Market audiences are supported in this context. - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup — A YouTube Lineup. - `lineupId` string — Required. The numeric ID of the lineup. - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity — A Knowledge Graph entity, represented by its machine id. - `knowledgeGraphMachineId` string — Required. The machine ID (mid) of the Knowledge Graph entity. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo — An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo — An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory — A Product and Service category. - `categoryId` string — Required. The criterion ID of the category. - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo — A YouTube Video criterion. - `videoId` string — YouTube video id as it appears on the YouTube watch page. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo — A YouTube Channel criterion. - `channelId` string — The YouTube uploader channel id or the channel code of a YouTube channel. - `location` GoogleAdsSearchads360V23CommonLocationInfo — A location criterion. - `geoTargetConstant` string — The geo target constant resource name. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo — Represents a particular interest-based topic to be targeted. - `userInterestCategory` string — The UserInterest resource name. - `ageRanges` GoogleAdsSearchads360V23CommonAgeRangeInfo[] — Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)