pinterest_sdk 1.1.0 → 2.1.0

data/spec/api/oauth_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.3.0
-Contact: blah@cliffano.com
+The version of the OpenAPI document: 5.28.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.24.0
 
 =end
 
@@ -32,15 +32,44 @@ describe 'OauthApi' do
     end
   end
 
+  # unit tests for oauth_conversion_token
+  # Generate OAuth access token for conversion API
+  # Generate a new and long-lived OAuth access token dedicated for sending conversions using a valid access token.
+  # @param [Hash] opts the optional parameters
+  # @return [ConversionAccessToken]
+  describe 'oauth_conversion_token test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for oauth_token
   # Generate OAuth access token
-  # Generate an OAuth access token by using an authorization code or a refresh token.  See <a href='/docs/api/v5/#tag/Authentication'>Authentication</a> for more.
+  # Generate a new OAuth access token using an authorization code; or refresh an existing one using a continuous refresh token.  Follow the complete steps for [requesting and refreshing tokens](/docs/getting-started/set-up-authentication-and-authorization/).  **Note:** If your app was created **before September 25, 2025**, make sure to set the `continuous_refresh` parameter to `true` to use the continuous refresh token (60-day expiration, refreshable indefinitely). Pinterest no longer supports the legacy refresh token (365-day expiration, hard limit).  Disregard this note if your app was activated on or after September 25, 2025. You are automatically using the continuous refresh token.  Use [Token Debugger](/docs/developer-tools/token-debugger/) to validate and inspect your access token. 
   # @param grant_type 
   # @param [Hash] opts the optional parameters
-  # @return [OauthAccessTokenResponse]
+  # @option opts [String] :code 
+  # @option opts [String] :continuous_refresh   If your app was created before **September 25, 2025**, set to `true` to generate a [continuous refresh token](/docs/getting-started/set-up-authentication-and-authorization/#exchange-the-default-refresh-token-for-a-continuous-refresh-token), which has a 60-day expiration window. We no longer support the legacy refresh token, which has a 365-day expiration window.    If your app was created on or after **September 25, 2025**, ignore this parameter. You automatically receive a continuous refresh token when you request an access token.
+  # @option opts [String] :redirect_uri 
+  # @option opts [String] :refresh_token 
+  # @option opts [String] :scope 
+  # @return [OauthAccessToken]
   describe 'oauth_token test' do
     it 'should work' do
-      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for token_revoke
+  # Revoke a token
+  # Revokes an access or refresh token. Only tokens issued for system users are currently supported. Revoked tokens become immediately invalid and unusable.
+  # @param token The token to revoke.
+  # @param [Hash] opts the optional parameters
+  # @option opts [TokenTypeHint] :token_type_hint The type of the token to revoke. Please refer to [our developer guide for more information](https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/) for more information.
+  # @return [nil]
+  describe 'token_revoke test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 

data/spec/api/order_lines_api_spec.rb

@@ -0,0 +1,63 @@
+=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 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::OrderLinesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'OrderLinesApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::OrderLinesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of OrderLinesApi' do
+    it 'should create an instance of OrderLinesApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::OrderLinesApi)
+    end
+  end
+
+  # unit tests for order_lines_get
+  # Get order line
+  # Get a specific existing order line associated with an ad account.
+  # @param order_line_id Order line ID.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @return [OrderLine]
+  describe 'order_lines_get test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for order_lines_list
+  # Get order lines.
+  # List existing order lines associated with an ad account.
+  # @param ad_account_id 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.
+  # @option opts [PinterestLibPaginationOrder] :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.
+  # @return [OrderLinesList200Response]
+  describe 'order_lines_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/pins_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.3.0
-Contact: blah@cliffano.com
+The version of the OpenAPI document: 5.28.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.24.0
 
 =end
 
@@ -32,58 +32,128 @@ describe 'PinsApi' do
     end
   end
 
+  # unit tests for multi_pins_analytics
+  # Get multiple Pin analytics
+  # **This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**  Get analytics for multiple pins owned by the \"operation user_account\" - or on a group board that has been shared with this account. - The maximum number of pins supported in a single request is 100. - By default, the \"operation user_account\" is the token user_account.  Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before `2023-03-20` lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
+  # @param pin_ids List of Pin IDs.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+  # @param metric_types Pin metric types to get data for.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :app_types Apps or devices to get data for, default is all.
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @return [Hash<String, Hash>]
+  describe 'multi_pins_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for pins_analytics
   # Get Pin analytics
-  # Get analytics for a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;\&quot;https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list\&quot;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &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; roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.
+  # Get analytics for a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Admin, Analyst. - For Pins on secret boards: Admin.  If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
   # @param pin_id Unique identifier of a Pin.
-  # @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 metric_types Pin metric types to get data for, default is all.
+  # @param start_date Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+  # @param metric_types Pin metric types to get data for. VIDEO_MRC_VIEW are Video views, VIDEO_V50_WATCH_TIME is Total play time. If Pin was created before &#x60;2023-03-20&#x60;, Profile visits and Follows will only be available for Idea Pins. These metrics are available for all Pin formats since then. Keep in mind this cannot have ALL if split_field is set to any value other than &#x60;NO_SPLIT&#x60;.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :app_types Apps or devices to get data for, default is all.
   # @option opts [String] :split_field How to split the data into groups. Not including this param means data won&#39;t be split.
   # @option opts [String] :ad_account_id Unique identifier of an ad account.
-  # @return [Hash<String, AnalyticsMetricsResponse>]
+  # @return [Hash<String, PinAnalyticsMetricsResponse>]
   describe 'pins_analytics test' do
     it 'should work' do
-      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
   # unit tests for pins_create
   # Create Pin
-  # Create a Pin on a board or board section owned by the \&quot;operation user_account\&quot;.  Note: If the current \&quot;operation user_account\&quot; (defined by the access token) has access to another user&#39;s Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account&#39;s permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id&#x3D;12345&amp;...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called &#39;curated content&#39;, please use our &lt;a href&#x3D;&#39;/docs/add-ons/save-button&#39;&gt;Save button&lt;/a&gt; instead. For more tips on creating fresh content for Pinterest, review our &lt;a href&#x3D;&#39;/docs/solutions/content-apps&#39;&gt;Content App Solutions Guide&lt;/a&gt;.  &lt;strong&gt;&lt;a href&#x3D;&#39;/docs/solutions/content-apps/#creatingvideopins&#39;&gt;Learn more&lt;/a&gt;&lt;/strong&gt; about video Pin creation.
-  # @param pin Create a new Pin.
+  #  Create a Pin on a board or board section owned by the \&quot;operation user_account\&quot;.   Note: If the current \&quot;operation user_account\&quot; (defined by the access token) has access to another user&#39;s Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account&#39;s permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id&#x3D;12345&amp;...).  - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called &#39;curated content&#39;, please use our [Save button](/docs/web-features/add-ons-overview/) instead. For more tips on creating fresh content for Pinterest, review our [Content App Solutions Guide](/docs/api-features/content-overview/).  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-image-pins)** about image Pin creation.
+  # @param pin_create 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
   # @return [Pin]
   describe 'pins_create test' do
     it 'should work' do
-      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
   # unit tests for pins_delete
   # Delete Pin
-  # Delete a Pins owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.
-  # @param pin_id Unique identifier of a Pin.
+  #   Delete a Pins owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account.   - By default, the \&quot;operation user_account\&quot; is the token user_account.    Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+  # @param pin_id 
   # @param [Hash] opts the optional parameters
-  # @return [nil]
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @return [Pin]
   describe 'pins_delete test' do
     it 'should work' do
-      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
   # unit tests for pins_get
   # Get Pin
-  # Get a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;&#39;/docs/api/v5/#operation/ad_accounts/list&#39;&gt;List ad accounts&lt;/a&gt;) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following &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; roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.
-  # @param pin_id Unique identifier of a Pin.
+  #   Get a Pin owned by the \&quot;operation user_account\&quot; - or on a group board that has been shared with this account.   - By default, the \&quot;operation user_account\&quot; is the token user_account.    Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:    - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.   - For Pins on secret boards: Owner, Admin.
+  # @param pin_id 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
   # @return [Pin]
   describe 'pins_get test' do
     it 'should work' do
-      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for pins_list
+  # List Pins
+  #     Get a list of the Pins owned by the \&quot;operation user_account\&quot;.     - By default, the \&quot;operation user_account\&quot; is the token user_account.     - All Pins owned by the \&quot;operation user_account\&quot; are included, regardless of who owns the board they are on.      Optional: Business Access: Specify an &#x60;ad_account_id&#x60; to use the owner of that ad_account as the \&quot;operation user_account\&quot;.      Disclaimer: There are known performance issues when filtering by field &#x60;creative_type&#x60; and including protected pins.     If your request is timing out in this scenario, we encourage you to use [GET List Pins on Board](/docs/api/v5/#operation/boards/list_pins).
+  # @param [Hash] opts the optional parameters
+  # @option opts [PinFilter] :pin_filter The filter to apply to the pins
+  # @option opts [Boolean] :pin_metrics Specify whether to return 90d and lifetime Pin metrics. Total comments and total reactions are only available with lifetime Pin metrics. If Pin was created before &#x60;2023-03-20&#x60; lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
+  # @option opts [Boolean] :include_protected_pins Whether to include protected pins in the results
+  # @option opts [PinType] :pin_type The type of pins to return, currently only enabled for private pins
+  # @option opts [Array<CreativeType>] :creative_types Pin creative types filter. **Note:** SHOP_THE_PIN has been deprecated. Please use COLLECTION instead.
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @option opts [String] :domain Only return pins with links that match the exact domain. Domain should not include &#39;www.&#39; prefix. For example, &#39;pinterest.com&#39; is a valid domain, but &#39;www.pinterest.com&#39; is not (will not match any pins).
+  # @option opts [Array<String>] :domains Only return pins with links whose domain matches any value in the list. Values are joined comma-separated on the wire (e.g. &#x60;?domains&#x3D;instagram.com,jcpenney.com&#x60;).
+  # @option opts [Boolean] :include_product_tag_obj Include product tag objects in the response with their associated links.
+  # @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.
+  # @return [PinsList200Response]
+  describe 'pins_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for pins_save
+  # Save Pin
+  # Save a Pin on a board or board section owned by the \&quot;operation user_account\&quot;. - By default, the \&quot;operation user_account\&quot; is the token user_account. Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  - Any Pin type can be saved: image Pin, video Pin, Idea Pin, product Pin, etc. - Any public Pin can be saved given a pin ID.
+  # @param pin_id Unique identifier of a Pin.
+  # @param pins_save_request_create 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @return [Pin]
+  describe 'pins_save test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for pins_update
+  # Update Pin
+  # Update a pin owned by the \&quot;operating user_account\&quot;. - By default, the \&quot;operation user_account\&quot; is the token user_account.  Optional: Business Access: Specify an &#x60;ad_account_id&#x60; (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the \&quot;operation user_account\&quot;. In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account:  - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager. - For Pins on secret boards: Owner, Admin.  **This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**
+  # @param pin_id 
+  # @param pin_update 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
+  # @return [Pin]
+  describe 'pins_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 

data/spec/api/product_group_promotions_api_spec.rb

@@ -0,0 +1,114 @@
+=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 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::ProductGroupPromotionsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ProductGroupPromotionsApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::ProductGroupPromotionsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ProductGroupPromotionsApi' do
+    it 'should create an instance of ProductGroupPromotionsApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::ProductGroupPromotionsApi)
+    end
+  end
+
+  # unit tests for product_group_promotions_create
+  # Create product group promotions
+  # Add one or more product groups from your catalog to an existing ad group. (Product groups added to an ad group are a 'product group promotion.')
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param product_group_promotions_create 
+  # @param [Hash] opts the optional parameters
+  # @return [ProductGroupPromotions]
+  describe 'product_group_promotions_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for product_group_promotions_get
+  # Get a product group promotion by id
+  # Get a product group promotion by id
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param product_group_promotion_id Unique identifier of a product group promotion
+  # @param [Hash] opts the optional parameters
+  # @return [ProductGroupPromotion]
+  describe 'product_group_promotions_get test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for product_group_promotions_list
+  # Get product group promotions
+  # List existing product group promotions associated with an ad account.  Include either ad_group_id or product_group_promotion_ids in your request.  **Note:** ad_group_ids and product_group_promotion_ids are mutually exclusive parameters. Only provide one. If multiple options are provided, product_group_promotion_ids takes precedence over ad_group_ids. If none are provided, the endpoint returns an error.
+  # @param ad_account_id 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.
+  # @option opts [PinterestLibPaginationOrder] :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 [Array<String>] :product_group_promotion_ids List of Product group promotion Ids.
+  # @option opts [Array<EntityStatus>] :entity_statuses Entity status
+  # @option opts [String] :ad_group_id Ad group Id.
+  # @return [ProductGroupPromotionsList200Response]
+  describe 'product_group_promotions_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for product_group_promotions_update
+  # Update product group promotions
+  # Update multiple existing Product Group Promotions (by product_group_id)
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param product_group_promotions_update_with_required_body 
+  # @param [Hash] opts the optional parameters
+  # @return [ProductGroupPromotions]
+  describe 'product_group_promotions_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/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 &#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 Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
+  # @param end_date Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
+  # @param product_group_ids List of Product group Ids to use to filter the results.
+  # @param columns 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   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 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.
+  # @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**.
+  # @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.
+  # @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.
+  # @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<ProductGroupAnalyticsItems>]
+  describe 'product_groups_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/product_tags_api_spec.rb

@@ -0,0 +1,73 @@
+=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 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::ProductTagsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ProductTagsApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::ProductTagsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ProductTagsApi' do
+    it 'should create an instance of ProductTagsApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::ProductTagsApi)
+    end
+  end
+
+  # unit tests for product_tags_bulk_add
+  # Add product tags to pin
+  # Add product tags to a pin. Product tags allow you to tag product pins onto a hero pin. - Maximum 24 product tags can be added in a single request. - Duplicate pin_ids in the request will result in an error. - If any product tag fails eligibility check, the entire request fails (all-or-nothing). - If a product tag is already tagged on the pin, it is treated as a no-op success.
+  # @param pin_id Unique identifier of the hero pin that will receive product tags.
+  # @param product_tags_bulk_add_request 
+  # @param [Hash] opts the optional parameters
+  # @return [ProductTagsResponse]
+  describe 'product_tags_bulk_add test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for product_tags_bulk_delete
+  # Delete product tags from pin
+  # Delete product tags from a pin. - If a product tag is not found on the pin, it is treated as a no-op success.
+  # @param pin_id Unique identifier of the hero pin that will receive product tags.
+  # @param product_tags_bulk_delete_request 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'product_tags_bulk_delete test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for product_tags_list
+  # Get product tags for pin
+  # Retrieve all product tags for a pin. - Returns an empty array if the pin has no product tags.
+  # @param pin_id Unique identifier of the hero pin that will receive product tags.
+  # @param [Hash] opts the optional parameters
+  # @return [ProductTagsResponse]
+  describe 'product_tags_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/promotions_api_spec.rb

@@ -0,0 +1,102 @@
+=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 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::PromotionsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PromotionsApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::PromotionsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PromotionsApi' do
+    it 'should create an instance of PromotionsApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::PromotionsApi)
+    end
+  end
+
+  # unit tests for promotions_create
+  # Create promotions
+  # Create multiple new promotions.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param promotion_create 
+  # @param [Hash] opts the optional parameters
+  # @return [PromotionsResponse]
+  describe 'promotions_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for promotions_delete
+  # Delete promotion by id
+  # Delete a promotion within Pinterest.
+  # @param promotion_id Promotion ID
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @return [Promotion]
+  describe 'promotions_delete test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for promotions_get
+  # Get promotion by id
+  # Get a promotion by its Pinterest-specific id. It must be associated with the provided ad account id.
+  # @param promotion_id Promotion ID
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param [Hash] opts the optional parameters
+  # @return [Promotion]
+  describe 'promotions_get test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for promotions_list
+  # Get promotions
+  # Gets all promotions associated with an ad account ID that can be applied to an ad group. Can be either internally-saved promotions or external promotions imported from a commerce integration.
+  # @param ad_account_id 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.
+  # @option opts [PinterestLibPaginationOrder] :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.
+  # @return [PromotionsList200Response]
+  describe 'promotions_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for promotions_update
+  # Update promotions
+  # Update multiple promotions.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param promotion_batch_update 
+  # @param [Hash] opts the optional parameters
+  # @return [PromotionsResponse]
+  describe 'promotions_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end