pinterest_sdk 1.1.0 → 2.1.0

data/lib/pinterest_sdk/api/ad_groups_api.rb

@@ -0,0 +1,1368 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.28.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.24.0
+
+=end
+
+require 'cgi'
+
+module PinterestSdkClient
+  class AdGroupsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get ad group analytics
+    # Get analytics for the specified ad groups in the specified `ad_account_id`, filtered by the specified options.  - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts): Admin, Analyst, Campaign Manager. - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days. - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param ad_group_ids [Array<String>] List of Ad group Ids to use to filter the results.
+    # @param columns [Array<ReportingColumnSync>] Columns to retrieve, encoded as a comma-separated string. **NOTE**: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile&#39;s currency field. For USD, ($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it&#39;s microdollars. Otherwise, it&#39;s in microunits of the advertiser&#39;s currency.  For example, if the advertiser&#39;s currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).  If a column has no value, it may not be returned.
+    # @param granularity [Granularity]   TOTAL - metrics are aggregated over the specified date range.    DAY - metrics are broken down daily.    HOUR - metrics are broken down hourly.    WEEK - metrics are broken down weekly.    MONTH - metrics are broken down monthly
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :click_window_days Number of days to use as the conversion attribution window for a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. (default to 30)
+    # @option opts [Float] :engagement_window_days Number of days to use as the conversion attribution window for an engagement action. Engagements include saves, closeups, link clicks, and carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. **Note:** This parameter no longer returns new data. However, you can still access historic data through **Sept 30, 2027**. (default to 30)
+    # @option opts [Float] :view_window_days Number of days to use as the conversion attribution window for a view action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;1&#x60; day. (default to 1)
+    # @option opts [String] :conversion_report_time The date by which the conversion metrics returned from this endpoint will be reported. There are two dates associated with a conversion event: the date that the user interacted with the ad, and the date that the user completed a conversion event. (default to 'TIME_OF_AD_ACTION')
+    # @option opts [Boolean] :aggregate_report_rows Determines if report rows should be aggregated across all requested entities. This feature is currently in BETA and is not available to all users. (default to false)
+    # @option opts [ReportingTimeZone] :reporting_timezone Specify the timezone to be applied for the reporting. This feature is currently in BETA and is not available to all users.
+    # @return [Array<AdGroupsAnalyticsMetrics>]
+    def ad_groups_analytics(start_date, end_date, ad_group_ids, columns, granularity, ad_account_id, opts = {})
+      data, _status_code, _headers = ad_groups_analytics_with_http_info(start_date, end_date, ad_group_ids, columns, granularity, ad_account_id, opts)
+      data
+    end
+
+    # Get ad group analytics
+    # Get analytics for the specified ad groups in the specified &#x60;ad_account_id&#x60;, filtered by the specified options.  - The token&#39;s user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts): Admin, Analyst, Campaign Manager. - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days. - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param ad_group_ids [Array<String>] List of Ad group Ids to use to filter the results.
+    # @param columns [Array<ReportingColumnSync>] Columns to retrieve, encoded as a comma-separated string. **NOTE**: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile&#39;s currency field. For USD, ($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it&#39;s microdollars. Otherwise, it&#39;s in microunits of the advertiser&#39;s currency.  For example, if the advertiser&#39;s currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).  If a column has no value, it may not be returned.
+    # @param granularity [Granularity]   TOTAL - metrics are aggregated over the specified date range.    DAY - metrics are broken down daily.    HOUR - metrics are broken down hourly.    WEEK - metrics are broken down weekly.    MONTH - metrics are broken down monthly
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :click_window_days Number of days to use as the conversion attribution window for a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. (default to 30)
+    # @option opts [Float] :engagement_window_days Number of days to use as the conversion attribution window for an engagement action. Engagements include saves, closeups, link clicks, and carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. **Note:** This parameter no longer returns new data. However, you can still access historic data through **Sept 30, 2027**. (default to 30)
+    # @option opts [Float] :view_window_days Number of days to use as the conversion attribution window for a view action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;1&#x60; day. (default to 1)
+    # @option opts [String] :conversion_report_time The date by which the conversion metrics returned from this endpoint will be reported. There are two dates associated with a conversion event: the date that the user interacted with the ad, and the date that the user completed a conversion event. (default to 'TIME_OF_AD_ACTION')
+    # @option opts [Boolean] :aggregate_report_rows Determines if report rows should be aggregated across all requested entities. This feature is currently in BETA and is not available to all users. (default to false)
+    # @option opts [ReportingTimeZone] :reporting_timezone Specify the timezone to be applied for the reporting. This feature is currently in BETA and is not available to all users.
+    # @return [Array<(Array<AdGroupsAnalyticsMetrics>, Integer, Hash)>] Array<AdGroupsAnalyticsMetrics> data, response status code and response headers
+    def ad_groups_analytics_with_http_info(start_date, end_date, ad_group_ids, columns, granularity, ad_account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_analytics ...'
+      end
+      # verify the required parameter 'start_date' is set
+      if @api_client.config.client_side_validation && start_date.nil?
+        fail ArgumentError, "Missing the required parameter 'start_date' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      # verify the required parameter 'end_date' is set
+      if @api_client.config.client_side_validation && end_date.nil?
+        fail ArgumentError, "Missing the required parameter 'end_date' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      # verify the required parameter 'ad_group_ids' is set
+      if @api_client.config.client_side_validation && ad_group_ids.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_ids' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      if @api_client.config.client_side_validation && ad_group_ids.length > 250
+        fail ArgumentError, 'invalid value for "ad_group_ids" when calling AdGroupsApi.ad_groups_analytics, number of items must be less than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && ad_group_ids.length < 1
+        fail ArgumentError, 'invalid value for "ad_group_ids" when calling AdGroupsApi.ad_groups_analytics, number of items must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'columns' is set
+      if @api_client.config.client_side_validation && columns.nil?
+        fail ArgumentError, "Missing the required parameter 'columns' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      # verify the required parameter 'granularity' is set
+      if @api_client.config.client_side_validation && granularity.nil?
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_analytics"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_analytics, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_analytics, must conform to the pattern #{pattern}."
+      end
+
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'click_window_days'] && !allowable_values.include?(opts[:'click_window_days'])
+        fail ArgumentError, "invalid value for \"click_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'engagement_window_days'] && !allowable_values.include?(opts[:'engagement_window_days'])
+        fail ArgumentError, "invalid value for \"engagement_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'view_window_days'] && !allowable_values.include?(opts[:'view_window_days'])
+        fail ArgumentError, "invalid value for \"view_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["TIME_OF_AD_ACTION", "TIME_OF_CONVERSION"]
+      if @api_client.config.client_side_validation && opts[:'conversion_report_time'] && !allowable_values.include?(opts[:'conversion_report_time'])
+        fail ArgumentError, "invalid value for \"conversion_report_time\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/analytics'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'start_date'] = start_date
+      query_params[:'end_date'] = end_date
+      query_params[:'ad_group_ids'] = @api_client.build_collection_param(ad_group_ids, :multi)
+      query_params[:'columns'] = @api_client.build_collection_param(columns, :csv)
+      query_params[:'granularity'] = granularity
+      query_params[:'click_window_days'] = opts[:'click_window_days'] if !opts[:'click_window_days'].nil?
+      query_params[:'engagement_window_days'] = opts[:'engagement_window_days'] if !opts[:'engagement_window_days'].nil?
+      query_params[:'view_window_days'] = opts[:'view_window_days'] if !opts[:'view_window_days'].nil?
+      query_params[:'conversion_report_time'] = opts[:'conversion_report_time'] if !opts[:'conversion_report_time'].nil?
+      query_params[:'aggregate_report_rows'] = opts[:'aggregate_report_rows'] if !opts[:'aggregate_report_rows'].nil?
+      query_params[:'reporting_timezone'] = opts[:'reporting_timezone'] if !opts[:'reporting_timezone'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<AdGroupsAnalyticsMetrics>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_analytics",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_analytics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get audience sizing
+    # Get potential audience size for an ad group with given targeting criteria. Potential audience size estimates the number of people you may be able to reach per month with your campaign. It is based on historical advertising data and the targeting criteria you select. It does not guarantee results or take into account factors such as bid, budget, schedule, seasonality or product experiments.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_audience_sizing_create [AdGroupAudienceSizingCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [AdGroupAudienceSizing]
+    def ad_groups_audience_sizing(ad_account_id, ad_group_audience_sizing_create, opts = {})
+      data, _status_code, _headers = ad_groups_audience_sizing_with_http_info(ad_account_id, ad_group_audience_sizing_create, opts)
+      data
+    end
+
+    # Get audience sizing
+    # Get potential audience size for an ad group with given targeting criteria. Potential audience size estimates the number of people you may be able to reach per month with your campaign. It is based on historical advertising data and the targeting criteria you select. It does not guarantee results or take into account factors such as bid, budget, schedule, seasonality or product experiments.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_audience_sizing_create [AdGroupAudienceSizingCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AdGroupAudienceSizing, Integer, Hash)>] AdGroupAudienceSizing data, response status code and response headers
+    def ad_groups_audience_sizing_with_http_info(ad_account_id, ad_group_audience_sizing_create, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_audience_sizing ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_audience_sizing"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_audience_sizing, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_audience_sizing, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_audience_sizing_create' is set
+      if @api_client.config.client_side_validation && ad_group_audience_sizing_create.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_audience_sizing_create' when calling AdGroupsApi.ad_groups_audience_sizing"
+      end
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/audience_sizing'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ad_group_audience_sizing_create)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroupAudienceSizing'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_audience_sizing",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_audience_sizing\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get bid floors
+    # List bid floors for your campaign configuration. Bid floors are given in microcurrency values based on the currency in the bid floor specification.  Microcurrency is used to track very small transactions, based on the currency set in the advertiser's profile.  A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser's profile.  **Equivalency equations**, using dollars as an example currency:  * $1 = 1,000,000 microdollars * 1 microdollar = $0.000001  **To convert between currency and microcurrency**, using dollars as an example currency:  * To convert dollars to microdollars, mutiply dollars by 1,000,000 * To convert microdollars to dollars, divide microdollars by 1,000,000  For more on bid floors see [Set your bid](https://help.pinterest.com/en/business/article/set-your-bid).
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param bid_floor_create [BidFloorCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [BidFloor]
+    def ad_groups_bid_floor_get(ad_account_id, bid_floor_create, opts = {})
+      data, _status_code, _headers = ad_groups_bid_floor_get_with_http_info(ad_account_id, bid_floor_create, opts)
+      data
+    end
+
+    # Get bid floors
+    # List bid floors for your campaign configuration. Bid floors are given in microcurrency values based on the currency in the bid floor specification.  Microcurrency is used to track very small transactions, based on the currency set in the advertiser&#39;s profile.  A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser&#39;s profile.  **Equivalency equations**, using dollars as an example currency:  * $1 &#x3D; 1,000,000 microdollars * 1 microdollar &#x3D; $0.000001  **To convert between currency and microcurrency**, using dollars as an example currency:  * To convert dollars to microdollars, mutiply dollars by 1,000,000 * To convert microdollars to dollars, divide microdollars by 1,000,000  For more on bid floors see [Set your bid](https://help.pinterest.com/en/business/article/set-your-bid).
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param bid_floor_create [BidFloorCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BidFloor, Integer, Hash)>] BidFloor data, response status code and response headers
+    def ad_groups_bid_floor_get_with_http_info(ad_account_id, bid_floor_create, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_bid_floor_get ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_bid_floor_get"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_bid_floor_get, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_bid_floor_get, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'bid_floor_create' is set
+      if @api_client.config.client_side_validation && bid_floor_create.nil?
+        fail ArgumentError, "Missing the required parameter 'bid_floor_create' when calling AdGroupsApi.ad_groups_bid_floor_get"
+      end
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/bid_floor'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(bid_floor_create)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BidFloor'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_bid_floor_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_bid_floor_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create ad groups
+    # Create multiple new ad groups. All ads in a given ad group will have the same budget, bid, run dates, targeting, and placement (search, browse, other).  For more information, [click here](https://help.pinterest.com/en/business/article/campaign-structure).  **Notes:** - `bid_in_micro_currency` and `budget_in_micro_currency` should be expressed in microcurrency amounts based on the currency field set in the advertiser's profile.  Microcurrency is used to track very small transactions, based on the currency set in the advertiser's profile. A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser's profile.  **Equivalency equations**, using dollars as an example currency: - $1 = 1,000,000 microdollars - 1 microdollar = $0.000001  **To convert between currency and microcurrency**, using dollars as an example currency: - To convert dollars to microdollars, multiply dollars by 1,000,000 - To convert microdollars to dollars, divide microdollars by 1,000,000  - Ad groups belong to ad campaigns. Some types of campaigns (e.g. budget optimization) have limits on the number of ad groups they can hold. If you exceed those limits, you will get an error message. - Certain organizations with [closed beta](/docs/getting-started/using-beta-and-restricted-features/) access can set `start_time` and `end_time` at the ad group level for campaigns with Campaign Budget Optimization (CBO) objectives: `TRAFFIC`, `AWARENESS`, `WEB_CONVERSIONS`, and `CATALOG_SALES`. All other organizations can set these scheduling parameters for non-CBO campaigns only. - If the parent ad campaign has start and end times set, ad group start and end times must occur within the parent campaign schedule.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_create_create [Array<AdGroupCreateCreate>] 
+    # @param [Hash] opts the optional parameters
+    # @return [AdGroupsCreate200Response]
+    def ad_groups_create(ad_account_id, ad_group_create_create, opts = {})
+      data, _status_code, _headers = ad_groups_create_with_http_info(ad_account_id, ad_group_create_create, opts)
+      data
+    end
+
+    # Create ad groups
+    # Create multiple new ad groups. All ads in a given ad group will have the same budget, bid, run dates, targeting, and placement (search, browse, other).  For more information, [click here](https://help.pinterest.com/en/business/article/campaign-structure).  **Notes:** - &#x60;bid_in_micro_currency&#x60; and &#x60;budget_in_micro_currency&#x60; should be expressed in microcurrency amounts based on the currency field set in the advertiser&#39;s profile.  Microcurrency is used to track very small transactions, based on the currency set in the advertiser&#39;s profile. A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser&#39;s profile.  **Equivalency equations**, using dollars as an example currency: - $1 &#x3D; 1,000,000 microdollars - 1 microdollar &#x3D; $0.000001  **To convert between currency and microcurrency**, using dollars as an example currency: - To convert dollars to microdollars, multiply dollars by 1,000,000 - To convert microdollars to dollars, divide microdollars by 1,000,000  - Ad groups belong to ad campaigns. Some types of campaigns (e.g. budget optimization) have limits on the number of ad groups they can hold. If you exceed those limits, you will get an error message. - Certain organizations with [closed beta](/docs/getting-started/using-beta-and-restricted-features/) access can set &#x60;start_time&#x60; and &#x60;end_time&#x60; at the ad group level for campaigns with Campaign Budget Optimization (CBO) objectives: &#x60;TRAFFIC&#x60;, &#x60;AWARENESS&#x60;, &#x60;WEB_CONVERSIONS&#x60;, and &#x60;CATALOG_SALES&#x60;. All other organizations can set these scheduling parameters for non-CBO campaigns only. - If the parent ad campaign has start and end times set, ad group start and end times must occur within the parent campaign schedule.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_create_create [Array<AdGroupCreateCreate>] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AdGroupsCreate200Response, Integer, Hash)>] AdGroupsCreate200Response data, response status code and response headers
+    def ad_groups_create_with_http_info(ad_account_id, ad_group_create_create, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_create ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_create"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_create, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_create, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_create_create' is set
+      if @api_client.config.client_side_validation && ad_group_create_create.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_create_create' when calling AdGroupsApi.ad_groups_create"
+      end
+      if @api_client.config.client_side_validation && ad_group_create_create.length > 30
+        fail ArgumentError, 'invalid value for "ad_group_create_create" when calling AdGroupsApi.ad_groups_create, number of items must be less than or equal to 30.'
+      end
+
+      if @api_client.config.client_side_validation && ad_group_create_create.length < 1
+        fail ArgumentError, 'invalid value for "ad_group_create_create" when calling AdGroupsApi.ad_groups_create, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ad_group_create_create)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroupsCreate200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_create",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_create\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get dynamic titles CSV download URL
+    # Get a presigned S3 download URL for the dynamic titles review CSV. Returns 400 if titles have not been generated yet.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [DynamicTitlesDownloadCSV]
+    def ad_groups_dynamic_titles_download_csv(ad_account_id, ad_group_id, opts = {})
+      data, _status_code, _headers = ad_groups_dynamic_titles_download_csv_with_http_info(ad_account_id, ad_group_id, opts)
+      data
+    end
+
+    # Get dynamic titles CSV download URL
+    # Get a presigned S3 download URL for the dynamic titles review CSV. Returns 400 if titles have not been generated yet.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DynamicTitlesDownloadCSV, Integer, Hash)>] DynamicTitlesDownloadCSV data, response status code and response headers
+    def ad_groups_dynamic_titles_download_csv_with_http_info(ad_account_id, ad_group_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_dynamic_titles_download_csv ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_id' is set
+      if @api_client.config.client_side_validation && ad_group_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv"
+      end
+      if @api_client.config.client_side_validation && ad_group_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_group_id" when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_group_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_download_csv, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}/dynamic_titles/csv'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s)).sub('{ad_group_id}', CGI.escape(ad_group_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DynamicTitlesDownloadCSV'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_dynamic_titles_download_csv",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_dynamic_titles_download_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get dynamic titles status
+    # Get dynamic titles generation status for an ad group, including whether titles are ready for review and counts of generated and reviewed titles.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [DynamicTitlesGetStatus]
+    def ad_groups_dynamic_titles_get_status(ad_account_id, ad_group_id, opts = {})
+      data, _status_code, _headers = ad_groups_dynamic_titles_get_status_with_http_info(ad_account_id, ad_group_id, opts)
+      data
+    end
+
+    # Get dynamic titles status
+    # Get dynamic titles generation status for an ad group, including whether titles are ready for review and counts of generated and reviewed titles.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DynamicTitlesGetStatus, Integer, Hash)>] DynamicTitlesGetStatus data, response status code and response headers
+    def ad_groups_dynamic_titles_get_status_with_http_info(ad_account_id, ad_group_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_dynamic_titles_get_status ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_status"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_dynamic_titles_get_status, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_status, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_id' is set
+      if @api_client.config.client_side_validation && ad_group_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_status"
+      end
+      if @api_client.config.client_side_validation && ad_group_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_group_id" when calling AdGroupsApi.ad_groups_dynamic_titles_get_status, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_group_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_status, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}/dynamic_titles/status'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s)).sub('{ad_group_id}', CGI.escape(ad_group_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DynamicTitlesGetStatus'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_dynamic_titles_get_status",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_dynamic_titles_get_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get dynamic titles upload URL
+    # Get a presigned S3 upload URL for the dynamic titles review CSV and a request_id for submission.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [DynamicTitlesUploadURL]
+    def ad_groups_dynamic_titles_get_upload_url(ad_account_id, ad_group_id, opts = {})
+      data, _status_code, _headers = ad_groups_dynamic_titles_get_upload_url_with_http_info(ad_account_id, ad_group_id, opts)
+      data
+    end
+
+    # Get dynamic titles upload URL
+    # Get a presigned S3 upload URL for the dynamic titles review CSV and a request_id for submission.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DynamicTitlesUploadURL, Integer, Hash)>] DynamicTitlesUploadURL data, response status code and response headers
+    def ad_groups_dynamic_titles_get_upload_url_with_http_info(ad_account_id, ad_group_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_dynamic_titles_get_upload_url ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_id' is set
+      if @api_client.config.client_side_validation && ad_group_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url"
+      end
+      if @api_client.config.client_side_validation && ad_group_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_group_id" when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_group_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_get_upload_url, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}/dynamic_titles/uploads'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s)).sub('{ad_group_id}', CGI.escape(ad_group_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DynamicTitlesUploadURL'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_dynamic_titles_get_upload_url",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_dynamic_titles_get_upload_url\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Process dynamic titles CSV
+    # Validate and process the uploaded dynamic titles review CSV. Returns validation errors if the CSV is invalid.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param dynamic_titles_process_csv_create [DynamicTitlesProcessCSVCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [DynamicTitlesProcessCSV]
+    def ad_groups_dynamic_titles_process_csv(ad_account_id, ad_group_id, dynamic_titles_process_csv_create, opts = {})
+      data, _status_code, _headers = ad_groups_dynamic_titles_process_csv_with_http_info(ad_account_id, ad_group_id, dynamic_titles_process_csv_create, opts)
+      data
+    end
+
+    # Process dynamic titles CSV
+    # Validate and process the uploaded dynamic titles review CSV. Returns validation errors if the CSV is invalid.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_id [String] Ad group ID.
+    # @param dynamic_titles_process_csv_create [DynamicTitlesProcessCSVCreate] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DynamicTitlesProcessCSV, Integer, Hash)>] DynamicTitlesProcessCSV data, response status code and response headers
+    def ad_groups_dynamic_titles_process_csv_with_http_info(ad_account_id, ad_group_id, dynamic_titles_process_csv_create, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_dynamic_titles_process_csv ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_id' is set
+      if @api_client.config.client_side_validation && ad_group_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv"
+      end
+      if @api_client.config.client_side_validation && ad_group_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_group_id" when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_group_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_group_id' when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'dynamic_titles_process_csv_create' is set
+      if @api_client.config.client_side_validation && dynamic_titles_process_csv_create.nil?
+        fail ArgumentError, "Missing the required parameter 'dynamic_titles_process_csv_create' when calling AdGroupsApi.ad_groups_dynamic_titles_process_csv"
+      end
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}/dynamic_titles'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s)).sub('{ad_group_id}', CGI.escape(ad_group_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(dynamic_titles_process_csv_create)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DynamicTitlesProcessCSV'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_dynamic_titles_process_csv",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_dynamic_titles_process_csv\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get ad group
+    # Get a specific ad group given the ad group ID.
+    # @param ad_group_id [String] Ad group ID.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @return [AdGroup]
+    def ad_groups_get(ad_group_id, ad_account_id, opts = {})
+      data, _status_code, _headers = ad_groups_get_with_http_info(ad_group_id, ad_account_id, opts)
+      data
+    end
+
+    # Get ad group
+    # Get a specific ad group given the ad group ID.
+    # @param ad_group_id [String] Ad group ID.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AdGroup, Integer, Hash)>] AdGroup data, response status code and response headers
+    def ad_groups_get_with_http_info(ad_group_id, ad_account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_get ...'
+      end
+      # verify the required parameter 'ad_group_id' is set
+      if @api_client.config.client_side_validation && ad_group_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_id' when calling AdGroupsApi.ad_groups_get"
+      end
+      if @api_client.config.client_side_validation && ad_group_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_group_id" when calling AdGroupsApi.ad_groups_get, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_group_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_group_id' when calling AdGroupsApi.ad_groups_get, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_get"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_get, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_get, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}'.sub('{ad_group_id}', CGI.escape(ad_group_id.to_s)).sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroup'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List ad groups
+    # List ad groups based on provided campaign IDs or ad group IDs.(campaign_ids or ad_group_ids). **Note:** Provide only campaign_id or ad_group_id. Do not provide both.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @option opts [PinterestLibPaginationOrder] :order The order in which to sort the items returned: \&quot;ASCENDING\&quot; or \&quot;DESCENDING\&quot; by ID. Note that higher-value IDs are associated with more-recently added items.
+    # @option opts [Array<String>] :campaign_ids List of Campaign Ids to use to filter the results.
+    # @option opts [Array<String>] :ad_group_ids List of Ad group Ids to retrieve keywords from. This feature is currently in BETA and is not available to all users.
+    # @option opts [Array<EntityStatus>] :entity_statuses Entity status
+    # @option opts [Boolean] :translate_interests_to_names Return interests as text names (if value is true) rather than topic IDs. (default to false)
+    # @return [AdGroupsList200Response]
+    def ad_groups_list(ad_account_id, opts = {})
+      data, _status_code, _headers = ad_groups_list_with_http_info(ad_account_id, opts)
+      data
+    end
+
+    # List ad groups
+    # List ad groups based on provided campaign IDs or ad group IDs.(campaign_ids or ad_group_ids). **Note:** Provide only campaign_id or ad_group_id. Do not provide both.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @option opts [PinterestLibPaginationOrder] :order The order in which to sort the items returned: \&quot;ASCENDING\&quot; or \&quot;DESCENDING\&quot; by ID. Note that higher-value IDs are associated with more-recently added items.
+    # @option opts [Array<String>] :campaign_ids List of Campaign Ids to use to filter the results.
+    # @option opts [Array<String>] :ad_group_ids List of Ad group Ids to retrieve keywords from. This feature is currently in BETA and is not available to all users.
+    # @option opts [Array<EntityStatus>] :entity_statuses Entity status
+    # @option opts [Boolean] :translate_interests_to_names Return interests as text names (if value is true) rather than topic IDs. (default to false)
+    # @return [Array<(AdGroupsList200Response, Integer, Hash)>] AdGroupsList200Response data, response status code and response headers
+    def ad_groups_list_with_http_info(ad_account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_list ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_list"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_list, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_list, must conform to the pattern #{pattern}."
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 250
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling AdGroupsApi.ad_groups_list, must be smaller than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling AdGroupsApi.ad_groups_list, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'campaign_ids'].nil? && opts[:'campaign_ids'].length > 250
+        fail ArgumentError, 'invalid value for "opts[:"campaign_ids"]" when calling AdGroupsApi.ad_groups_list, number of items must be less than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'campaign_ids'].nil? && opts[:'campaign_ids'].length < 1
+        fail ArgumentError, 'invalid value for "opts[:"campaign_ids"]" when calling AdGroupsApi.ad_groups_list, number of items must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'ad_group_ids'].nil? && opts[:'ad_group_ids'].length > 250
+        fail ArgumentError, 'invalid value for "opts[:"ad_group_ids"]" when calling AdGroupsApi.ad_groups_list, number of items must be less than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'ad_group_ids'].nil? && opts[:'ad_group_ids'].length < 1
+        fail ArgumentError, 'invalid value for "opts[:"ad_group_ids"]" when calling AdGroupsApi.ad_groups_list, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'bookmark'] = opts[:'bookmark'] if !opts[:'bookmark'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'order'] = opts[:'order'] if !opts[:'order'].nil?
+      query_params[:'campaign_ids'] = @api_client.build_collection_param(opts[:'campaign_ids'], :multi) if !opts[:'campaign_ids'].nil?
+      query_params[:'ad_group_ids'] = @api_client.build_collection_param(opts[:'ad_group_ids'], :multi) if !opts[:'ad_group_ids'].nil?
+      query_params[:'entity_statuses'] = @api_client.build_collection_param(opts[:'entity_statuses'], :multi) if !opts[:'entity_statuses'].nil?
+      query_params[:'translate_interests_to_names'] = opts[:'translate_interests_to_names'] if !opts[:'translate_interests_to_names'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroupsList200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get targeting analytics for ad groups
+    # Get targeting analytics for one or more ad groups. For the requested ad group(s) and metrics, the response will include the requested metric information (e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. \"age_bucket\") for applicable values (e.g. \"45-49\").  - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts): Admin, Analyst, Campaign Manager. - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days. - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_ids [Array<String>] List of Ad group Ids to use to filter the results.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param targeting_types [Array<AdsAnalyticsAdGroupTargetingType>] Targeting type breakdowns for the report. The reporting per targeting type is independent from each other. [\&quot;AGE_BUCKET_AND_GENDER\&quot;, \&quot;CREATIVE_ENHANCEMENTS\&quot;] are in BETA and not yet available to all users.
+    # @param columns [Array<ReportingColumnSync>] Columns to retrieve, encoded as a comma-separated string. **NOTE**: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile&#39;s currency field. For USD, ($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it&#39;s microdollars. Otherwise, it&#39;s in microunits of the advertiser&#39;s currency.  For example, if the advertiser&#39;s currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).  If a column has no value, it may not be returned.
+    # @param granularity [Granularity]   TOTAL - metrics are aggregated over the specified date range.    DAY - metrics are broken down daily.    HOUR - metrics are broken down hourly.    WEEK - metrics are broken down weekly.    MONTH - metrics are broken down monthly
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :click_window_days Number of days to use as the conversion attribution window for a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. (default to 30)
+    # @option opts [Float] :engagement_window_days Number of days to use as the conversion attribution window for an engagement action. Engagements include saves, closeups, link clicks, and carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. **Note:** This parameter no longer returns new data. However, you can still access historic data through **Sept 30, 2027**. (default to 30)
+    # @option opts [Float] :view_window_days Number of days to use as the conversion attribution window for a view action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;1&#x60; day. (default to 1)
+    # @option opts [String] :conversion_report_time The date by which the conversion metrics returned from this endpoint will be reported. There are two dates associated with a conversion event: the date that the user interacted with the ad, and the date that the user completed a conversion event. (default to 'TIME_OF_AD_ACTION')
+    # @option opts [Array<ConversionReportAttributionType>] :attribution_types List of types of attribution for the conversion report
+    # @option opts [ReportingTimeZone] :reporting_timezone Specify the timezone to be applied for the reporting. This feature is currently in BETA and is not available to all users.
+    # @option opts [Array<String>] :sort_columns Sort Columns.
+    # @option opts [Boolean] :sort_ascending Sort ascending.
+    # @return [MetricsResponse]
+    def ad_groups_targeting_analytics_get(ad_account_id, ad_group_ids, start_date, end_date, targeting_types, columns, granularity, opts = {})
+      data, _status_code, _headers = ad_groups_targeting_analytics_get_with_http_info(ad_account_id, ad_group_ids, start_date, end_date, targeting_types, columns, granularity, opts)
+      data
+    end
+
+    # Get targeting analytics for ad groups
+    # Get targeting analytics for one or more ad groups. For the requested ad group(s) and metrics, the response will include the requested metric information (e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. \&quot;age_bucket\&quot;) for applicable values (e.g. \&quot;45-49\&quot;).  - The token&#39;s user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts): Admin, Analyst, Campaign Manager. - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days. - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_ids [Array<String>] List of Ad group Ids to use to filter the results.
+    # @param start_date [Date] Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+    # @param end_date [Date] Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+    # @param targeting_types [Array<AdsAnalyticsAdGroupTargetingType>] Targeting type breakdowns for the report. The reporting per targeting type is independent from each other. [\&quot;AGE_BUCKET_AND_GENDER\&quot;, \&quot;CREATIVE_ENHANCEMENTS\&quot;] are in BETA and not yet available to all users.
+    # @param columns [Array<ReportingColumnSync>] Columns to retrieve, encoded as a comma-separated string. **NOTE**: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile&#39;s currency field. For USD, ($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it&#39;s microdollars. Otherwise, it&#39;s in microunits of the advertiser&#39;s currency.  For example, if the advertiser&#39;s currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).  If a column has no value, it may not be returned.
+    # @param granularity [Granularity]   TOTAL - metrics are aggregated over the specified date range.    DAY - metrics are broken down daily.    HOUR - metrics are broken down hourly.    WEEK - metrics are broken down weekly.    MONTH - metrics are broken down monthly
+    # @param [Hash] opts the optional parameters
+    # @option opts [Float] :click_window_days Number of days to use as the conversion attribution window for a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. (default to 30)
+    # @option opts [Float] :engagement_window_days Number of days to use as the conversion attribution window for an engagement action. Engagements include saves, closeups, link clicks, and carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;30&#x60; days. **Note:** This parameter no longer returns new data. However, you can still access historic data through **Sept 30, 2027**. (default to 30)
+    # @option opts [Float] :view_window_days Number of days to use as the conversion attribution window for a view action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to &#x60;1&#x60; day. (default to 1)
+    # @option opts [String] :conversion_report_time The date by which the conversion metrics returned from this endpoint will be reported. There are two dates associated with a conversion event: the date that the user interacted with the ad, and the date that the user completed a conversion event. (default to 'TIME_OF_AD_ACTION')
+    # @option opts [Array<ConversionReportAttributionType>] :attribution_types List of types of attribution for the conversion report
+    # @option opts [ReportingTimeZone] :reporting_timezone Specify the timezone to be applied for the reporting. This feature is currently in BETA and is not available to all users.
+    # @option opts [Array<String>] :sort_columns Sort Columns.
+    # @option opts [Boolean] :sort_ascending Sort ascending.
+    # @return [Array<(MetricsResponse, Integer, Hash)>] MetricsResponse data, response status code and response headers
+    def ad_groups_targeting_analytics_get_with_http_info(ad_account_id, ad_group_ids, start_date, end_date, targeting_types, columns, granularity, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_targeting_analytics_get ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_targeting_analytics_get, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_targeting_analytics_get, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_ids' is set
+      if @api_client.config.client_side_validation && ad_group_ids.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_ids' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      if @api_client.config.client_side_validation && ad_group_ids.length > 250
+        fail ArgumentError, 'invalid value for "ad_group_ids" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be less than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && ad_group_ids.length < 1
+        fail ArgumentError, 'invalid value for "ad_group_ids" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'start_date' is set
+      if @api_client.config.client_side_validation && start_date.nil?
+        fail ArgumentError, "Missing the required parameter 'start_date' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      # verify the required parameter 'end_date' is set
+      if @api_client.config.client_side_validation && end_date.nil?
+        fail ArgumentError, "Missing the required parameter 'end_date' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      # verify the required parameter 'targeting_types' is set
+      if @api_client.config.client_side_validation && targeting_types.nil?
+        fail ArgumentError, "Missing the required parameter 'targeting_types' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      if @api_client.config.client_side_validation && targeting_types.length > 14
+        fail ArgumentError, 'invalid value for "targeting_types" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be less than or equal to 14.'
+      end
+
+      if @api_client.config.client_side_validation && targeting_types.length < 1
+        fail ArgumentError, 'invalid value for "targeting_types" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be greater than or equal to 1.'
+      end
+
+      # verify the required parameter 'columns' is set
+      if @api_client.config.client_side_validation && columns.nil?
+        fail ArgumentError, "Missing the required parameter 'columns' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      # verify the required parameter 'granularity' is set
+      if @api_client.config.client_side_validation && granularity.nil?
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling AdGroupsApi.ad_groups_targeting_analytics_get"
+      end
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'click_window_days'] && !allowable_values.include?(opts[:'click_window_days'])
+        fail ArgumentError, "invalid value for \"click_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'engagement_window_days'] && !allowable_values.include?(opts[:'engagement_window_days'])
+        fail ArgumentError, "invalid value for \"engagement_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = [0, 1, 7, 14, 30, 60]
+      if @api_client.config.client_side_validation && opts[:'view_window_days'] && !allowable_values.include?(opts[:'view_window_days'])
+        fail ArgumentError, "invalid value for \"view_window_days\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["TIME_OF_AD_ACTION", "TIME_OF_CONVERSION"]
+      if @api_client.config.client_side_validation && opts[:'conversion_report_time'] && !allowable_values.include?(opts[:'conversion_report_time'])
+        fail ArgumentError, "invalid value for \"conversion_report_time\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'attribution_types'].nil? && opts[:'attribution_types'].length > 2
+        fail ArgumentError, 'invalid value for "opts[:"attribution_types"]" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be less than or equal to 2.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'sort_columns'].nil? && opts[:'sort_columns'].length > 2
+        fail ArgumentError, 'invalid value for "opts[:"sort_columns"]" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be less than or equal to 2.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'sort_columns'].nil? && opts[:'sort_columns'].length < 1
+        fail ArgumentError, 'invalid value for "opts[:"sort_columns"]" when calling AdGroupsApi.ad_groups_targeting_analytics_get, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups/targeting_analytics'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ad_group_ids'] = @api_client.build_collection_param(ad_group_ids, :multi)
+      query_params[:'start_date'] = start_date
+      query_params[:'end_date'] = end_date
+      query_params[:'targeting_types'] = @api_client.build_collection_param(targeting_types, :csv)
+      query_params[:'columns'] = @api_client.build_collection_param(columns, :csv)
+      query_params[:'granularity'] = granularity
+      query_params[:'click_window_days'] = opts[:'click_window_days'] if !opts[:'click_window_days'].nil?
+      query_params[:'engagement_window_days'] = opts[:'engagement_window_days'] if !opts[:'engagement_window_days'].nil?
+      query_params[:'view_window_days'] = opts[:'view_window_days'] if !opts[:'view_window_days'].nil?
+      query_params[:'conversion_report_time'] = opts[:'conversion_report_time'] if !opts[:'conversion_report_time'].nil?
+      query_params[:'attribution_types'] = @api_client.build_collection_param(opts[:'attribution_types'], :csv) if !opts[:'attribution_types'].nil?
+      query_params[:'reporting_timezone'] = opts[:'reporting_timezone'] if !opts[:'reporting_timezone'].nil?
+      query_params[:'sort_columns'] = @api_client.build_collection_param(opts[:'sort_columns'], :multi) if !opts[:'sort_columns'].nil?
+      query_params[:'sort_ascending'] = opts[:'sort_ascending'] if !opts[:'sort_ascending'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MetricsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2', 'client_credentials']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_targeting_analytics_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_targeting_analytics_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update ad groups
+    # Update multiple existing ad groups.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_update_batch_update [Array<AdGroupUpdateBatchUpdate>] 
+    # @param [Hash] opts the optional parameters
+    # @return [AdGroupsCreate200Response]
+    def ad_groups_update(ad_account_id, ad_group_update_batch_update, opts = {})
+      data, _status_code, _headers = ad_groups_update_with_http_info(ad_account_id, ad_group_update_batch_update, opts)
+      data
+    end
+
+    # Update ad groups
+    # Update multiple existing ad groups.
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param ad_group_update_batch_update [Array<AdGroupUpdateBatchUpdate>] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AdGroupsCreate200Response, Integer, Hash)>] AdGroupsCreate200Response data, response status code and response headers
+    def ad_groups_update_with_http_info(ad_account_id, ad_group_update_batch_update, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.ad_groups_update ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.ad_groups_update"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.ad_groups_update, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.ad_groups_update, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'ad_group_update_batch_update' is set
+      if @api_client.config.client_side_validation && ad_group_update_batch_update.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_group_update_batch_update' when calling AdGroupsApi.ad_groups_update"
+      end
+      if @api_client.config.client_side_validation && ad_group_update_batch_update.length > 30
+        fail ArgumentError, 'invalid value for "ad_group_update_batch_update" when calling AdGroupsApi.ad_groups_update, number of items must be less than or equal to 30.'
+      end
+
+      if @api_client.config.client_side_validation && ad_group_update_batch_update.length < 1
+        fail ArgumentError, 'invalid value for "ad_group_update_batch_update" when calling AdGroupsApi.ad_groups_update, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/ad_groups'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ad_group_update_batch_update)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroupsCreate200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.ad_groups_update",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#ad_groups_update\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List of ad groups using promotions IDs.
+    #   Get a list of ad groups that are associated with those promotion ids
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param promotion_ids [Array<String>] List of Promotion IDs to use to filter the results.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @option opts [PinterestLibPaginationOrder] :order The order in which to sort the items returned: \&quot;ASCENDING\&quot; or \&quot;DESCENDING\&quot; by ID. Note that higher-value IDs are associated with more-recently added items.
+    # @return [AdGroupsList200Response]
+    def get_ad_groups_by_promotion_ids_list(ad_account_id, promotion_ids, opts = {})
+      data, _status_code, _headers = get_ad_groups_by_promotion_ids_list_with_http_info(ad_account_id, promotion_ids, opts)
+      data
+    end
+
+    # List of ad groups using promotions IDs.
+    #   Get a list of ad groups that are associated with those promotion ids
+    # @param ad_account_id [String] Unique identifier of an ad account.
+    # @param promotion_ids [Array<String>] List of Promotion IDs to use to filter the results.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :bookmark Cursor used to fetch the next page of items
+    # @option opts [Integer] :page_size Maximum number of items to include in a single page. See documentation on [Pagination](/docs/reference/pagination/) for more information. (default to 25)
+    # @option opts [PinterestLibPaginationOrder] :order The order in which to sort the items returned: \&quot;ASCENDING\&quot; or \&quot;DESCENDING\&quot; by ID. Note that higher-value IDs are associated with more-recently added items.
+    # @return [Array<(AdGroupsList200Response, Integer, Hash)>] AdGroupsList200Response data, response status code and response headers
+    def get_ad_groups_by_promotion_ids_list_with_http_info(ad_account_id, promotion_ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdGroupsApi.get_ad_groups_by_promotion_ids_list ...'
+      end
+      # verify the required parameter 'ad_account_id' is set
+      if @api_client.config.client_side_validation && ad_account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_account_id' when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list"
+      end
+      if @api_client.config.client_side_validation && ad_account_id.to_s.length > 18
+        fail ArgumentError, 'invalid value for "ad_account_id" when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, the character length must be smaller than or equal to 18.'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if @api_client.config.client_side_validation && ad_account_id !~ pattern
+        fail ArgumentError, "invalid value for 'ad_account_id' when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'promotion_ids' is set
+      if @api_client.config.client_side_validation && promotion_ids.nil?
+        fail ArgumentError, "Missing the required parameter 'promotion_ids' when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list"
+      end
+      if @api_client.config.client_side_validation && promotion_ids.length > 50
+        fail ArgumentError, 'invalid value for "promotion_ids" when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, number of items must be less than or equal to 50.'
+      end
+
+      if @api_client.config.client_side_validation && promotion_ids.length < 1
+        fail ArgumentError, 'invalid value for "promotion_ids" when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, number of items must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 250
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, must be smaller than or equal to 250.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling AdGroupsApi.get_ad_groups_by_promotion_ids_list, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/ad_accounts/{ad_account_id}/promotion_applied_entities'.sub('{ad_account_id}', CGI.escape(ad_account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'promotion_ids'] = @api_client.build_collection_param(promotion_ids, :multi)
+      query_params[:'bookmark'] = opts[:'bookmark'] if !opts[:'bookmark'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'order'] = opts[:'order'] if !opts[:'order'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdGroupsList200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['pinterest_oauth2']
+
+      new_options = opts.merge(
+        :operation => :"AdGroupsApi.get_ad_groups_by_promotion_ids_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdGroupsApi#get_ad_groups_by_promotion_ids_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end