pinterest_sdk 1.0.0

data/lib/pinterest_sdk.rb

@@ -0,0 +1,192 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.3.0
+Contact: pinterest-api@pinterest.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 5.4.0
+
+=end
+
+# Common files
+require 'pinterest_sdk/api_client'
+require 'pinterest_sdk/api_error'
+require 'pinterest_sdk/version'
+require 'pinterest_sdk/configuration'
+
+# Models
+require 'pinterest_sdk/models/account'
+require 'pinterest_sdk/models/action_type'
+require 'pinterest_sdk/models/ad_account'
+require 'pinterest_sdk/models/ad_account_owner'
+require 'pinterest_sdk/models/ad_group_response'
+require 'pinterest_sdk/models/ad_group_response_all_of'
+require 'pinterest_sdk/models/ad_group_response_all_of1'
+require 'pinterest_sdk/models/ad_group_summary_status'
+require 'pinterest_sdk/models/ad_response'
+require 'pinterest_sdk/models/ad_response_all_of'
+require 'pinterest_sdk/models/ad_response_all_of1'
+require 'pinterest_sdk/models/ads_analytics_create_async_request'
+require 'pinterest_sdk/models/ads_analytics_create_async_request_all_of'
+require 'pinterest_sdk/models/ads_analytics_create_async_request_all_of1'
+require 'pinterest_sdk/models/ads_analytics_create_async_response'
+require 'pinterest_sdk/models/ads_analytics_filter_column'
+require 'pinterest_sdk/models/ads_analytics_filter_operator'
+require 'pinterest_sdk/models/ads_analytics_get_async_response'
+require 'pinterest_sdk/models/ads_analytics_metrics_filter'
+require 'pinterest_sdk/models/ads_analytics_targeting_type'
+require 'pinterest_sdk/models/analytics_metrics_response'
+require 'pinterest_sdk/models/analytics_metrics_response_daily_metrics'
+require 'pinterest_sdk/models/availability_filter'
+require 'pinterest_sdk/models/batch_operation'
+require 'pinterest_sdk/models/batch_operation_status'
+require 'pinterest_sdk/models/board'
+require 'pinterest_sdk/models/board_owner'
+require 'pinterest_sdk/models/board_section'
+require 'pinterest_sdk/models/board_update'
+require 'pinterest_sdk/models/brand_filter'
+require 'pinterest_sdk/models/campaign_common'
+require 'pinterest_sdk/models/campaign_response'
+require 'pinterest_sdk/models/campaign_response_all_of'
+require 'pinterest_sdk/models/campaign_response_all_of1'
+require 'pinterest_sdk/models/campaign_summary_status'
+require 'pinterest_sdk/models/catalogs_db_item'
+require 'pinterest_sdk/models/catalogs_feed'
+require 'pinterest_sdk/models/catalogs_feed_credentials'
+require 'pinterest_sdk/models/catalogs_feed_ingestion_details'
+require 'pinterest_sdk/models/catalogs_feed_ingestion_errors'
+require 'pinterest_sdk/models/catalogs_feed_ingestion_info'
+require 'pinterest_sdk/models/catalogs_feed_processing_result'
+require 'pinterest_sdk/models/catalogs_feed_processing_result_fields'
+require 'pinterest_sdk/models/catalogs_feed_processing_schedule'
+require 'pinterest_sdk/models/catalogs_feed_processing_status'
+require 'pinterest_sdk/models/catalogs_feed_product_counts'
+require 'pinterest_sdk/models/catalogs_feed_validation_details'
+require 'pinterest_sdk/models/catalogs_feed_validation_errors'
+require 'pinterest_sdk/models/catalogs_feed_validation_warnings'
+require 'pinterest_sdk/models/catalogs_feeds_create_request'
+require 'pinterest_sdk/models/catalogs_feeds_update_request'
+require 'pinterest_sdk/models/catalogs_format'
+require 'pinterest_sdk/models/catalogs_items'
+require 'pinterest_sdk/models/catalogs_items_batch'
+require 'pinterest_sdk/models/catalogs_items_batch_request'
+require 'pinterest_sdk/models/catalogs_product_group'
+require 'pinterest_sdk/models/catalogs_product_group_create_request'
+require 'pinterest_sdk/models/catalogs_product_group_currency_criteria'
+require 'pinterest_sdk/models/catalogs_product_group_filter_keys'
+require 'pinterest_sdk/models/catalogs_product_group_filters'
+require 'pinterest_sdk/models/catalogs_product_group_filters_all_of'
+require 'pinterest_sdk/models/catalogs_product_group_filters_any_of'
+require 'pinterest_sdk/models/catalogs_product_group_multiple_string_criteria'
+require 'pinterest_sdk/models/catalogs_product_group_multiple_string_list_criteria'
+require 'pinterest_sdk/models/catalogs_product_group_pricing_criteria'
+require 'pinterest_sdk/models/catalogs_product_group_status'
+require 'pinterest_sdk/models/catalogs_product_group_type'
+require 'pinterest_sdk/models/catalogs_product_group_update_request'
+require 'pinterest_sdk/models/catalogs_status'
+require 'pinterest_sdk/models/condition_filter'
+require 'pinterest_sdk/models/conversion_attribution_window_days'
+require 'pinterest_sdk/models/conversion_report_attribution_type'
+require 'pinterest_sdk/models/conversion_report_time_type'
+require 'pinterest_sdk/models/country'
+require 'pinterest_sdk/models/currency'
+require 'pinterest_sdk/models/currency_filter'
+require 'pinterest_sdk/models/custom_label0_filter'
+require 'pinterest_sdk/models/custom_label1_filter'
+require 'pinterest_sdk/models/custom_label2_filter'
+require 'pinterest_sdk/models/custom_label3_filter'
+require 'pinterest_sdk/models/custom_label4_filter'
+require 'pinterest_sdk/models/data_output_format'
+require 'pinterest_sdk/models/entity_status'
+require 'pinterest_sdk/models/error'
+require 'pinterest_sdk/models/feed_fields'
+require 'pinterest_sdk/models/gender_filter'
+require 'pinterest_sdk/models/google_product_category0_filter'
+require 'pinterest_sdk/models/google_product_category1_filter'
+require 'pinterest_sdk/models/google_product_category2_filter'
+require 'pinterest_sdk/models/google_product_category3_filter'
+require 'pinterest_sdk/models/google_product_category4_filter'
+require 'pinterest_sdk/models/google_product_category5_filter'
+require 'pinterest_sdk/models/google_product_category6_filter'
+require 'pinterest_sdk/models/granularity'
+require 'pinterest_sdk/models/image_details'
+require 'pinterest_sdk/models/item_attributes'
+require 'pinterest_sdk/models/item_batch_record'
+require 'pinterest_sdk/models/item_group_id_filter'
+require 'pinterest_sdk/models/item_id_filter'
+require 'pinterest_sdk/models/item_processing_record'
+require 'pinterest_sdk/models/item_processing_status'
+require 'pinterest_sdk/models/item_validation_event'
+require 'pinterest_sdk/models/language'
+require 'pinterest_sdk/models/max_price_filter'
+require 'pinterest_sdk/models/media_upload'
+require 'pinterest_sdk/models/media_upload_all_of'
+require 'pinterest_sdk/models/media_upload_all_of_upload_parameters'
+require 'pinterest_sdk/models/media_upload_details'
+require 'pinterest_sdk/models/media_upload_request'
+require 'pinterest_sdk/models/media_upload_status'
+require 'pinterest_sdk/models/media_upload_type'
+require 'pinterest_sdk/models/metrics_reporting_level'
+require 'pinterest_sdk/models/min_price_filter'
+require 'pinterest_sdk/models/non_nullable_catalogs_currency'
+require 'pinterest_sdk/models/nullable_currency'
+require 'pinterest_sdk/models/oauth_access_token_request_code_all_of'
+require 'pinterest_sdk/models/oauth_access_token_request_refresh_all_of'
+require 'pinterest_sdk/models/oauth_access_token_response'
+require 'pinterest_sdk/models/oauth_access_token_response_code_all_of'
+require 'pinterest_sdk/models/objective_type'
+require 'pinterest_sdk/models/pacing_delivery_type'
+require 'pinterest_sdk/models/paginated'
+require 'pinterest_sdk/models/pin'
+require 'pinterest_sdk/models/pin_media'
+require 'pinterest_sdk/models/pin_media_source'
+require 'pinterest_sdk/models/pin_media_source_image_base64'
+require 'pinterest_sdk/models/pin_media_source_image_url'
+require 'pinterest_sdk/models/pin_media_source_video_id'
+require 'pinterest_sdk/models/pin_media_with_image_all_of'
+require 'pinterest_sdk/models/pin_promotion_summary_status'
+require 'pinterest_sdk/models/placement_group_type'
+require 'pinterest_sdk/models/product_availability_type'
+require 'pinterest_sdk/models/product_group_summary_status'
+require 'pinterest_sdk/models/product_type0_filter'
+require 'pinterest_sdk/models/product_type1_filter'
+require 'pinterest_sdk/models/product_type2_filter'
+require 'pinterest_sdk/models/product_type3_filter'
+require 'pinterest_sdk/models/product_type4_filter'
+require 'pinterest_sdk/models/reporting_column_async'
+require 'pinterest_sdk/models/targeting_type_filter'
+require 'pinterest_sdk/models/tracking_urls'
+require 'pinterest_sdk/models/oauth_access_token_request_code'
+require 'pinterest_sdk/models/oauth_access_token_request_refresh'
+require 'pinterest_sdk/models/oauth_access_token_response_code'
+require 'pinterest_sdk/models/oauth_access_token_response_refresh'
+require 'pinterest_sdk/models/pin_media_with_image'
+
+# APIs
+require 'pinterest_sdk/api/ad_accounts_api'
+require 'pinterest_sdk/api/boards_api'
+require 'pinterest_sdk/api/catalogs_api'
+require 'pinterest_sdk/api/media_api'
+require 'pinterest_sdk/api/oauth_api'
+require 'pinterest_sdk/api/pins_api'
+require 'pinterest_sdk/api/user_account_api'
+
+module PinterestSdkClient
+  class << self
+    # Customize default settings for the SDK using block.
+    #   PinterestSdkClient.configure do |config|
+    #     config.username = "xxx"
+    #     config.password = "xxx"
+    #   end
+    # If no block given, return the default Configuration object.
+    def configure
+      if block_given?
+        yield(Configuration.default)
+      else
+        Configuration.default
+      end
+    end
+  end
+end

data/pinterest_sdk.gemspec

@@ -0,0 +1,38 @@
+# -*- encoding: utf-8 -*-
+
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.3.0
+Contact: pinterest-api@pinterest.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 5.4.0
+
+=end
+
+$:.push File.expand_path("../lib", __FILE__)
+require "pinterest_sdk/version"
+
+Gem::Specification.new do |s|
+  s.name        = "pinterest_sdk"
+  s.version     = PinterestSdkClient::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Cliffano Subagio"]
+  s.email       = ["blah@cliffano.com"]
+  s.homepage    = "https://github.com/cliffano/pinterest-sdk"
+  s.summary     = "Pinterest REST API Ruby Gem"
+  s.description = "Pinterest's REST API"
+  s.license     = "MIT"
+  s.required_ruby_version = ">= 2.0"
+
+  s.add_runtime_dependency 'typhoeus', '~> 1.0', '>= 1.0.1'
+
+  s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'
+
+  s.files         = `find *`.split("\n").uniq.sort.select { |f| !f.empty? }
+  s.test_files    = `find spec/*`.split("\n")
+  s.executables   = []
+  s.require_paths = ["lib"]
+end

data/spec/api/ad_accounts_api_spec.rb

@@ -0,0 +1,234 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.3.0
+Contact: pinterest-api@pinterest.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 5.4.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::AdAccountsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AdAccountsApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::AdAccountsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AdAccountsApi' do
+    it 'should create an instance of AdAccountsApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::AdAccountsApi)
+    end
+  end
+
+  # unit tests for ad_account_analytics
+  # Get ad account analytics
+  # Get analytics for the specified <code>ad_account_id</code>, 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 <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a>: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD
+  # @param columns Columns to retrieve. **NOTE**: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile's currency field. For USD,($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it's microdollars. Otherwise, it's in microunits of the advertiser's currency.<br/>For example, if the advertiser's currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).<br/>If a column has no value, it may not be returned
+  # @param granularity Granularity
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :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 `30` days.
+  # @option opts [Integer] :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 `30` days.
+  # @option opts [Integer] :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 `1` day.
+  # @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.
+  # @return [Array<Hash<String, Object>>]
+  describe 'ad_account_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for ad_accounts_list
+  # List ad accounts
+  # Get a list of the ad_accounts that the \&quot;operation user_account\&quot; has access to. - This includes ad_accounts they own and ad_accounts that are owned by others who have granted them &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;.
+  # @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 of the response. See documentation on &lt;a href&#x3D;&#39;/docs/api/v5/#tag/Pagination&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [Boolean] :include_shared_accounts Include shared ad accounts
+  # @return [Paginated]
+  describe 'ad_accounts_list test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for ad_groups_analytics
+  # Get ad group analytics
+  # Get analytics for the specified ad groups in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD
+  # @param ad_group_ids List of Ad group Ids to use to filter the results.
+  # @param columns Columns to retrieve. **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.&lt;br/&gt;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).&lt;br/&gt;If a column has no value, it may not be returned
+  # @param granularity Granularity
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @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.
+  # @return [Array<Hash<String, Object>>]
+  describe 'ad_groups_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for ad_groups_list
+  # List ad groups
+  # Get a list of the ad groups in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @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 use to filter the results.
+  # @option opts [Array<String>] :entity_statuses Entity status
+  # @option opts [Integer] :page_size Maximum number of items to include in a single page of the response. See documentation on &lt;a href&#x3D;&#39;/docs/api/v5/#tag/Pagination&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [String] :order The order in which to sort the items returned: “ASCENDING” or “DESCENDING” by ID. Note that higher-value IDs are associated with more-recently added items.
+  # @option opts [String] :bookmark Cursor used to fetch the next page of items
+  # @option opts [Boolean] :translate_interests_to_names Return interests as text names (if value is true) rather than topic IDs.
+  # @return [Paginated]
+  describe 'ad_groups_list test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for ads_analytics
+  # Get ad analytics
+  # Get analytics for the specified ads in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD
+  # @param ad_ids List of Ad Ids to use to filter the results.
+  # @param columns Columns to retrieve. **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.&lt;br/&gt;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).&lt;br/&gt;If a column has no value, it may not be returned
+  # @param granularity Granularity
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @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.
+  # @return [Array<Hash<String, Object>>]
+  describe 'ads_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for ads_list
+  # List ads
+  # Get a list of the ads in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @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 use to filter the results.
+  # @option opts [Array<String>] :ad_ids List of Ad Ids to use to filter the results.
+  # @option opts [Array<String>] :entity_statuses Entity status
+  # @option opts [Integer] :page_size Maximum number of items to include in a single page of the response. See documentation on &lt;a href&#x3D;&#39;/docs/api/v5/#tag/Pagination&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [String] :order The order in which to sort the items returned: “ASCENDING” or “DESCENDING” by ID. Note that higher-value IDs are associated with more-recently added items.
+  # @option opts [String] :bookmark Cursor used to fetch the next page of items
+  # @return [Paginated]
+  describe 'ads_list test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for analytics_create_report
+  # Create async request for an account analytics report
+  # This returns a token that you can use to download the report when it is ready. Note that this endpoint requires the parameters to be passed as JSON-formatted in the request body. This endpoint does not support URL query parameters. - 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param ads_analytics_create_async_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AdsAnalyticsCreateAsyncResponse]
+  describe 'analytics_create_report test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for analytics_get_report
+  # Get the account analytics report created by the async call
+  # This returns a URL to an analytics report given a token returned from the post request report creation call. You can use the URL to download the report and it&#39;s valid for an hour. - 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param token Token returned from the post request creation call
+  # @param [Hash] opts the optional parameters
+  # @return [AdsAnalyticsGetAsyncResponse]
+  describe 'analytics_get_report test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for campaigns_analytics
+  # Get campaign analytics
+  # Get analytics for the specified campaigns in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD
+  # @param campaign_ids List of Campaign Ids to use to filter the results.
+  # @param columns Columns to retrieve. **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.&lt;br/&gt;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).&lt;br/&gt;If a column has no value, it may not be returned
+  # @param granularity Granularity
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @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.
+  # @return [Array<Hash<String, Object>>]
+  describe 'campaigns_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for campaigns_list
+  # List campaigns
+  # Get a list of the campaigns in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Array<String>] :campaign_ids List of Campaign Ids to use to filter the results.
+  # @option opts [Array<String>] :entity_statuses Entity status
+  # @option opts [Integer] :page_size Maximum number of items to include in a single page of the response. See documentation on &lt;a href&#x3D;&#39;/docs/api/v5/#tag/Pagination&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [String] :order The order in which to sort the items returned: “ASCENDING” or “DESCENDING” by ID. Note that higher-value IDs are associated with more-recently added items.
+  # @option opts [String] :bookmark Cursor used to fetch the next page of items
+  # @return [Paginated]
+  describe 'campaigns_list test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for product_groups_analytics
+  # Get product group analytics
+  # Get analytics for the specified product groups in the specified &lt;code&gt;ad_account_id&lt;/code&gt;, 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 &lt;a href&#x3D;\&quot;https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\&quot;&gt;Business Access&lt;/a&gt;: Admin, Analyst, Campaign Manager.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD
+  # @param product_group_ids List of Product group Ids to use to filter the results.
+  # @param columns Columns to retrieve. **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.&lt;br/&gt;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).&lt;br/&gt;If a column has no value, it may not be returned
+  # @param granularity Granularity
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @option opts [Integer] :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.
+  # @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.
+  # @return [Array<Hash<String, Object>>]
+  describe 'product_groups_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end