pinterest_sdk 1.1.0 → 2.0.0

data/spec/api/leads_export_api_spec.rb

@@ -0,0 +1,61 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.23.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::LeadsExportApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'LeadsExportApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::LeadsExportApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of LeadsExportApi' do
+    it 'should create an instance of LeadsExportApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::LeadsExportApi)
+    end
+  end
+
+  # unit tests for leads_export_create
+  # Create a request to export leads collected from a lead ad
+  # <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>  Create an export of leads collected from a lead ad. This returns a lead_export_id  token that you can use to download the export when it is ready.  Note: Lead ad data will be available up to 30 days after the lead has been submitted.  For more, see <a class=\"reference external\" href=\"https://help.pinterest.com/en/business/article/lead-ads\">Lead ads</a>.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param leads_export_create_request 
+  # @param [Hash] opts the optional parameters
+  # @return [LeadsExportCreateResponse]
+  describe 'leads_export_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 leads_export_get
+  # Get the lead export from the lead export create call
+  # <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>  Get the export of leads collected from a lead ad. This returns a URL to a list of lead export given a lead_export_id token returned from the create a lead export call. You can use the URL to download the report.  Note: Lead ad data will be available up to 30 days after the lead has been submitted.  For more, see <a class=\"reference external\" href=\"https://help.pinterest.com/en/business/article/lead-ads\">Lead ads</a>.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param leads_export_id lead_export_id token returned from the create a lead export endpoint
+  # @param [Hash] opts the optional parameters
+  # @return [LeadsExportResponseData]
+  describe 'leads_export_get 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/media_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.23.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.18.0
 
 =end
 
@@ -34,38 +34,38 @@ describe 'MediaApi' do
 
   # unit tests for media_create
   # Register media upload
-  # Register your intent to upload media  The response includes all of the information needed to upload the media to Pinterest.  To upload the media, make an HTTP POST request (using <tt>curl</tt>, for example) to <tt>upload_url</tt> using the <tt>Content-Type</tt> header value. Send the media file's contents as the request's <tt>file</tt> parameter and also include all of the parameters from <tt>upload_parameters</tt>.  <strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.
-  # @param media_upload_request Create a media upload request
+  # Register your intent to upload media.  The response includes all of the information needed to upload the media to Pinterest.  To upload the media, make an HTTP POST request (using `curl`, for example) to `upload_url` using the `Content-Type` header value. Send the media file's contents as the request's `file` parameter and also include all of the parameters from `upload_parameters`.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.
+  # @param media_upload_create 
   # @param [Hash] opts the optional parameters
   # @return [MediaUpload]
   describe 'media_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 media_get
   # Get media upload details
-  # Get details for a registered media upload, including its current status.  <strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.
-  # @param media_id Media identifier
+  # Get details for a registered media upload, including its current status.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.
+  # @param media_id Unique identifier for this media upload. Used to track status and for attaching during Pin creation.
   # @param [Hash] opts the optional parameters
-  # @return [MediaUploadDetails]
+  # @return [Media]
   describe 'media_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 media_list
   # List media uploads
-  # List media uploads filtered by given parameters.  <strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.
+  # List media uploads filtered by given parameters.  **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.
   # @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 <a href='/docs/api/v5/#tag/Pagination'>Pagination</a> for more information.
-  # @return [Paginated]
+  # @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 [MediaList200Response]
   describe 'media_list 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
 

data/spec/api/msot_events_api_spec.rb

@@ -0,0 +1,48 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.23.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::MsotEventsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'MsotEventsApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::MsotEventsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of MsotEventsApi' do
+    it 'should create an instance of MsotEventsApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::MsotEventsApi)
+    end
+  end
+
+  # unit tests for msot_events_create
+  # Send Measurement Source Of Truth (MSOT) attributed conversion events
+  # <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong> <br> <p>Advertisers or their measurement partners can send attributed MSOT conversion events to Pinterest based on their <code>ad_account_id</code>. The request body should be a JSON object.</p> - These events will NOT be used in Reporting.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param conversion_msot_events Attributed MSOT conversion events
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'msot_events_create 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/notification_api_spec.rb

@@ -0,0 +1,47 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.23.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::NotificationApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'NotificationApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::NotificationApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of NotificationApi' do
+    it 'should create an instance of NotificationApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::NotificationApi)
+    end
+  end
+
+  # unit tests for notification_post
+  # Receive notifications from external partners.
+  # Used by third-party partners to send notifications to Pinterest. These notifications could be specific for your use-case or generic notification that are accepted by Pinterests' systems. This API is gated and you need to request access to this feature.
+  # @param notification_post_request notification event.
+  # @param [Hash] opts the optional parameters
+  # @return [NotificationResponse]
+  describe 'notification_post 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/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.23.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.18.0
 
 =end
 
@@ -32,15 +32,39 @@ 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 [ConversionAccessTokenResponse]
+  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 <a href='/docs/getting-started/set-up-authentication-and-authorization/' target='blank'>requesting and refreshing tokens</a>.  <strong>Note:</strong> If your app was created <strong>before September 25, 2025</strong>, make sure to set the <code>continuous_refresh</code> parameter to <code>true</code> 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 <a href='/docs/developer-tools/token-debugger/' target='blank'>Token Debugger</a> to validate and inspect your access token.
   # @param grant_type 
   # @param [Hash] opts the optional parameters
   # @return [OauthAccessTokenResponse]
   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 [String] :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.23.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.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 ad_account_id Unique identifier of an ad account.
+  # @param order_line_id Unique identifier of an order line.
+  # @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 [Integer] :page_size Maximum number of items to include in a single page of the response. See documentation on <a href='/docs/reference/pagination/'>Pagination</a> 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 [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.23.0
+Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 5.4.0
+Generator version: 7.18.0
 
 =end
 
@@ -32,58 +32,125 @@ describe 'PinsApi' do
     end
   end
 
+  # unit tests for multi_pins_analytics
+  # Get multiple Pin analytics
+  # <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>  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 <code>ad_account_id</code> (obtained via <a href=\"/docs/api/v5/#operation/ad_accounts/list\">List ad accounts</a>) 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 <a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a> 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 <code>2023-03-20</code> 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 &lt;code&gt;ad_account_id&lt;/code&gt; (obtained via &lt;a href&#x3D;\&quot;/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.  If Pin was created before &lt;code&gt;2023-03-20&lt;/code&gt; 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 &lt;code&gt;2023-03-20&lt;/code&gt;, 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 &lt;code&gt;NO_SPLIT&lt;/code&gt;.
   # @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
+  # @option opts [String] :ad_account_id Unique identifier of an ad account.
   # @return [nil]
   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 [String] :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 [String] :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] :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 &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.  - 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 Request object used to save an existing pin
+  # @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_categories_api_spec.rb

@@ -0,0 +1,79 @@
+=begin
+#Pinterest REST API
+
+#Pinterest's REST API
+
+The version of the OpenAPI document: 5.23.0
+Contact: blah+oapicf@cliffano.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.18.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PinterestSdkClient::ProductCategoriesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ProductCategoriesApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::ProductCategoriesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ProductCategoriesApi' do
+    it 'should create an instance of ProductCategoriesApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::ProductCategoriesApi)
+    end
+  end
+
+  # unit tests for trends_featured_topics_list
+  # Get featured topics
+  #   Enables advertisers to pull top five trending topics by interest and market, at full parity with the Pinterest Trends UI.
+  # @param region       The geographic region of interest. Only top product categories within the specified region will be returned.      The `region` parameter is formatted as ISO 3166-2 country codes delimited by `+`.      - `US` - United States     - `GB+IE` - Great Britain & Ireland     - `CA` - Canada
+  # @param [Hash] opts the optional parameters
+  # @option opts [InterestsEnum] :interest Interest to filter by
+  # @return [Array<FeaturedTrend>]
+  describe 'trends_featured_topics_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 trends_product_categories_details_list
+  # Get product category details
+  #   Enables advertisers to retrieve demographic information, related pins, and trend lines for specified product categories
+  # @param product_categories List of product categories
+  # @param region       The geographic region of interest. Only top product categories within the specified region will be returned.      The &#x60;region&#x60; parameter is formatted as ISO 3166-2 country codes delimited by &#x60;+&#x60;.      - &#x60;US&#x60; - United States     - &#x60;GB+IE&#x60; - Great Britain &amp; Ireland     - &#x60;CA&#x60; - Canada
+  # @param [Hash] opts the optional parameters
+  # @option opts [ProductCategoryDetailLookbackWindow] :lookback_window    Time period for historical data analysis in days. The lookback window defines how far back in time the API will analyze data to compute trend metrics.   - &#x60;90&#x60; - Last 90 days (3 months)   - &#x60;180&#x60; - Last 180 days (6 months)   - &#x60;365&#x60; - Last 365 days (1 year)   - &#x60;730&#x60; - Last 730 days (2 years)
+  # @option opts [ProductCategoriesEngagementType] :engagement_type      Type of engagement metric to analyze. - &#x60;ENGAGEMENT&#x60; - Overall engagement metric - &#x60;OUTBOUND_CLICK&#x60; - Number of outbound clicks - &#x60;SAVE&#x60; - Number of pin saves
+  # @return [Array<ProductCategoryDetails>]
+  describe 'trends_product_categories_details_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 trends_product_categories_trending_list
+  # Get a list of growing Shopping Product Categories
+  #   Get a list of growing Shopping Product Categories in ranked order allowing filtering by engagement type, vertical, age, and gender.
+  # @param region       The geographic region of interest. Only top product categories within the specified region will be returned.      The &#x60;region&#x60; parameter is formatted as ISO 3166-2 country codes delimited by &#x60;+&#x60;.      - &#x60;US&#x60; - United States     - &#x60;GB+IE&#x60; - Great Britain &amp; Ireland     - &#x60;CA&#x60; - Canada
+  # @param [Hash] opts the optional parameters
+  # @option opts [Array<VerticalProductCategory>] :verticals List of verticals to filter by
+  # @option opts [Array<AgeTrendsBucket>] :ages Age to filter by. If not provided, the results will be filtered by all ages.
+  # @option opts [Array<GenderBucket>] :genders Gender to filter by, If not provided, the results will be filtered by all genders.
+  # @option opts [ProductCategoriesEngagementType] :engagement_type      Type of engagement metric to analyze. - &#x60;ENGAGEMENT&#x60; - Overall engagement metric - &#x60;OUTBOUND_CLICK&#x60; - Number of outbound clicks - &#x60;SAVE&#x60; - Number of pin saves
+  # @return [Array<TrendingProductCategory>]
+  describe 'trends_product_categories_trending_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end