pinterest_sdk 2.0.0 → 2.1.0

data/spec/api/conversions_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -32,16 +32,55 @@ describe 'ConversionsApi' do
     end
   end
 
+  # unit tests for advertiser_defined_events_create
+  # Create advertiser defined events
+  # Map advertiser defined events to standard events for the given ad account.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param advertiser_defined_events_create_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AdvertiserDefinedEventsCreate200Response]
+  describe 'advertiser_defined_events_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 advertiser_defined_events_delete
+  # Delete advertiser defined events
+  # Untrack advertiser defined events for the given ad account.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param event_names List of event names to delete
+  # @param [Hash] opts the optional parameters
+  # @return [AdvertiserDefinedEventsCreate200Response]
+  describe 'advertiser_defined_events_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 advertiser_defined_events_get
   # Get advertiser defined events
-  # <p>Get advertiser defined events for the given ad account.</p>
+  # Get advertiser defined events for the given ad account.
   # @param ad_account_id Unique identifier of an ad account.
   # @param [Hash] opts the optional parameters
-  # @return [AdvertiserDefinedEventsResponse]
+  # @return [AdvertiserDefinedEventsGet200Response]
   describe 'advertiser_defined_events_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 advertiser_defined_events_update
+  # Update advertiser defined events
+  # Update advertiser defined event names or mappings for the given ad account.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param advertiser_defined_events_create_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AdvertiserDefinedEventsCreate200Response]
+  describe 'advertiser_defined_events_update 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/customer_list_uploads_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -34,10 +34,10 @@ describe 'CustomerListUploadsApi' do
 
   # unit tests for customer_list_uploads_create
   # Create customer list upload
-  # <a href=\"/docs/getting-started/using-beta-and-restricted-features/\" target=\"_blank\">Closed beta</a>  <p>Create a customer list upload request for multipart S3 upload.</p> <p>Note: Each part must be at least 5mb; however the last part can be any size greater than 0. Clients with smaller files can request a single part count. This minimal part size restriction is defined by the AWS S3 API.</p> <p><b>Please review the <u><a href=\"/docs/api/v5/customer_lists-update/\" target=\"_blank\">update customer list endpoint</a></u> documentation for additional information.</b></p>
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_id Unique identifier of a customer list
-  # @param customer_list_upload_create_request Parameters to create a customer list upload request
+  # Create a customer list upload request for multipart S3 upload.  Note: Each part must be at least 5mb; however the last part can be any size greater than 0. Clients with smaller files can request a single part count. This minimal part size restriction is defined by the AWS S3 API.  **Please review the [update customer list endpoint](/docs/api/v5/customer_lists-update/) documentation for additional information.**
+  # @param ad_account_id 
+  # @param customer_list_id Customer list ID.
+  # @param customer_list_upload_create_request 
   # @param [Hash] opts the optional parameters
   # @return [CustomerListUploadCreateResponse]
   describe 'customer_list_uploads_create test' do
@@ -48,12 +48,12 @@ describe 'CustomerListUploadsApi' do
 
   # unit tests for customer_list_uploads_get
   # Get customer list upload
-  # <a href=\"/docs/getting-started/using-beta-and-restricted-features/\" target=\"_blank\">Closed beta</a> <p>Get the metadata for a given upload by its ID.</p>
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_id Unique identifier of a customer list
-  # @param customer_list_upload_id Unique identifier of a customer list upload
+  # Get the metadata for a given upload by its ID.
+  # @param ad_account_id 
+  # @param customer_list_id Customer list ID.
+  # @param customer_list_upload_id Customer List Upload ID.
   # @param [Hash] opts the optional parameters
-  # @return [CustomerListUploadResponse]
+  # @return [CustomerListUpload]
   describe 'customer_list_uploads_get test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -62,12 +62,12 @@ describe 'CustomerListUploadsApi' do
 
   # unit tests for customer_list_uploads_run
   # Run customer list upload
-  # <a href=\"/docs/getting-started/using-beta-and-restricted-features/\" target=\"_blank\">Closed beta</a> <p>Begin processing a customer list upload.</p>
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_id Unique identifier of a customer list
-  # @param customer_list_upload_id Unique identifier of a customer list upload
+  # Begin processing a customer list upload.
+  # @param ad_account_id 
+  # @param customer_list_id Customer list ID.
+  # @param customer_list_upload_id Customer List Upload ID.
   # @param [Hash] opts the optional parameters
-  # @return [CustomerListUploadResponse]
+  # @return [CustomerListUpload]
   describe 'customer_list_uploads_run test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/api/customer_lists_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -34,9 +34,9 @@ describe 'CustomerListsApi' do
 
   # unit tests for customer_lists_create
   # Create customer lists
-  # <p>Create a customer list from your records(hashed or plain-text email addresses, or hashed MAIDs or IDFAs).</p> <p>A customer list is one of the four types of Pinterest audiences: for more information, see <a href=\"https://help.pinterest.com/en/business/article/audience-targeting\" target=\"_blank\">Audience targeting</a> or the <a href=\"/docs/api-features/targeting-overview/\" target=\"_blank\">Audiences</a> section of the ads management guide.<p/> <p><b>Please review our <u><a href=\"https://help.pinterest.com/en/business/article/audience-targeting#section-13341\" target=\"_blank\">requirements</a></u> for what type of information is allowed when uploading a customer list.</b></p> <p>When you create a customer list, the system scans the list for existing Pinterest accounts; the list must include at least 100 Pinterest accounts. Your original list will be deleted when the matching process is complete. The filtered list – containing only the Pinterest accounts that were included in your starting list – is what will be used to create the audience.</p> <p>To use your customer list after creating it, convert it into a customer list audience by passing the `CUSTOMER_LIST` audience type at the <a href=\"https://developer.pinterest.com/docs/api/v5/audiences-create\" target=\"blank\">create audience endpoint</a>.</p>
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_request Parameters to get Customer lists info
+  # Create a customer list from your records (hashed or plain-text email addresses, or hashed MAIDs or IDFAs).  A customer list is one of the four types of Pinterest audiences: for more information, see [Audience targeting](https://help.pinterest.com/en/business/article/audience-targeting) or the [Audiences](/docs/api-features/targeting-overview/) section of the ads management guide.  **Please review our [requirements](https://help.pinterest.com/en/business/article/audience-targeting#section-13341) for what type of information is allowed when uploading a customer list.**   When you create a customer list, the system scans the list for existing Pinterest accounts; the list must include at least 100 Pinterest accounts. Your original list will be deleted when the matching process is complete. The filtered list – containing only the Pinterest accounts that were included in your starting list – is what will be used to create the audience.   To use your customer list after creating it, convert it into a customer list audience by passing the `CUSTOMER_LIST` audience type at the [create audience endpoint](https://developer.pinterest.com/docs/api/v5/audiences-create).
+  # @param ad_account_id 
+  # @param customer_list_create 
   # @param [Hash] opts the optional parameters
   # @return [CustomerList]
   describe 'customer_lists_create test' do
@@ -48,8 +48,8 @@ describe 'CustomerListsApi' do
   # unit tests for customer_lists_get
   # Get customer list
   # Gets a specific customer list given the customer list ID.
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_id Unique identifier of a customer list
+  # @param ad_account_id 
+  # @param customer_list_id Customer list ID.
   # @param [Hash] opts the optional parameters
   # @return [CustomerList]
   describe 'customer_lists_get test' do
@@ -60,12 +60,13 @@ describe 'CustomerListsApi' do
 
   # unit tests for customer_lists_list
   # Get customer lists
-  # <p>Get a set of customer lists including id and name based on the filters provided.</p> <p>(Customer lists are a type of audience.) For more information, see <a href=\"https://help.pinterest.com/en/business/article/audience-targeting\" target=\"_blank\">Audience targeting</a>  or the <a href=\"/docs/api-features/targeting-overview/\" target=\"_blank\">Audiences</a> section of the ads management guide.</p>
-  # @param ad_account_id Unique identifier of an ad account.
+  # Get a set of customer lists including id and name based on the filters provided.  (Customer lists are a type of audience.) For more information, see [Audience targeting](https://help.pinterest.com/en/business/article/audience-targeting) or the [Audiences](/docs/api-features/targeting-overview/) section of the ads management guide.
+  # @param ad_account_id 
   # @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
+  # @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 [Boolean] :exclude_nca When true, excludes customer lists uploaded for new customer acquisition (expanded matching) from the result. Defaults to false (include all).
   # @return [CustomerListsList200Response]
   describe 'customer_lists_list test' do
     it 'should work' do
@@ -75,10 +76,10 @@ describe 'CustomerListsApi' do
 
   # unit tests for customer_lists_update
   # Update customer list
-  # <p>Append or remove records to/from an existing customer list. (A customer list is one of the four types of Pinterest audiences.)</p> <p>When you add records to an existing customer list, the system scans the additions for existing Pinterest accounts; those are the records that will be added to your “CUSTOMER_LIST” audience. Your original list of records to add will be deleted when the matching process is complete.</p> <p>For more information, see <a href=\"https://help.pinterest.com/en/business/article/audience-targeting\" target=\"_blank\">Audience targeting</a> or the <a href=\"/docs/api-features/targeting-overview/\" target=\"_blank\">Audiences</a> section of the ads management guide.</p>
-  # @param ad_account_id Unique identifier of an ad account.
-  # @param customer_list_id Unique identifier of a customer list
-  # @param customer_list_update_request 
+  # Append or remove records to/from an existing customer list. (A customer list is one of the four types of Pinterest audiences.)  When you add records to an existing customer list, the system scans the additions for existing Pinterest accounts; those are the records that will be added to your \"CUSTOMER_LIST\" audience. Your original list of records to add will be deleted when the matching process is complete.  For more information, see [Audience targeting](https://help.pinterest.com/en/business/article/audience-targeting) or the [Audiences](/docs/api-features/targeting-overview/) section of the ads management guide.
+  # @param ad_account_id 
+  # @param customer_list_id Customer list ID.
+  # @param customer_list_update_with_required_body 
   # @param [Hash] opts the optional parameters
   # @return [CustomerList]
   describe 'customer_lists_update test' do

data/spec/api/customer_segment_api_spec.rb

@@ -0,0 +1,78 @@
+=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::CustomerSegmentApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'CustomerSegmentApi' do
+  before do
+    # run before each test
+    @api_instance = PinterestSdkClient::CustomerSegmentApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of CustomerSegmentApi' do
+    it 'should create an instance of CustomerSegmentApi' do
+      expect(@api_instance).to be_instance_of(PinterestSdkClient::CustomerSegmentApi)
+    end
+  end
+
+  # unit tests for customer_segment_create
+  # Create customer segments
+  # Customer segments allow advertisers to define existing customers for Pinterest Performance+ campaigns. Customer segments are made up of audience lists.
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param customer_segment_create 
+  # @param [Hash] opts the optional parameters
+  # @return [CustomerSegment]
+  describe 'customer_segment_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 customer_segment_list
+  # List customer segments
+  # Get a list of the customer segments in the specified `ad_account_id`.
+  # @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 [Boolean] :include_sizing Include audience sizing in result or not
+  # @option opts [String] :search_query Search query. Can contain pin description keywords or comma-separated pin IDs.
+  # @return [CustomerSegmentList200Response]
+  describe 'customer_segment_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 customer_segment_update
+  # Update customer segments
+  # Update the customer segment given advertiser ID and customer segment ID
+  # @param ad_account_id Unique identifier of an ad account.
+  # @param customer_segment_update_request_update_with_required_body 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'customer_segment_update 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/integrations_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -37,7 +37,7 @@ describe 'IntegrationsApi' do
   # Delete commerce integration metadata for the given external business ID. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
   # @param external_business_id External business ID for the integration.
   # @param [Hash] opts the optional parameters
-  # @return [nil]
+  # @return [IntegrationMetadata]
   describe 'integrations_commerce_del test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -60,7 +60,7 @@ describe 'IntegrationsApi' do
   # Update commerce integration
   # Update commerce integration metadata for the given external business ID. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
   # @param external_business_id External business ID for the integration.
-  # @param integration_request_patch Parameters to get create/update the Integration Metadata
+  # @param integration_metadata_update 
   # @param [Hash] opts the optional parameters
   # @return [IntegrationMetadata]
   describe 'integrations_commerce_patch test' do
@@ -72,7 +72,7 @@ describe 'IntegrationsApi' do
   # unit tests for integrations_commerce_post
   # Create commerce integration
   # Create commerce integration metadata to link an external business ID with a Pinterest merchant & ad account. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
-  # @param integration_request Parameters to get create/update the Integration Metadata
+  # @param integration_metadata_create 
   # @param [Hash] opts the optional parameters
   # @return [IntegrationMetadata]
   describe 'integrations_commerce_post test' do
@@ -84,7 +84,7 @@ describe 'IntegrationsApi' do
   # unit tests for integrations_get_by_id
   # Get integration metadata
   # Get integration metadata by ID. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
-  # @param id Integration ID.
+  # @param id Integration record ID.
   # @param [Hash] opts the optional parameters
   # @return [IntegrationRecord]
   describe 'integrations_get_by_id test' do
@@ -98,7 +98,7 @@ describe 'IntegrationsApi' do
   # Get integration metadata list. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
   # @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/reference/pagination/'>Pagination</a> for more information.
+  # @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 [IntegrationsGetList200Response]
   describe 'integrations_get_list test' do
     it 'should work' do
@@ -109,7 +109,7 @@ describe 'IntegrationsApi' do
   # unit tests for integrations_logs_post
   # Receives batched logs from integration applications.
   # This endpoint receives batched logs from integration applications on partner platforms. Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
-  # @param integration_logs_request Ingest log information from external integration application.
+  # @param integration_logs_request_create 
   # @param [Hash] opts the optional parameters
   # @return [IntegrationLogsSuccessResponse]
   describe 'integrations_logs_post test' do

data/spec/api/keywords_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -34,7 +34,7 @@ describe 'KeywordsApi' do
 
   # unit tests for country_keywords_metrics_get
   # Get country's keyword metrics
-  # See keyword metrics for a specified country, aggregated across all of Pinterest. (Definitions are available from the \"Get delivery metrics definitions\" <a href=\"/docs/api/v5/#operation/delivery_metrics/get\">API endpoint</a>).
+  #   See keyword metrics for a specified country, aggregated across all of Pinterest.   (Definitions are available from the \"Get delivery metrics definitions\"   [API endpoint](/docs/api/v5/#operation/delivery_metrics/get)).
   # @param ad_account_id Unique identifier of an ad account.
   # @param country_code Two letter country code (ISO 3166-1 alpha-2)
   # @param keywords Comma-separated keywords
@@ -48,11 +48,11 @@ describe 'KeywordsApi' do
 
   # unit tests for keywords_create
   # Create keywords
-  # <p>Create keywords for following entity types(advertiser, campaign, ad group or ad).</p> <p>For more information, see <a target=\"_blank\" href=\"https://help.pinterest.com/en/business/article/keyword-targeting\">Keyword targeting</a>.</p> <p><b>Notes:</b></p> <ul style=\"list-style-type: square;\"> <li>Advertisers and campaigns can only be assigned keywords with excluding ('_NEGATIVE').</li> <li>All keyword match types are available for ad groups.</li> </ul> <p>For more information on match types, see <a  target=\"_blank\" href=\"/docs/api-features/targeting-overview/\">match type enums</a>.</p> <p><b>Returns:</b></p> <ul style=\"list-style-type: square;\"> <li><p>A successful call returns an object containing an array of new keyword objects and an empty "errors" object array.</p></li> <li><p>An unsuccessful call returns an empty keywords array, and, instead, inserts the entire object with nulled/negated properties into the "errors" object array:</p> <pre class=\"last literal-block\"> { \"keywords\": [], \"errors\": [ { \"data\": { \"archived\": null, \"match_type\": \"EXACT\", \"parent_type\": null, \"value\": \"foobar\", \"parent_id\": null, \"type\": \"keyword\", \"id\": null }, \"error_messages\": [ \"Advertisers and Campaigns only accept excluded targeting attributes.\" ] } } </pre></li> </ul> <p><b>Rate limit</b>: <a href=\"/docs/reference/rate-limits/\">WRITE</a>.</p>
+  #   Create keywords for the following entity types (advertiser, campaign, ad group, or ad). For more information, see [Keyword targeting](https://help.pinterest.com/en/business/article/keyword-targeting).    **Notes:**   - Advertisers and campaigns can only be assigned keywords with excluding (`_NEGATIVE`).   - All keyword match types are available for ad groups.    For more information on match types, see [match type enums](/docs/api-features/targeting-overview/).    **Returns:**   - A successful call returns an object containing an array of new keyword objects and an empty `errors` object array.   - An unsuccessful call returns an empty keywords array, and instead, inserts the entire object with nulled/negated properties into the `errors` object array:     ```json     {       \"keywords\": [],       \"errors\": [         {           \"data\": {             \"archived\": null,             \"match_type\": \"EXACT\",             \"parent_type\": null,             \"value\": \"foobar\",             \"parent_id\": null,             \"type\": \"keyword\",             \"id\": null           },           \"error_messages\": [             \"Advertisers and Campaigns only accept excluded targeting attributes.\"           ]         }       ]     }
   # @param ad_account_id Unique identifier of an ad account.
-  # @param keywords_request 
+  # @param keywords_create 
   # @param [Hash] opts the optional parameters
-  # @return [KeywordsResponse]
+  # @return [Keywords]
   describe 'keywords_create test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -61,15 +61,15 @@ describe 'KeywordsApi' do
 
   # unit tests for keywords_get
   # Get keywords
-  # <p>Get a list of keywords based on the filters provided. If no filter is provided, it will default to the ad_account_id filter, which means it will only return keywords that specifically have parent_id set to the ad_account_id. Note: Keywords can have ad_account_ids, campaign_ids, and ad_group_ids set as their parent_ids. Keywords created through Ads Manager will have their parent_id set to an ad_group_id, not ad_account_id.</p> <p>For more information, see <a target=\"_blank\" href=\"https://help.pinterest.com/en/business/article/keyword-targeting\">Keyword targeting</a>.</p> <p><b>Notes:</b></p> <ul style=\"list-style-type: square;\"> <li>Advertisers and campaigns can only be assigned keywords with excluding ('_NEGATIVE').</li> <li>All keyword match types are available for ad groups.</li> </ul> <p>For more information on match types, see <a target=\"_blank\" href=\"/docs/api-features/targeting-overview/\">match type enums</a>.</p> <p><b>Returns:</b></p> <ul style=\"list-style-type: square;\"> <li><p>A successful call returns an object containing an array of new keyword objects and an empty "errors" object array.</p></li> <li><p>An unsuccessful call returns an empty keywords array, and, instead, inserts the entire object with nulled/negated properties into the "errors" object array:</p> <pre class=\"last literal-block\"> { \"keywords\": [], \"errors\": [ { \"data\": { \"archived\": null, \"match_type\": \"EXACT\", \"parent_type\": null, \"value\": \"foobar\", \"parent_id\": null, \"type\": \"keyword\", \"id\": null }, \"error_messages\": [ \"Advertisers and Campaigns only accept excluded targeting attributes.\" ] } } </pre></li> </ul>
+  #     Get a list of keywords based on the filters provided. If no filter is provided, it will default to the `ad_account_id` filter, which means it will only return keywords that specifically have `parent_id` set to the `ad_account_id`. Note: Keywords can have `ad_account_ids`, `campaign_ids`, and `ad_group_ids` set as their `parent_ids`. Keywords created through Ads Manager will have their `parent_id` set to an `ad_group_id`, not `ad_account_id`.      For more information, see [Keyword targeting](https://help.pinterest.com/en/business/article/keyword-targeting).      **Notes:**     - Advertisers and campaigns can only be assigned keywords with excluding (`_NEGATIVE`).     - All keyword match types are available for ad groups.      For more information on match types, see [match type enums](/docs/api-features/targeting-overview/).      **Returns:**     - A successful call returns an object containing an array of new keyword objects and an empty `errors` object array.     - An unsuccessful call returns an empty keywords array, and instead, inserts the entire object with nulled/negated properties into the `errors` object array:       ```json       {         \"keywords\": [],         \"errors\": [           {             \"data\": {               \"archived\": null,               \"match_type\": \"EXACT\",               \"parent_type\": null,               \"value\": \"foobar\",               \"parent_id\": null,               \"type\": \"keyword\",               \"id\": null             },             \"error_messages\": [               \"Advertisers and Campaigns only accept excluded targeting attributes.\"             ]           }         ]       }
   # @param ad_account_id Unique identifier of an ad account.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :campaign_id Campaign Id to use to filter the results.
   # @option opts [String] :ad_group_id Ad group Id.
   # @option opts [Array<String>] :ad_group_ids List of Ad group Ids to retrieve keywords from. This feature is currently in BETA and is not available to all users.
-  # @option opts [Array<MatchType>] :match_types Keyword &lt;a target&#x3D;\&quot;_blank\&quot; href&#x3D;\&quot;/docs/api-features/targeting-overview/\&quot;&gt;match type&lt;/a&gt;
-  # @option opts [Integer] :page_size Maximum number of items to include in a single page of the response. Default maximum of 250. See documentation on &lt;a href&#x3D;&#39;/docs/reference/pagination/&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [Array<MatchType>] :match_types Keyword [match type](/docs/api-features/targeting-overview/)
   # @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 [KeywordsGet200Response]
   describe 'keywords_get test' do
     it 'should work' do
@@ -79,11 +79,11 @@ describe 'KeywordsApi' do
 
   # unit tests for keywords_update
   # Update keywords
-  # &lt;p&gt;Update one or more keywords&#39; bid and archived fields.&lt;/p&gt; &lt;p&gt;Archiving a keyword effectively deletes it - keywords no longer receive metrics and no longer visible within the parent entity&#39;s keywords list.&lt;/p&gt;
+  #   Update one or more keywords&#39; bid and archived fields. Archiving   a keyword effectively deletes it - keywords no longer receive metrics and   are no longer visible within the parent entity&#39;s keywords list.
   # @param ad_account_id Unique identifier of an ad account.
-  # @param keyword_update_body 
+  # @param keywords_update 
   # @param [Hash] opts the optional parameters
-  # @return [KeywordsResponse]
+  # @return [Keywords]
   describe 'keywords_update test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -92,18 +92,17 @@ describe 'KeywordsApi' do
 
   # unit tests for trending_keywords_list
   # List trending keywords
-  # &lt;p&gt;Get the top trending search keywords among the Pinterest user audience.&lt;/p&gt; &lt;p&gt;Trending keywords can be used to inform ad targeting, budget strategy, and creative decisions about which products and Pins will resonate with your audience.&lt;/p&gt; &lt;p&gt;Geographic, demographic and interest-based filters are available to narrow down to the top trends among a specific audience. Multiple trend types are supported that can be used to identify newly-popular, evergreen or seasonal keywords.&lt;/p&gt; &lt;p&gt;For an interactive way to explore this data, please visit &lt;a href&#x3D;\&quot;https://trends.pinterest.com\&quot;&gt;trends.pinterest.com&lt;/a&gt;. 
-  # @param region The geographic region of interest. Only top trends within the specified region will be returned.&lt;br /&gt; The &#x60;region&#x60; parameter is formatted as ISO 3166-2 country codes delimited by &#x60;+&#x60;, corresponding to the following geographic areas: - &#x60;US&#x60; - United States - &#x60;CA&#x60; - Canada - &#x60;DE&#x60; - Germany - &#x60;FR&#x60; - France - &#x60;ES&#x60; - Spain - &#x60;IT&#x60; - Italy - &#x60;DE+AT+CH&#x60; - Germanic countries - &#x60;GB+IE&#x60; - Great Britain &amp; Ireland - &#x60;IT+ES+PT+GR+MT&#x60; - Southern Europe - &#x60;PL+RO+HU+SK+CZ&#x60; - Eastern Europe - &#x60;SE+DK+FI+NO&#x60; - Nordic countries - &#x60;NL+BE+LU&#x60; - Benelux - &#x60;AR&#x60; - Argentina - &#x60;BR&#x60; - Brazil - &#x60;CO&#x60; - Colombia - &#x60;MX&#x60; - Mexico - &#x60;MX+AR+CO+CL&#x60; - Hispanic LatAm - &#x60;AU+NZ&#x60; - Australasia
-  # @param trend_type The methodology used to rank how trendy a keyword is. - &#x60;growing&#x60; trends have high upward growth in search volume over the last quarter - &#x60;monthly&#x60; trends have high search volume in the last month - &#x60;yearly&#x60; trends have high search volume in the last year - &#x60;seasonal&#x60; trends have high upward growth in search volume over the last month and exhibit a seasonal recurring pattern (typically annual)
+  # Get the top trending search keywords among the Pinterest user audience.  Trending keywords can be used to inform ad targeting, budget strategy, and creative decisions about which products and Pins will resonate with your audience.  Geographic, demographic and interest-based filters are available to narrow down to the top trends among a specific audience. Multiple trend types are supported that can be used to identify newly-popular, evergreen or seasonal keywords.  For an interactive way to explore this data, please visit [trends.pinterest.com](https://trends.pinterest.com).
+  # @param region   The geographic region of interest. Only top trends within the specified region will be returned.    The &#x60;region&#x60; parameter is formatted as ISO 3166-2 country codes delimited by &#x60;+&#x60;, corresponding to the following geographic areas:   - &#x60;US&#x60; - United States   - &#x60;CA&#x60; - Canada   - &#x60;DE&#x60; - Germany   - &#x60;FR&#x60; - France   - &#x60;ES&#x60; - Spain   - &#x60;IT&#x60; - Italy   - &#x60;DE+AT+CH&#x60; - Germanic countries   - &#x60;GB+IE&#x60; - Great Britain &amp; Ireland   - &#x60;IT+ES+PT+GR+MT&#x60; - Southern Europe   - &#x60;PL+RO+HU+SK+CZ&#x60; - Eastern Europe   - &#x60;SE+DK+FI+NO&#x60; - Nordic countries   - &#x60;NL+BE+LU&#x60; - Benelux   - &#x60;AR&#x60; - Argentina   - &#x60;BR&#x60; - Brazil   - &#x60;CO&#x60; - Colombia   - &#x60;MX&#x60; - Mexico   - &#x60;MX+AR+CO+CL&#x60; - Hispanic LatAm   - &#x60;AU+NZ&#x60; - Australasia
+  # @param trend_type   The methodology used to rank how trendy a keyword is.   - &#x60;growing&#x60; trends have high upward growth in search volume over the last quarter   - &#x60;monthly&#x60; trends have high search volume in the last month   - &#x60;yearly&#x60; trends have high search volume in the last year   - &#x60;seasonal&#x60; trends have high upward growth in search volume over the last month and exhibit a seasonal recurring pattern (typically annual)
   # @param [Hash] opts the optional parameters
-  # @option opts [Array<String>] :interests If set, filters the results to trends associated with the specified interests.&lt;br /&gt; If unset, trends for all interests will be returned.&lt;br /&gt; The list of supported interests is: - &#x60;animals&#x60; - Animals - &#x60;architecture&#x60; - Architecture - &#x60;art&#x60; - Art - &#x60;beauty&#x60; - Beauty - &#x60;childrens_fashion&#x60; - Children&#39;s Fashion - &#x60;design&#x60; - Design - &#x60;diy_and_crafts&#x60; - DIY &amp; Crafts - &#x60;education&#x60; - Education - &#x60;electronics&#x60; - Electronics - &#x60;entertainment&#x60; - Entertainment - &#x60;event_planning&#x60; - Event Planning - &#x60;finance&#x60; - Finance - &#x60;food_and_drinks&#x60; - Food &amp; Drink - &#x60;gardening&#x60; - Gardening - &#x60;health&#x60; - Health - &#x60;home_decor&#x60; - Home Decor - &#x60;mens_fashion&#x60; - Men&#39;s Fashion - &#x60;parenting&#x60; - Parenting - &#x60;quotes&#x60; - Quotes - &#x60;sport&#x60; - Sports - &#x60;travel&#x60; - Travel - &#x60;vehicles&#x60; - Vehicles - &#x60;wedding&#x60; - Wedding - &#x60;womens_fashion&#x60; - Women&#39;s Fashion
-  # @option opts [Array<String>] :genders If set, filters the results to trends among users who identify with the specified gender(s).&lt;br /&gt; If unset, trends among all genders will be returned.&lt;br /&gt; The &#x60;unknown&#x60; group includes users with unspecified or customized gender profile settings.
-  # @option opts [Array<String>] :ages If set, filters the results to trends among users in the specified age range(s).&lt;br /&gt; If unset, trends among all age groups will be returned.
-  # @option opts [Array<String>] :include_keywords If set, filters the results to top trends which include at least one of the specified keywords.&lt;br /&gt; If unset, no keyword filtering logic is applied.
-  # @option opts [Boolean] :normalize_against_group Governs how the resulting time series data will be normalized to a [0-100] scale.&lt;br /&gt; By default (&#x60;false&#x60;), the data will be normalized independently for each keyword.  The peak search volume observation in *each* keyword&#39;s time series will be represented by the value 100.  This is ideal for analyzing when an individual keyword is expected to peak in interest.&lt;br /&gt; If set to &#x60;true&#x60;, the data will be normalized as a group.  The peak search volume observation across *all* keywords in the response will be represented by the value 100, and all other values scaled accordingly.  Use this option when you wish to compare relative search volume between multiple keywords.
+  # @option opts [Array<TrendsL1Interest>] :interests   The list of supported interests is:   - &#x60;animals&#x60; - Animals   - &#x60;architecture&#x60; - Architecture   - &#x60;art&#x60; - Art   - &#x60;beauty&#x60; - Beauty   - &#x60;childrens_fashion&#x60; - Children&#39;s Fashion   - &#x60;design&#x60; - Design   - &#x60;diy_and_crafts&#x60; - DIY &amp; Crafts   - &#x60;education&#x60; - Education   - &#x60;electronics&#x60; - Electronics   - &#x60;entertainment&#x60; - Entertainment   - &#x60;event_planning&#x60; - Event Planning   - &#x60;finance&#x60; - Finance   - &#x60;food_and_drinks&#x60; - Food &amp; Drink   - &#x60;gardening&#x60; - Gardening   - &#x60;health&#x60; - Health   - &#x60;home_decor&#x60; - Home Decor   - &#x60;mens_fashion&#x60; - Men&#39;s Fashion   - &#x60;parenting&#x60; - Parenting   - &#x60;quotes&#x60; - Quotes   - &#x60;sport&#x60; - Sports   - &#x60;travel&#x60; - Travel   - &#x60;vehicles&#x60; - Vehicles   - &#x60;wedding&#x60; - Wedding   - &#x60;womens_fashion&#x60; - Women&#39;s Fashion
+  # @option opts [Array<TrendsGenderFilter>] :genders If set, filters the results to trends among users who identify with the specified gender(s). If unset, trends among all genders will be returned. The &#x60;unknown&#x60; group includes users with unspecified or customized gender profile settings.
+  # @option opts [Array<TrendsAgeBucket>] :ages If set, filters the results to trends among users in the specified age range(s). If unset, trends among all age groups will be returned.
+  # @option opts [Array<String>] :include_keywords If set, filters the results to top trends which include at least one of the specified keywords. If unset, no keyword filtering logic is applied.
+  # @option opts [Boolean] :normalize_against_group  Governs how the resulting time series data will be normalized to a [0-100] scale.    By default (&#x60;false&#x60;), the data will be normalized independently for each keyword.  The peak search volume observation in *each* keyword&#39;s time series will be represented by the value 100.  This is ideal for analyzing when an individual keyword is expected to peak in interest.    If set to &#x60;true&#x60;, the data will be normalized as a group.  The peak search volume observation across *all* keywords in the response will be represented by the value 100, and all other values scaled accordingly.  Use this option when you wish to compare relative search volume between multiple keywords.
   # @option opts [Integer] :limit The maximum number of trending keywords that will be returned. Keywords are returned in trend-ranked order, so a &#x60;limit&#x60; of 50 will return the top 50 trends.
-  # @option opts [Boolean] :include_prediction &lt;a href&#x3D;\&quot;/docs/getting-started/using-beta-and-restricted-features/\&quot; target&#x3D;\&quot;blank\&quot; target&#x3D;\&quot;blank\&quot;&gt;Closed beta&lt;/a&gt; Including predicted weekly search volume data for the next 90 days. By default (&#x60;false&#x60;), the response will not include predicted data.
-  # @option opts [Boolean] :include_demographics &lt;a href&#x3D;\&quot;/docs/getting-started/using-beta-and-restricted-features/\&quot; target&#x3D;\&quot;blank\&quot; target&#x3D;\&quot;blank\&quot;&gt;Closed beta&lt;/a&gt; Including the age and gender distribution for each keyword. By default (&#x60;false&#x60;), the response will not include demographics data.
+  # @option opts [Boolean] :include_demographics Including the age and gender distribution for each keyword. By default (&#x60;false&#x60;), the response will not include demographics data.
   # @return [TrendingKeywordsResponse]
   describe 'trending_keywords_list test' do
     it 'should work' do

data/spec/api/labels_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -32,9 +32,23 @@ describe 'LabelsApi' do
     end
   end
 
+  # unit tests for labels_apply
+  # Apply label to entity
+  #   [Closed beta](/docs/getting-started/using-beta-and-restricted-features/)    Apply a label to one or more campaigns.   Future releases may support labels for other [entities](/docs/key-concepts/pinterest-entities/) in addition to campaigns.   Currently, you can apply **brand** and **custom** labels. Future releases will provide more options.    **Note:** You can only apply one brand label to a campaign. You can apply up to 30 custom labels to a campaign.
+  # @param ad_account_id 
+  # @param label_id Label ID.
+  # @param labeled_entities_create 
+  # @param [Hash] opts the optional parameters
+  # @return [LabeledEntities]
+  describe 'labels_apply 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 labels_create
   # Create labels
-  # <p> <a href=\"/docs/getting-started/using-beta-and-restricted-features/\" target=\"blank\" target=\"blank\">Closed beta</a> This endpoint is not available to all users. </p> <p>   Apply one or more labels to a campaign.   Currently, you can apply brand and custom labels. Future releases will provide more options.    <b>Note:</b> You can only apply one brand label to a campaign. You can apply 30 custom labels to a campaign.  </p>
+  # [Closed beta](/docs/getting-started/using-beta-and-restricted-features/)  Apply one or more labels to a campaign. Future releases may support labels for other [entities](/docs/key-concepts/pinterest-entities/). Currently, you can apply brand and custom labels. Future releases will provide more options.  **Note:** You can only apply one brand label to a campaign. You can apply 30 custom labels to a campaign.
   # @param ad_account_id Unique identifier of an ad account.
   # @param label_create_request 
   # @param [Hash] opts the optional parameters
@@ -47,15 +61,15 @@ describe 'LabelsApi' do
 
   # unit tests for labels_list
   # List labels
-  # <p>   <a href=\"/docs/getting-started/using-beta-and-restricted-features/\" target=\"blank\" target=\"blank\">Closed beta</a>   This endpoint is not available to all users. </p> <p>   See a list of labels for assets that your account owns, and filter the list by different criteria. </p>
+  # [Closed beta](/docs/getting-started/using-beta-and-restricted-features/)  See a list of labels for assets that your account owns, and filter the list by different criteria. If no filter is provided, it will default to labels associated with the ad account id.
   # @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>] :label_ids List of Label Ids to use to filter the results.
-  # @option opts [Array<String>] :entity_statuses Label entity status
-  # @option opts [Array<String>] :label_types Label type.
-  # @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/reference/pagination/&#39;&gt;Pagination&lt;/a&gt; for more information.
+  # @option opts [Array<QueryLabelEntityStatusesItems>] :entity_statuses Label entity status
+  # @option opts [Array<QueryLabelTypesItems>] :label_types Label type.
   # @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 [LabelsList200Response]
   describe 'labels_list test' do
     it 'should work' do
@@ -63,9 +77,23 @@ describe 'LabelsApi' do
     end
   end
 
+  # unit tests for labels_remove
+  # Remove label from entities
+  #   [Closed beta](/docs/getting-started/using-beta-and-restricted-features/)    Remove a label from one or more entities.
+  # @param ad_account_id 
+  # @param label_id Label ID.
+  # @param labeled_entities_create 
+  # @param [Hash] opts the optional parameters
+  # @return [LabeledEntities]
+  describe 'labels_remove 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 labels_update
   # Update labels
-  # &lt;p&gt;   &lt;a href&#x3D;\&quot;/docs/getting-started/using-beta-and-restricted-features/\&quot; target&#x3D;\&quot;blank\&quot; target&#x3D;\&quot;blank\&quot;&gt;Closed beta&lt;/a&gt;   This endpoint is not available to all users. &lt;/p&gt; &lt;p&gt;   Change the properties of one or more labels. &lt;/p&gt;
+  # [Closed beta](/docs/getting-started/using-beta-and-restricted-features/)  Change the properties of one or more labels.
   # @param ad_account_id Unique identifier of an ad account.
   # @param label_update_request 
   # @param [Hash] opts the optional parameters

data/spec/api/lead_ads_api_spec.rb

@@ -3,10 +3,10 @@
 
 #Pinterest's REST API
 
-The version of the OpenAPI document: 5.23.0
+The version of the OpenAPI document: 5.28.0
 Contact: blah+oapicf@cliffano.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.18.0
+Generator version: 7.24.0
 
 =end
 
@@ -38,7 +38,7 @@ describe 'LeadAdsApi' do
   # @param ad_account_id Unique identifier of an ad account.
   # @param subscription_id Unique identifier of a subscription.
   # @param [Hash] opts the optional parameters
-  # @return [nil]
+  # @return [LeadSubscription]
   describe 'ad_accounts_subscriptions_del_by_id test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/