google-ads-api-types 0.21.0

package/dist/google/ads/googleads/v21/services/reach_plan_service.d.ts

@@ -0,0 +1,1172 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { AdditionalApplicationInfo } from "../common/additional_application_info.js";
+import { DeviceInfo, GenderInfo, UserInterestInfo, UserListInfo } from "../common/criteria.js";
+import { DateRange } from "../common/dates.js";
+import { FrequencyCapTimeUnitEnum_FrequencyCapTimeUnit } from "../enums/frequency_cap_time_unit.js";
+import { ReachPlanAgeRangeEnum_ReachPlanAgeRange } from "../enums/reach_plan_age_range.js";
+import { ReachPlanConversionRateModelEnum_ReachPlanConversionRateModel } from "../enums/reach_plan_conversion_rate_model.js";
+import { ReachPlanNetworkEnum_ReachPlanNetwork } from "../enums/reach_plan_network.js";
+import { ReachPlanPlannableUserListStatusEnum_ReachPlanPlannableUserListStatus } from "../enums/reach_plan_plannable_user_list_status.js";
+import { ReachPlanSurfaceEnum_ReachPlanSurface } from "../enums/reach_plan_surface.js";
+import { TargetFrequencyTimeUnitEnum_TargetFrequencyTimeUnit } from "../enums/target_frequency_time_unit.js";
+import { UserInterestTaxonomyTypeEnum_UserInterestTaxonomyType } from "../enums/user_interest_taxonomy_type.js";
+import { UserListTypeEnum_UserListType } from "../enums/user_list_type.js";
+export declare const protobufPackage = "google.ads.googleads.v21.services";
+/**
+ * Request message for
+ * [ReachPlanService.GenerateConversionRates][google.ads.googleads.v21.services.ReachPlanService.GenerateConversionRates].
+ */
+export interface GenerateConversionRatesRequest {
+    /**
+     * Required. The ID of the customer. A conversion rate based on the historical
+     * data of this customer may be suggested.
+     */
+    customerId: string;
+    /** The name of the customer being planned for. This is a user-defined value. */
+    customerReachGroup?: string | undefined;
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/**
+ * Response message for
+ * [ReachPlanService.GenerateConversionRates][google.ads.googleads.v21.services.ReachPlanService.GenerateConversionRates],
+ * containing conversion rate suggestions for supported plannable products.
+ */
+export interface GenerateConversionRatesResponse {
+    /**
+     * A list containing conversion rate suggestions. Each repeated element will
+     * have an associated product code. Multiple suggestions may share the same
+     * product code.
+     */
+    conversionRateSuggestions: ConversionRateSuggestion[];
+}
+/** A conversion rate suggestion. */
+export interface ConversionRateSuggestion {
+    /** Model type used to calculate the suggested conversion rate. */
+    conversionRateModel: ReachPlanConversionRateModelEnum_ReachPlanConversionRateModel;
+    /**
+     * The code associated with the plannable product (for example: DEMAND_GEN).
+     * To list all plannable product codes, use
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    plannableProductCode: string;
+    /** The suggested conversion rate. The value is between 0 and 1 (exclusive). */
+    conversionRate: number;
+}
+/**
+ * Request message for
+ * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v21.services.ReachPlanService.ListPlannableLocations].
+ */
+export interface ListPlannableLocationsRequest {
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/** The list of plannable locations. */
+export interface ListPlannableLocationsResponse {
+    /**
+     * The list of locations available for planning.
+     * See
+     * https://developers.google.com/google-ads/api/reference/data/geotargets
+     * for sample locations.
+     */
+    plannableLocations: PlannableLocation[];
+}
+/** A plannable location: country, metro region, province, etc. */
+export interface PlannableLocation {
+    /** The location identifier. */
+    id?: string | undefined;
+    /** The unique location name in English. */
+    name?: string | undefined;
+    /**
+     * The parent country (not present if location is a country).
+     * If present, will always be a GeoTargetConstant ID. Additional information
+     * such as country name is provided by
+     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v21.services.ReachPlanService.ListPlannableLocations]
+     * or GoogleAdsService.Search/SearchStream.
+     */
+    parentCountryId?: number | undefined;
+    /** The ISO-3166-1 alpha-2 country code that is associated with the location. */
+    countryCode?: string | undefined;
+    /**
+     * The location's type. Location types correspond to target_type returned by
+     * searching location type in GoogleAdsService.Search/SearchStream.
+     */
+    locationType?: string | undefined;
+}
+/** Request to list available products in a given location. */
+export interface ListPlannableProductsRequest {
+    /**
+     * Required. The ID of the selected location for planning. To list the
+     * available plannable location IDs use
+     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v21.services.ReachPlanService.ListPlannableLocations].
+     */
+    plannableLocationId: string;
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/** A response with all available products. */
+export interface ListPlannableProductsResponse {
+    /** The list of products available for planning and related targeting metadata. */
+    productMetadata: ProductMetadata[];
+}
+/** The metadata associated with an available plannable product. */
+export interface ProductMetadata {
+    /**
+     * The code associated with the ad product (for example: BUMPER,
+     * TRUEVIEW_IN_STREAM).
+     * To list the available plannable product codes use
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    plannableProductCode?: string | undefined;
+    /** The name associated with the ad product. */
+    plannableProductName: string;
+    /** The allowed plannable targeting for this product. */
+    plannableTargeting?: PlannableTargeting | undefined;
+}
+/**
+ * Request message for
+ * [ReachPlanService.ListPlannableUserLists][google.ads.googleads.v21.services.ReachPlanService.ListPlannableUserLists]
+ * that lists the available user lists for a customer.
+ */
+export interface ListPlannableUserListsRequest {
+    /** Required. The ID of the customer. */
+    customerId: string;
+    /** The name of the customer being planned for. This is a user-defined value. */
+    customerReachGroup?: string | undefined;
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/** A response with all available user lists with their plannable status. */
+export interface ListPlannableUserListsResponse {
+    /**
+     * The list of user lists available for planning and related targeting
+     * metadata.
+     */
+    plannableUserLists: PlannableUserList[];
+}
+/** A plannable user list. */
+export interface PlannableUserList {
+    /** The user list ID. */
+    userListInfo?: UserListInfo | undefined;
+    /** The name of the user list. */
+    displayName: string;
+    /** The user list type. */
+    userListType: UserListTypeEnum_UserListType;
+    /** The plannable status of the user list. */
+    plannableStatus: ReachPlanPlannableUserListStatusEnum_ReachPlanPlannableUserListStatus;
+}
+/** The targeting for which traffic metrics will be reported. */
+export interface PlannableTargeting {
+    /**
+     * Allowed plannable age ranges for the product for which metrics will be
+     * reported. Actual targeting is computed by mapping this age range onto
+     * standard Google common.AgeRangeInfo values.
+     */
+    ageRanges: ReachPlanAgeRangeEnum_ReachPlanAgeRange[];
+    /** Targetable genders for the ad product. */
+    genders: GenderInfo[];
+    /**
+     * Targetable devices for the ad product.
+     * TABLET device targeting is automatically applied to reported metrics
+     * when MOBILE targeting is selected for CPM_MASTHEAD,
+     * GOOGLE_PREFERRED_BUMPER, and GOOGLE_PREFERRED_SHORT products.
+     */
+    devices: DeviceInfo[];
+    /** Targetable networks for the ad product. */
+    networks: ReachPlanNetworkEnum_ReachPlanNetwork[];
+    /** Targetable YouTube Select Lineups for the ad product. */
+    youtubeSelectLineups: YouTubeSelectLineUp[];
+    /** Targetable surface combinations for the ad product. */
+    surfaceTargeting?: SurfaceTargetingCombinations | undefined;
+}
+/**
+ * Request message for
+ * [ReachPlanService.ListPlannableUserInterests][google.ads.googleads.v21.services.ReachPlanService.ListPlannableUserInterests].
+ */
+export interface ListPlannableUserInterestsRequest {
+    /** Required. The ID of the customer. */
+    customerId: string;
+    /**
+     * Optional. A filter by user interest type. If set, only user interests with
+     * a type listed in the filter will be returned. If not set, user interests of
+     * all supported types will be returned. Supported user interest types are
+     * AFFINITY and IN_MARKET. Each type must be specified at most once.
+     */
+    userInterestTaxonomyTypes: UserInterestTaxonomyTypeEnum_UserInterestTaxonomyType[];
+    /**
+     * A filter by user interest name. If set, only user interests with a name
+     * containing the literal string (case insensitive) in the filter will be
+     * returned. Maximum length is 200 characters.
+     */
+    nameQuery?: string | undefined;
+    /**
+     * A filter by user interest path. If set, only user interests with a path
+     * containing the literal string (case insensitive) in the filter will be
+     * returned. Maximum length is 200 characters.
+     */
+    pathQuery?: string | undefined;
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/**
+ * Response message for
+ * [ReachPlanService.ListPlannableUserInterests][google.ads.googleads.v21.services.ReachPlanService.ListPlannableUserInterests].
+ */
+export interface ListPlannableUserInterestsResponse {
+    /** The list of plannable user interests. */
+    plannableUserInterests: PlannableUserInterest[];
+}
+/**
+ * A plannable user interest that can be targeted in a reach forecast using
+ * [ReachPlanService.GenerateReachForecast][google.ads.googleads.v21.services.ReachPlanService.GenerateReachForecast].
+ */
+export interface PlannableUserInterest {
+    /** The user interest id. */
+    userInterest?: UserInterestInfo | undefined;
+    /** The user interest type. */
+    userInterestType: UserInterestTaxonomyTypeEnum_UserInterestTaxonomyType;
+    /**
+     * The user interest display name.
+     * For example, "Autos & Vehicles"
+     */
+    userInterestDisplayName: string;
+    /**
+     * The user interest path.
+     * For example, "/Autos & Vehicles/Motor Vehicles/Motor Vehicles by
+     * Type/Off-Road Vehicles"
+     */
+    userInterestPath: string;
+}
+/**
+ * Request message for
+ * [ReachPlanService.GenerateReachForecast][google.ads.googleads.v21.services.ReachPlanService.GenerateReachForecast].
+ */
+export interface GenerateReachForecastRequest {
+    /** Required. The ID of the customer. */
+    customerId: string;
+    /**
+     * The currency code.
+     * Three-character ISO 4217 currency code.
+     */
+    currencyCode?: string | undefined;
+    /** Required. Campaign duration. */
+    campaignDuration?: CampaignDuration | undefined;
+    /**
+     * Chosen cookie frequency cap to be applied to each planned product.
+     * This is equivalent to the frequency cap exposed in Google Ads when creating
+     * a campaign, it represents the maximum number of times an ad can be shown to
+     * the same user.
+     * If not specified, no cap is applied.
+     *
+     * This field is deprecated in v4 and will eventually be removed.
+     * Use cookie_frequency_cap_setting instead.
+     */
+    cookieFrequencyCap?: number | undefined;
+    /**
+     * Chosen cookie frequency cap to be applied to each planned product.
+     * This is equivalent to the frequency cap exposed in Google Ads when creating
+     * a campaign, it represents the maximum number of times an ad can be shown to
+     * the same user during a specified time interval.
+     * If not specified, a default of 0 (no cap) is applied.
+     *
+     * This field replaces the deprecated cookie_frequency_cap field.
+     */
+    cookieFrequencyCapSetting?: FrequencyCap | undefined;
+    /**
+     * Chosen minimum effective frequency (the number of times a person was
+     * exposed to the ad) for the reported reach metrics [1-10].
+     * This won't affect the targeting, but just the reporting.
+     * If not specified, a default of 1 is applied.
+     *
+     * This field cannot be combined with the effective_frequency_limit field.
+     */
+    minEffectiveFrequency?: number | undefined;
+    /**
+     * The highest minimum effective frequency (the number of times a person was
+     * exposed to the ad) value [1-10] to include in
+     * Forecast.effective_frequency_breakdowns.
+     * If not specified, Forecast.effective_frequency_breakdowns will not be
+     * provided.
+     *
+     * The effective frequency value provided here will also be used as the
+     * minimum effective frequency for the reported reach metrics.
+     *
+     * This field cannot be combined with the min_effective_frequency field.
+     */
+    effectiveFrequencyLimit?: EffectiveFrequencyLimit | undefined;
+    /**
+     * The targeting to be applied to all products selected in the product mix.
+     *
+     * This is planned targeting: execution details might vary based on the
+     * advertising product, consult an implementation specialist.
+     *
+     * See specific metrics for details on how targeting affects them.
+     */
+    targeting?: Targeting | undefined;
+    /**
+     * Required. The products to be forecast.
+     * The max number of allowed planned products is 15.
+     */
+    plannedProducts: PlannedProduct[];
+    /** Controls the forecast metrics returned in the response. */
+    forecastMetricOptions?: ForecastMetricOptions | undefined;
+    /** The name of the customer being planned for. This is a user-defined value. */
+    customerReachGroup?: string | undefined;
+    /** Optional. Additional information on the application issuing the request. */
+    reachApplicationInfo?: AdditionalApplicationInfo | undefined;
+}
+/** Effective frequency limit. */
+export interface EffectiveFrequencyLimit {
+    /**
+     * The highest effective frequency value to include in
+     * Forecast.effective_frequency_breakdowns.
+     * This field supports frequencies 1-10, inclusive.
+     */
+    effectiveFrequencyBreakdownLimit: number;
+}
+/**
+ * A rule specifying the maximum number of times an ad can be shown to a user
+ * over a particular time period.
+ */
+export interface FrequencyCap {
+    /** Required. The number of impressions, inclusive. */
+    impressions: number;
+    /** Required. The type of time unit. */
+    timeUnit: FrequencyCapTimeUnitEnum_FrequencyCapTimeUnit;
+}
+/** The targeting for which traffic metrics will be reported. */
+export interface Targeting {
+    /**
+     * The ID of the selected location. Plannable location IDs can be
+     * obtained from
+     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v21.services.ReachPlanService.ListPlannableLocations].
+     *
+     * Requests must set either this field or `plannable_location_ids`.
+     *
+     * This field is deprecated as of V12 and will be removed in a future release.
+     * Use `plannable_location_ids` instead.
+     */
+    plannableLocationId?: string | undefined;
+    /**
+     * The list of plannable location IDs to target with this forecast.
+     *
+     * If more than one ID is provided, all IDs must have the same
+     * `parent_country_id`. Planning for more than `parent_county` is not
+     * supported. Plannable location IDs and their `parent_country_id` can be
+     * obtained from
+     * [ReachPlanService.ListPlannableLocations][google.ads.googleads.v21.services.ReachPlanService.ListPlannableLocations].
+     *
+     * Requests must set either this field or `plannable_location_id`.
+     */
+    plannableLocationIds: string[];
+    /**
+     * Targeted age range.
+     * An unset value is equivalent to targeting all ages.
+     */
+    ageRange: ReachPlanAgeRangeEnum_ReachPlanAgeRange;
+    /**
+     * Targeted genders.
+     * An unset value is equivalent to targeting MALE and FEMALE.
+     */
+    genders: GenderInfo[];
+    /**
+     * Targeted devices.
+     * If not specified, targets all applicable devices. Applicable devices vary
+     * by product and region and can be obtained from
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    devices: DeviceInfo[];
+    /**
+     * Targetable network for the ad product.
+     * If not specified, targets all applicable networks. Applicable networks vary
+     * by product and region and can be obtained from
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    network: ReachPlanNetworkEnum_ReachPlanNetwork;
+    /**
+     * Targeted audiences.
+     * If not specified, does not target any specific audience.
+     */
+    audienceTargeting?: AudienceTargeting | undefined;
+}
+/** The duration of a planned campaign. */
+export interface CampaignDuration {
+    /**
+     * The duration value in days.
+     *
+     * This field cannot be combined with the date_range field.
+     */
+    durationInDays?: number | undefined;
+    /**
+     * Date range of the campaign.
+     * Dates are in the yyyy-mm-dd format and inclusive.
+     * The end date must be < 1 year in the future and the
+     * date range must be <= 92 days long.
+     *
+     * This field cannot be combined with the duration_in_days field.
+     */
+    dateRange?: DateRange | undefined;
+}
+/** A product being planned for reach. */
+export interface PlannedProduct {
+    /**
+     * Required. Selected product for planning.
+     * The code associated with the ad product (for example: Trueview, Bumper).
+     * To list the available plannable product codes use
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    plannableProductCode?: string | undefined;
+    /**
+     * Required. Maximum budget allocation in micros for the selected product.
+     * The value is specified in the selected planning currency_code.
+     * For example: 1 000 000$ = 1 000 000 000 000 micros.
+     */
+    budgetMicros?: number | undefined;
+    /**
+     * Conversion rate as a decimal between 0 and 1, exclusive.
+     * For example: if 2% of ad interactions are expected to lead to conversions,
+     * conversion_rate should be 0.02.
+     * This field is required for DEMAND_GEN plannable products. It is not
+     * supported for other plannable products.
+     */
+    conversionRate?: number | undefined;
+    /**
+     * Targeting settings for the selected product.
+     * To list the available targeting for each product use
+     * [ReachPlanService.ListPlannableProducts][google.ads.googleads.v21.services.ReachPlanService.ListPlannableProducts].
+     */
+    advancedProductTargeting?: AdvancedProductTargeting | undefined;
+}
+/** Response message containing the generated reach curve. */
+export interface GenerateReachForecastResponse {
+    /** Reference on target audiences for this curve. */
+    onTargetAudienceMetrics?: OnTargetAudienceMetrics | undefined;
+    /** The generated reach curve for the planned product mix. */
+    reachCurve?: ReachCurve | undefined;
+}
+/** The reach curve for the planned products. */
+export interface ReachCurve {
+    /** All points on the reach curve. */
+    reachForecasts: ReachForecast[];
+}
+/** A point on reach curve. */
+export interface ReachForecast {
+    /** The cost in micros. */
+    costMicros: number;
+    /** Forecasted traffic metrics for this point. */
+    forecast?: Forecast | undefined;
+    /**
+     * The forecasted allocation and traffic metrics for each planned product
+     * at this point on the reach curve.
+     */
+    plannedProductReachForecasts: PlannedProductReachForecast[];
+}
+/** Forecasted traffic metrics for the planned products and targeting. */
+export interface Forecast {
+    /**
+     * Number of unique people reached at least
+     * GenerateReachForecastRequest.min_effective_frequency or
+     * GenerateReachForecastRequest.effective_frequency_limit times that exactly
+     * matches the Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the on_target_reach
+     * value will be rounded to 0.
+     */
+    onTargetReach?: number | undefined;
+    /**
+     * Total number of unique people reached at least
+     * GenerateReachForecastRequest.min_effective_frequency or
+     * GenerateReachForecastRequest.effective_frequency_limit times. This includes
+     * people that may fall outside the specified Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the total_reach
+     * value will be rounded to 0.
+     */
+    totalReach?: number | undefined;
+    /** Number of ad impressions that exactly matches the Targeting. */
+    onTargetImpressions?: number | undefined;
+    /**
+     * Total number of ad impressions. This includes impressions that may fall
+     * outside the specified Targeting, due to insufficient information on
+     * signed-in users.
+     */
+    totalImpressions?: number | undefined;
+    /**
+     * Number of times the ad's impressions were considered viewable.
+     * See https://support.google.com/google-ads/answer/7029393 for
+     * more information about what makes an ad viewable and how
+     * viewability is measured.
+     */
+    viewableImpressions?: number | undefined;
+    /**
+     * A list of effective frequency forecasts. The list is ordered starting with
+     * 1+ and ending with the value set in
+     * GenerateReachForecastRequest.effective_frequency_limit. If no
+     * effective_frequency_limit was set, this list will be empty.
+     */
+    effectiveFrequencyBreakdowns: EffectiveFrequencyBreakdown[];
+    /**
+     * Number of unique people reached that exactly matches the Targeting
+     * including co-viewers.
+     */
+    onTargetCoviewReach?: number | undefined;
+    /**
+     * Number of unique people reached including co-viewers. This includes
+     * people that may fall outside the specified Targeting.
+     */
+    totalCoviewReach?: number | undefined;
+    /**
+     * Number of ad impressions that exactly matches the Targeting including
+     * co-viewers.
+     */
+    onTargetCoviewImpressions?: number | undefined;
+    /**
+     * Total number of ad impressions including co-viewers. This includes
+     * impressions that may fall outside the specified Targeting, due to
+     * insufficient information on signed-in users.
+     */
+    totalCoviewImpressions?: number | undefined;
+    /**
+     * Number of ad views forecasted for the specified product and targeting.
+     * A view is counted when a viewer views a larger portion or the entirety of
+     * an ad beyond an impression.
+     *
+     * See https://support.google.com/google-ads/answer/2375431 for
+     * more information on views.
+     */
+    views?: number | undefined;
+    /**
+     * The number of conversions.
+     * This metric is only available for DEMAND_GEN plannable products.
+     *
+     * See https://support.google.com/google-ads/answer/2375431 for
+     * more information on conversions.
+     */
+    conversions?: number | undefined;
+}
+/**
+ * The forecasted allocation and traffic metrics for a specific product
+ * at a point on the reach curve.
+ */
+export interface PlannedProductReachForecast {
+    /**
+     * Selected product for planning. The product codes returned are within the
+     * set of the ones returned by ListPlannableProducts when using the same
+     * location ID.
+     */
+    plannableProductCode: string;
+    /**
+     * The cost in micros. This may differ from the product's input allocation
+     * if one or more planned products cannot fulfill the budget because of
+     * limited inventory.
+     */
+    costMicros: number;
+    /** Forecasted traffic metrics for this product. */
+    plannedProductForecast?: PlannedProductForecast | undefined;
+}
+/** Forecasted traffic metrics for a planned product. */
+export interface PlannedProductForecast {
+    /**
+     * Number of unique people reached that exactly matches the Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the on_target_reach
+     * value will be rounded to 0.
+     */
+    onTargetReach: number;
+    /**
+     * Number of unique people reached. This includes people that may fall
+     * outside the specified Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the total_reach
+     * value will be rounded to 0.
+     */
+    totalReach: number;
+    /** Number of ad impressions that exactly matches the Targeting. */
+    onTargetImpressions: number;
+    /**
+     * Total number of ad impressions. This includes impressions that may fall
+     * outside the specified Targeting, due to insufficient information on
+     * signed-in users.
+     */
+    totalImpressions: number;
+    /**
+     * Number of times the ad's impressions were considered viewable.
+     * See https://support.google.com/google-ads/answer/7029393 for
+     * more information about what makes an ad viewable and how
+     * viewability is measured.
+     */
+    viewableImpressions?: number | undefined;
+    /**
+     * Number of unique people reached that exactly matches the Targeting
+     * including co-viewers.
+     */
+    onTargetCoviewReach?: number | undefined;
+    /**
+     * Number of unique people reached including co-viewers. This includes
+     * people that may fall outside the specified Targeting.
+     */
+    totalCoviewReach?: number | undefined;
+    /**
+     * Number of ad impressions that exactly matches the Targeting including
+     * co-viewers.
+     */
+    onTargetCoviewImpressions?: number | undefined;
+    /**
+     * Total number of ad impressions including co-viewers. This includes
+     * impressions that may fall outside the specified Targeting, due to
+     * insufficient information on signed-in users.
+     */
+    totalCoviewImpressions?: number | undefined;
+    /**
+     * The number of times per selected time unit a user will see an ad, averaged
+     * over the number of time units in the forecast length. This field will only
+     * be populated for a Target Frequency campaign.
+     *
+     * See https://support.google.com/google-ads/answer/12400225 for more
+     * information about Target Frequency campaigns.
+     */
+    averageFrequency?: number | undefined;
+    /**
+     * Number of ad views forecasted for the specified product and targeting.
+     * A view is counted when a viewer views a larger portion or the entirety of
+     * an ad beyond an impression.
+     *
+     * See https://support.google.com/google-ads/answer/2375431 for
+     * more information on views.
+     */
+    views?: number | undefined;
+    /**
+     * The number of conversions.
+     * This metric is only available for DEMAND_GEN plannable products.
+     *
+     * See https://support.google.com/google-ads/answer/2375431 for
+     * more information on conversions.
+     */
+    conversions?: number | undefined;
+}
+/**
+ * Audience metrics for the planned products.
+ * These metrics consider the following targeting dimensions:
+ *
+ * - Location
+ * - PlannableAgeRange
+ * - Gender
+ * - AudienceTargeting (only for youtube_audience_size)
+ */
+export interface OnTargetAudienceMetrics {
+    /** Reference audience size matching the considered targeting for YouTube. */
+    youtubeAudienceSize?: number | undefined;
+    /** Reference audience size matching the considered targeting for Census. */
+    censusAudienceSize?: number | undefined;
+}
+/**
+ * A breakdown of the number of unique people reached at a given effective
+ * frequency.
+ */
+export interface EffectiveFrequencyBreakdown {
+    /** The effective frequency [1-10]. */
+    effectiveFrequency: number;
+    /**
+     * The number of unique people reached at least effective_frequency times that
+     * exactly matches the Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the on_target_reach
+     * value will be rounded to 0.
+     */
+    onTargetReach: number;
+    /**
+     * Total number of unique people reached at least effective_frequency times.
+     * This includes people that may fall outside the specified Targeting.
+     *
+     * Note that a minimum number of unique people must be reached in order for
+     * data to be reported. If the minimum number is not met, the total_reach
+     * value will be rounded to 0.
+     */
+    totalReach: number;
+    /**
+     * The number of users (including co-viewing users) reached for the associated
+     * effective_frequency value.
+     */
+    effectiveCoviewReach?: number | undefined;
+    /**
+     * The number of users (including co-viewing users) reached for the associated
+     * effective_frequency value within the specified plan demographic.
+     */
+    onTargetEffectiveCoviewReach?: number | undefined;
+}
+/** Controls forecast metrics to return. */
+export interface ForecastMetricOptions {
+    /** Indicates whether to include co-view metrics in the response forecast. */
+    includeCoview: boolean;
+}
+/** Audience targeting for reach forecast. */
+export interface AudienceTargeting {
+    /** List of audiences based on user interests to be targeted. */
+    userInterest: UserInterestInfo[];
+    /** List of audiences based on user lists to be targeted. */
+    userLists: UserListInfo[];
+}
+/** Advanced targeting settings for products. */
+export interface AdvancedProductTargeting {
+    /** Surface targeting settings for this product. */
+    surfaceTargetingSettings?: SurfaceTargeting | undefined;
+    /**
+     * Settings for a Target frequency campaign. Must be set when selecting the
+     * TARGET_FREQUENCY product.
+     *
+     * See https://support.google.com/google-ads/answer/12400225 for more
+     * information about Target Frequency campaigns.
+     */
+    targetFrequencySettings?: TargetFrequencySettings | undefined;
+    /** Settings for YouTube Select targeting. */
+    youtubeSelectSettings?: YouTubeSelectSettings | undefined;
+}
+/** Request settings for YouTube Select Lineups */
+export interface YouTubeSelectSettings {
+    /** Lineup for YouTube Select Targeting. */
+    lineupId: number;
+}
+/** A Plannable YouTube Select Lineup for product targeting. */
+export interface YouTubeSelectLineUp {
+    /** The ID of the YouTube Select Lineup. */
+    lineupId: number;
+    /** The unique name of the YouTube Select Lineup. */
+    lineupName: string;
+}
+/** The surface targeting combinations available for an ad product. */
+export interface SurfaceTargetingCombinations {
+    /** Default surface targeting applied to the ad product. */
+    defaultTargeting?: SurfaceTargeting | undefined;
+    /** Available surface target combinations for the ad product. */
+    availableTargetingCombinations: SurfaceTargeting[];
+}
+/**
+ * Container for surfaces for a product. Surfaces refer to the available types
+ * of ad inventories such as In-Feed, In-Stream, and Shorts.
+ */
+export interface SurfaceTargeting {
+    /** List of surfaces available to target. */
+    surfaces: ReachPlanSurfaceEnum_ReachPlanSurface[];
+}
+/** Target Frequency settings for a supported product. */
+export interface TargetFrequencySettings {
+    /**
+     * Required. The time unit used to describe the time frame for
+     * target_frequency.
+     */
+    timeUnit: TargetFrequencyTimeUnitEnum_TargetFrequencyTimeUnit;
+    /** Required. The target frequency goal per selected time unit. */
+    targetFrequency: number;
+}
+export declare const GenerateConversionRatesRequest: MessageFns<GenerateConversionRatesRequest>;
+export declare const GenerateConversionRatesResponse: MessageFns<GenerateConversionRatesResponse>;
+export declare const ConversionRateSuggestion: MessageFns<ConversionRateSuggestion>;
+export declare const ListPlannableLocationsRequest: MessageFns<ListPlannableLocationsRequest>;
+export declare const ListPlannableLocationsResponse: MessageFns<ListPlannableLocationsResponse>;
+export declare const PlannableLocation: MessageFns<PlannableLocation>;
+export declare const ListPlannableProductsRequest: MessageFns<ListPlannableProductsRequest>;
+export declare const ListPlannableProductsResponse: MessageFns<ListPlannableProductsResponse>;
+export declare const ProductMetadata: MessageFns<ProductMetadata>;
+export declare const ListPlannableUserListsRequest: MessageFns<ListPlannableUserListsRequest>;
+export declare const ListPlannableUserListsResponse: MessageFns<ListPlannableUserListsResponse>;
+export declare const PlannableUserList: MessageFns<PlannableUserList>;
+export declare const PlannableTargeting: MessageFns<PlannableTargeting>;
+export declare const ListPlannableUserInterestsRequest: MessageFns<ListPlannableUserInterestsRequest>;
+export declare const ListPlannableUserInterestsResponse: MessageFns<ListPlannableUserInterestsResponse>;
+export declare const PlannableUserInterest: MessageFns<PlannableUserInterest>;
+export declare const GenerateReachForecastRequest: MessageFns<GenerateReachForecastRequest>;
+export declare const EffectiveFrequencyLimit: MessageFns<EffectiveFrequencyLimit>;
+export declare const FrequencyCap: MessageFns<FrequencyCap>;
+export declare const Targeting: MessageFns<Targeting>;
+export declare const CampaignDuration: MessageFns<CampaignDuration>;
+export declare const PlannedProduct: MessageFns<PlannedProduct>;
+export declare const GenerateReachForecastResponse: MessageFns<GenerateReachForecastResponse>;
+export declare const ReachCurve: MessageFns<ReachCurve>;
+export declare const ReachForecast: MessageFns<ReachForecast>;
+export declare const Forecast: MessageFns<Forecast>;
+export declare const PlannedProductReachForecast: MessageFns<PlannedProductReachForecast>;
+export declare const PlannedProductForecast: MessageFns<PlannedProductForecast>;
+export declare const OnTargetAudienceMetrics: MessageFns<OnTargetAudienceMetrics>;
+export declare const EffectiveFrequencyBreakdown: MessageFns<EffectiveFrequencyBreakdown>;
+export declare const ForecastMetricOptions: MessageFns<ForecastMetricOptions>;
+export declare const AudienceTargeting: MessageFns<AudienceTargeting>;
+export declare const AdvancedProductTargeting: MessageFns<AdvancedProductTargeting>;
+export declare const YouTubeSelectSettings: MessageFns<YouTubeSelectSettings>;
+export declare const YouTubeSelectLineUp: MessageFns<YouTubeSelectLineUp>;
+export declare const SurfaceTargetingCombinations: MessageFns<SurfaceTargetingCombinations>;
+export declare const SurfaceTargeting: MessageFns<SurfaceTargeting>;
+export declare const TargetFrequencySettings: MessageFns<TargetFrequencySettings>;
+/**
+ * Reach Plan Service gives users information about audience size that can
+ * be reached through advertisement on YouTube. In particular,
+ * GenerateReachForecast provides estimated number of people of specified
+ * demographics that can be reached by an ad in a given market by a campaign of
+ * certain duration with a defined budget.
+ */
+export type ReachPlanServiceService = typeof ReachPlanServiceService;
+export declare const ReachPlanServiceService: {
+    /**
+     * Returns a collection of conversion rate suggestions for supported plannable
+     * products.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    readonly generateConversionRates: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/GenerateConversionRates";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GenerateConversionRatesRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GenerateConversionRatesRequest;
+        readonly responseSerialize: (value: GenerateConversionRatesResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GenerateConversionRatesResponse;
+    };
+    /**
+     * Returns the list of plannable locations (for example, countries).
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    readonly listPlannableLocations: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/ListPlannableLocations";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListPlannableLocationsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListPlannableLocationsRequest;
+        readonly responseSerialize: (value: ListPlannableLocationsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListPlannableLocationsResponse;
+    };
+    /**
+     * Returns the list of per-location plannable YouTube ad formats with allowed
+     * targeting.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    readonly listPlannableProducts: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/ListPlannableProducts";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListPlannableProductsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListPlannableProductsRequest;
+        readonly responseSerialize: (value: ListPlannableProductsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListPlannableProductsResponse;
+    };
+    /**
+     * Generates a reach forecast for a given targeting / product mix.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    readonly generateReachForecast: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/GenerateReachForecast";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: GenerateReachForecastRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => GenerateReachForecastRequest;
+        readonly responseSerialize: (value: GenerateReachForecastResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => GenerateReachForecastResponse;
+    };
+    /**
+     * Returns the list of plannable user lists with their plannable status.
+     * User lists may not be plannable for a number of reasons, including:
+     * - They are less than 10 days old.
+     * - They have a membership lifespan that is less than 30 days
+     * - They have less than 10,000 or more than 700,000 users.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    readonly listPlannableUserLists: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/ListPlannableUserLists";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListPlannableUserListsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListPlannableUserListsRequest;
+        readonly responseSerialize: (value: ListPlannableUserListsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListPlannableUserListsResponse;
+    };
+    /**
+     * Returns the list of plannable user interests.
+     * A plannable user interest is one that can be targeted in a reach forecast
+     * using
+     * [ReachPlanService.GenerateReachForecast][google.ads.googleads.v21.services.ReachPlanService.GenerateReachForecast].
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [ListOperationError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     *   [StringLengthError]()
+     */
+    readonly listPlannableUserInterests: {
+        readonly path: "/google.ads.googleads.v21.services.ReachPlanService/ListPlannableUserInterests";
+        readonly requestStream: false;
+        readonly responseStream: false;
+        readonly requestSerialize: (value: ListPlannableUserInterestsRequest) => Buffer;
+        readonly requestDeserialize: (value: Buffer) => ListPlannableUserInterestsRequest;
+        readonly responseSerialize: (value: ListPlannableUserInterestsResponse) => Buffer;
+        readonly responseDeserialize: (value: Buffer) => ListPlannableUserInterestsResponse;
+    };
+};
+export interface ReachPlanServiceServer extends UntypedServiceImplementation {
+    /**
+     * Returns a collection of conversion rate suggestions for supported plannable
+     * products.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    generateConversionRates: handleUnaryCall<GenerateConversionRatesRequest, GenerateConversionRatesResponse>;
+    /**
+     * Returns the list of plannable locations (for example, countries).
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    listPlannableLocations: handleUnaryCall<ListPlannableLocationsRequest, ListPlannableLocationsResponse>;
+    /**
+     * Returns the list of per-location plannable YouTube ad formats with allowed
+     * targeting.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    listPlannableProducts: handleUnaryCall<ListPlannableProductsRequest, ListPlannableProductsResponse>;
+    /**
+     * Generates a reach forecast for a given targeting / product mix.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    generateReachForecast: handleUnaryCall<GenerateReachForecastRequest, GenerateReachForecastResponse>;
+    /**
+     * Returns the list of plannable user lists with their plannable status.
+     * User lists may not be plannable for a number of reasons, including:
+     * - They are less than 10 days old.
+     * - They have a membership lifespan that is less than 30 days
+     * - They have less than 10,000 or more than 700,000 users.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    listPlannableUserLists: handleUnaryCall<ListPlannableUserListsRequest, ListPlannableUserListsResponse>;
+    /**
+     * Returns the list of plannable user interests.
+     * A plannable user interest is one that can be targeted in a reach forecast
+     * using
+     * [ReachPlanService.GenerateReachForecast][google.ads.googleads.v21.services.ReachPlanService.GenerateReachForecast].
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [ListOperationError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     *   [StringLengthError]()
+     */
+    listPlannableUserInterests: handleUnaryCall<ListPlannableUserInterestsRequest, ListPlannableUserInterestsResponse>;
+}
+export interface ReachPlanServiceClient extends Client {
+    /**
+     * Returns a collection of conversion rate suggestions for supported plannable
+     * products.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    generateConversionRates(request: GenerateConversionRatesRequest, callback: (error: ServiceError | null, response: GenerateConversionRatesResponse) => void): ClientUnaryCall;
+    generateConversionRates(request: GenerateConversionRatesRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GenerateConversionRatesResponse) => void): ClientUnaryCall;
+    generateConversionRates(request: GenerateConversionRatesRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GenerateConversionRatesResponse) => void): ClientUnaryCall;
+    /**
+     * Returns the list of plannable locations (for example, countries).
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    listPlannableLocations(request: ListPlannableLocationsRequest, callback: (error: ServiceError | null, response: ListPlannableLocationsResponse) => void): ClientUnaryCall;
+    listPlannableLocations(request: ListPlannableLocationsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListPlannableLocationsResponse) => void): ClientUnaryCall;
+    listPlannableLocations(request: ListPlannableLocationsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListPlannableLocationsResponse) => void): ClientUnaryCall;
+    /**
+     * Returns the list of per-location plannable YouTube ad formats with allowed
+     * targeting.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     */
+    listPlannableProducts(request: ListPlannableProductsRequest, callback: (error: ServiceError | null, response: ListPlannableProductsResponse) => void): ClientUnaryCall;
+    listPlannableProducts(request: ListPlannableProductsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListPlannableProductsResponse) => void): ClientUnaryCall;
+    listPlannableProducts(request: ListPlannableProductsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListPlannableProductsResponse) => void): ClientUnaryCall;
+    /**
+     * Generates a reach forecast for a given targeting / product mix.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    generateReachForecast(request: GenerateReachForecastRequest, callback: (error: ServiceError | null, response: GenerateReachForecastResponse) => void): ClientUnaryCall;
+    generateReachForecast(request: GenerateReachForecastRequest, metadata: Metadata, callback: (error: ServiceError | null, response: GenerateReachForecastResponse) => void): ClientUnaryCall;
+    generateReachForecast(request: GenerateReachForecastRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: GenerateReachForecastResponse) => void): ClientUnaryCall;
+    /**
+     * Returns the list of plannable user lists with their plannable status.
+     * User lists may not be plannable for a number of reasons, including:
+     * - They are less than 10 days old.
+     * - They have a membership lifespan that is less than 30 days
+     * - They have less than 10,000 or more than 700,000 users.
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [QuotaError]()
+     *   [RangeError]()
+     *   [ReachPlanError]()
+     *   [RequestError]()
+     */
+    listPlannableUserLists(request: ListPlannableUserListsRequest, callback: (error: ServiceError | null, response: ListPlannableUserListsResponse) => void): ClientUnaryCall;
+    listPlannableUserLists(request: ListPlannableUserListsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListPlannableUserListsResponse) => void): ClientUnaryCall;
+    listPlannableUserLists(request: ListPlannableUserListsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListPlannableUserListsResponse) => void): ClientUnaryCall;
+    /**
+     * Returns the list of plannable user interests.
+     * A plannable user interest is one that can be targeted in a reach forecast
+     * using
+     * [ReachPlanService.GenerateReachForecast][google.ads.googleads.v21.services.ReachPlanService.GenerateReachForecast].
+     *
+     * List of thrown errors:
+     *   [AuthenticationError]()
+     *   [AuthorizationError]()
+     *   [FieldError]()
+     *   [HeaderError]()
+     *   [InternalError]()
+     *   [ListOperationError]()
+     *   [QuotaError]()
+     *   [RequestError]()
+     *   [StringLengthError]()
+     */
+    listPlannableUserInterests(request: ListPlannableUserInterestsRequest, callback: (error: ServiceError | null, response: ListPlannableUserInterestsResponse) => void): ClientUnaryCall;
+    listPlannableUserInterests(request: ListPlannableUserInterestsRequest, metadata: Metadata, callback: (error: ServiceError | null, response: ListPlannableUserInterestsResponse) => void): ClientUnaryCall;
+    listPlannableUserInterests(request: ListPlannableUserInterestsRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: ListPlannableUserInterestsResponse) => void): ClientUnaryCall;
+}
+export declare const ReachPlanServiceClient: {
+    new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): ReachPlanServiceClient;
+    service: typeof ReachPlanServiceService;
+    serviceName: string;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};