late-sdk 0.0.596 → 0.0.598

data/lib/zernio-sdk/models/query_ad_insights200_response_paging.rb

@@ -15,13 +15,17 @@ require 'time'
 
 module Zernio
   class QueryAdInsights200ResponsePaging < ApiModelBase
-    # Cursor for the next page; null when exhausted.
+    # Meta cursor for the next page; null when exhausted.
     attr_accessor :after
 
+    # Google cursor for the next page; null when exhausted.
+    attr_accessor :next_page_token
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'after' => :'after'
+        :'after' => :'after',
+        :'next_page_token' => :'nextPageToken'
       }
     end
 
@@ -38,14 +42,16 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'after' => :'String'
+        :'after' => :'String',
+        :'next_page_token' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'after'
+        :'after',
+        :'next_page_token'
       ])
     end
 
@@ -68,6 +74,10 @@ module Zernio
       if attributes.key?(:'after')
         self.after = attributes[:'after']
       end
+
+      if attributes.key?(:'next_page_token')
+        self.next_page_token = attributes[:'next_page_token']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -90,7 +100,8 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          after == o.after
+          after == o.after &&
+          next_page_token == o.next_page_token
     end
 
     # @see the `==` method
@@ -102,7 +113,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [after].hash
+      [after, next_page_token].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/slack_platform_data.rb

@@ -0,0 +1,189 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  # Slack message settings. Posts mrkdwn text (up to 40,000 chars; Slack truncates beyond that) to the channel fixed by the connected account, with up to 10 media files per post uploaded via Slack's file API (the text becomes the caption). The target channel is chosen at connect time — one connected account per channel — so channelId is NOT accepted here (a 400 is returned); connect the desired channel via /v1/connect/slack and target its accountId. Messages over 4,000 characters cannot be edited later (Slack's edit limit is stricter than its post limit). 
+  class SlackPlatformData < ApiModelBase
+    # Parent message ts to post this message as a thread reply (e.g. \"1503435956.000247\").
+    attr_accessor :thread_ts
+
+    # Expand links in the message into preview cards. Default true.
+    attr_accessor :unfurl_links
+
+    # Expand media links into inline previews. Default true.
+    attr_accessor :unfurl_media
+
+    # Override the bot display name for this message only (requires no setup; shown with an APP badge). Does not change the app identity in the sidebar.
+    attr_accessor :username
+
+    # Override the bot avatar image URL for this message only.
+    attr_accessor :icon_url
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'thread_ts' => :'threadTs',
+        :'unfurl_links' => :'unfurlLinks',
+        :'unfurl_media' => :'unfurlMedia',
+        :'username' => :'username',
+        :'icon_url' => :'iconUrl'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'thread_ts' => :'String',
+        :'unfurl_links' => :'Boolean',
+        :'unfurl_media' => :'Boolean',
+        :'username' => :'String',
+        :'icon_url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SlackPlatformData` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SlackPlatformData`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'thread_ts')
+        self.thread_ts = attributes[:'thread_ts']
+      end
+
+      if attributes.key?(:'unfurl_links')
+        self.unfurl_links = attributes[:'unfurl_links']
+      end
+
+      if attributes.key?(:'unfurl_media')
+        self.unfurl_media = attributes[:'unfurl_media']
+      end
+
+      if attributes.key?(:'username')
+        self.username = attributes[:'username']
+      end
+
+      if attributes.key?(:'icon_url')
+        self.icon_url = attributes[:'icon_url']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          thread_ts == o.thread_ts &&
+          unfurl_links == o.unfurl_links &&
+          unfurl_media == o.unfurl_media &&
+          username == o.username &&
+          icon_url == o.icon_url
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [thread_ts, unfurl_links, unfurl_media, username, icon_url].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/models/social_account.rb

@@ -242,7 +242,7 @@ module Zernio
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @_id.nil?
       return false if @platform.nil?
-      platform_validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "discord", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads", "openaiads"])
+      platform_validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "discord", "slack", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads", "openaiads"])
       return false unless platform_validator.valid?(@platform)
       return false if @profile_id.nil?
       return false if @is_active.nil?
@@ -262,7 +262,7 @@ module Zernio
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] platform Object to be assigned
     def platform=(platform)
-      validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "discord", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads", "openaiads"])
+      validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "discord", "slack", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads", "openaiads"])
       unless validator.valid?(platform)
         fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
       end

data/lib/zernio-sdk/models/validate_post_request_platforms_inner.rb

@@ -144,7 +144,7 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @platform.nil?
-      platform_validator = EnumAttributeValidator.new('String', ["twitter", "instagram", "tiktok", "youtube", "facebook", "linkedin", "bluesky", "threads", "reddit", "pinterest", "telegram", "snapchat", "googlebusiness", "discord"])
+      platform_validator = EnumAttributeValidator.new('String', ["twitter", "instagram", "tiktok", "youtube", "facebook", "linkedin", "bluesky", "threads", "reddit", "pinterest", "telegram", "snapchat", "googlebusiness", "discord", "slack"])
       return false unless platform_validator.valid?(@platform)
       true
     end
@@ -152,7 +152,7 @@ module Zernio
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] platform Object to be assigned
     def platform=(platform)
-      validator = EnumAttributeValidator.new('String', ["twitter", "instagram", "tiktok", "youtube", "facebook", "linkedin", "bluesky", "threads", "reddit", "pinterest", "telegram", "snapchat", "googlebusiness", "discord"])
+      validator = EnumAttributeValidator.new('String', ["twitter", "instagram", "tiktok", "youtube", "facebook", "linkedin", "bluesky", "threads", "reddit", "pinterest", "telegram", "snapchat", "googlebusiness", "discord", "slack"])
       unless validator.valid?(platform)
         fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
       end

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.596'
+  VERSION = '0.0.598'
 end

data/lib/zernio-sdk.rb

@@ -413,6 +413,11 @@ require 'zernio-sdk/models/gbp_update_free_form_service_item_label'
 require 'zernio-sdk/models/generate_ad_previews200_response'
 require 'zernio-sdk/models/generate_ad_previews200_response_previews_inner'
 require 'zernio-sdk/models/generate_ad_previews_request'
+require 'zernio-sdk/models/generate_keyword_historical_metrics200_response'
+require 'zernio-sdk/models/generate_keyword_historical_metrics_request'
+require 'zernio-sdk/models/generate_keyword_ideas200_response'
+require 'zernio-sdk/models/generate_keyword_ideas200_response_paging'
+require 'zernio-sdk/models/generate_keyword_ideas_request'
 require 'zernio-sdk/models/geo_restriction'
 require 'zernio-sdk/models/get_account_health200_response'
 require 'zernio-sdk/models/get_account_health200_response_permissions'
@@ -435,6 +440,7 @@ require 'zernio-sdk/models/get_ad_set_details200_response'
 require 'zernio-sdk/models/get_ad_tracking_tags200_response'
 require 'zernio-sdk/models/get_ad_tree200_response'
 require 'zernio-sdk/models/get_ads_activity_log200_response'
+require 'zernio-sdk/models/get_ads_activity_log200_response_paging'
 require 'zernio-sdk/models/get_ads_timeline200_response'
 require 'zernio-sdk/models/get_ads_timeline200_response_rows_inner'
 require 'zernio-sdk/models/get_all_accounts_health200_response'
@@ -1192,6 +1198,7 @@ require 'zernio-sdk/models/set_whatsapp_business_username_request'
 require 'zernio-sdk/models/share_sms_registration200_response'
 require 'zernio-sdk/models/share_sms_registration_request'
 require 'zernio-sdk/models/shared_ad_account'
+require 'zernio-sdk/models/slack_platform_data'
 require 'zernio-sdk/models/snapchat_platform_data'
 require 'zernio-sdk/models/social_account'
 require 'zernio-sdk/models/social_account_profile_id'

data/openapi.yaml

@@ -4053,6 +4053,7 @@ components:
             - $ref: '#/components/schemas/RedditPlatformData'
             - $ref: '#/components/schemas/BlueskyPlatformData'
             - $ref: '#/components/schemas/DiscordPlatformData'
+            - $ref: '#/components/schemas/SlackPlatformData'
           additionalProperties: true
         status:
           type: string
@@ -5304,6 +5305,27 @@ components:
       description: |
         Discord message settings. Supports plain text (2,000 chars), rich embeds (up to 10), native polls, forum posts, threads, and announcement crossposts. Media attachments support images (JPEG, PNG, GIF, WebP), videos (MP4), and documents (up to 10 files, 25 MB each). Webhook identity (username + avatar) can be customized per-account via PATCH /v1/connect/discord or per-post via webhookUsername/webhookAvatarUrl.
 
+    SlackPlatformData:
+      type: object
+      properties:
+        threadTs:
+          type: string
+          description: 'Parent message ts to post this message as a thread reply (e.g. "1503435956.000247").'
+        unfurlLinks:
+          type: boolean
+          description: 'Expand links in the message into preview cards. Default true.'
+        unfurlMedia:
+          type: boolean
+          description: 'Expand media links into inline previews. Default true.'
+        username:
+          type: string
+          description: 'Override the bot display name for this message only (requires no setup; shown with an APP badge). Does not change the app identity in the sidebar.'
+        iconUrl:
+          type: string
+          description: 'Override the bot avatar image URL for this message only.'
+      description: |
+        Slack message settings. Posts mrkdwn text (up to 40,000 chars; Slack truncates beyond that) to the channel fixed by the connected account, with up to 10 media files per post uploaded via Slack's file API (the text becomes the caption). The target channel is chosen at connect time — one connected account per channel — so channelId is NOT accepted here (a 400 is returned); connect the desired channel via /v1/connect/slack and target its accountId. Messages over 4,000 characters cannot be edited later (Slack's edit limit is stricter than its post limit).
+
     DiscordScheduledEvent:
       type: object
       description: |
@@ -5406,7 +5428,7 @@ components:
         _id: { type: string }
         platform:
           type: string
-          enum: [tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, discord, whatsapp, linkedinads, metaads, pinterestads, tiktokads, xads, googleads, openaiads]
+          enum: [tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, discord, slack, whatsapp, linkedinads, metaads, pinterestads, tiktokads, xads, googleads, openaiads]
         profileId:
           oneOf:
             - type: string
@@ -8330,7 +8352,7 @@ paths:
                     properties:
                       platform:
                         type: string
-                        enum: [twitter, instagram, tiktok, youtube, facebook, linkedin, bluesky, threads, reddit, pinterest, telegram, snapchat, googlebusiness, discord]
+                        enum: [twitter, instagram, tiktok, youtube, facebook, linkedin, bluesky, threads, reddit, pinterest, telegram, snapchat, googlebusiness, discord, slack]
                       accountId: { type: string, description: 'Account to validate against. For twitter, resolves X Premium status to apply the 25000 character limit instead of 280.' }
                       customContent: { type: string }
                       platformSpecificData: { type: object }
@@ -12176,6 +12198,7 @@ paths:
                           - $ref: '#/components/schemas/RedditPlatformData'
                           - $ref: '#/components/schemas/BlueskyPlatformData'
                           - $ref: '#/components/schemas/DiscordPlatformData'
+                          - $ref: '#/components/schemas/SlackPlatformData'
                 scheduledFor: { type: string, format: date-time }
                 publishNow: { type: boolean, default: false }
                 isDraft:
@@ -13856,7 +13879,7 @@ paths:
           description: Filter by platform
           schema:
             type: string
-            enum: [facebook, instagram, linkedin, twitter, tiktok, youtube, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, discord, whatsapp]
+            enum: [facebook, instagram, linkedin, twitter, tiktok, youtube, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, discord, slack, whatsapp]
         - name: status
           in: query
           description: Filter by health status
@@ -14344,7 +14367,7 @@ paths:
           required: true
           schema:
             type: string
-            enum: [facebook, instagram, linkedin, twitter, tiktok, youtube, threads, reddit, pinterest, bluesky, googlebusiness, telegram, snapchat, discord, whatsapp]
+            enum: [facebook, instagram, linkedin, twitter, tiktok, youtube, threads, reddit, pinterest, bluesky, googlebusiness, telegram, snapchat, discord, slack, whatsapp]
           description: Social media platform to connect
         - name: profileId
           in: query
@@ -35203,28 +35226,136 @@ paths:
         '429': { description: Meta rate limit reached }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
+  /v1/ads/keywords/ideas:
+    post:
+      operationId: generateKeywordIdeas
+      tags: ["Ad Insights"]
+      x-platforms: ["google"]
+      summary: Generate keyword ideas (Google Keyword Planner)
+      description: |
+        Google Ads only. Runs Keyword Planner's generateKeywordIdeas from seed keywords, a seed URL,
+        or both, returning idea rows verbatim (avgMonthlySearches, competition, competitionIndex,
+        top-of-page bid micros, monthlySearchVolumes). Counters are int64s encoded as strings; bid
+        values are micros of the account currency. Omitting `countries` targets worldwide.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId]
+              properties:
+                accountId: { type: string, description: "Zernio googleads SocialAccount id." }
+                customerId: { type: string, description: "Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts." }
+                seedKeywords: { type: array, items: { type: string, maxLength: 80 }, minItems: 1, maxItems: 20, description: "Seed terms. Provide these, seedUrl, or both." }
+                seedUrl: { type: string, format: uri, description: "Landing page to mine for ideas. Provide this, seedKeywords, or both." }
+                countries: { type: array, items: { type: string, minLength: 2, maxLength: 2 }, minItems: 1, maxItems: 10, description: "ISO 3166-1 alpha-2 country codes. Omitted = worldwide." }
+                languageConstantId: { type: string, default: "1000", description: "Google languageConstant id (1000 = English)." }
+                network: { type: string, enum: [GOOGLE_SEARCH, GOOGLE_SEARCH_AND_PARTNERS], default: GOOGLE_SEARCH }
+                includeAdultKeywords: { type: boolean }
+                pageSize: { type: integer, minimum: 1, maximum: 10000 }
+                pageToken: { type: string, description: "Cursor from paging.nextPageToken of the previous page." }
+      responses:
+        '200':
+          description: Keyword idea rows (raw Keyword Planner shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  customerId: { type: string, description: "The customer the request ran against." }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw GenerateKeywordIdeaResult: text + keywordIdeaMetrics." }
+                  aggregateMetricResults: { type: [object, "null"] }
+                  paging:
+                    type: object
+                    properties:
+                      nextPageToken: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or Google rejected the request — message carries Google's error" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '429': { description: "Per-user Google Ads operations budget or the shared Google quota reached; the message says which and when it resets." }
+        '501': { description: Only supported on Google Ads }
+
+  /v1/ads/keywords/historical-metrics:
+    post:
+      operationId: generateKeywordHistoricalMetrics
+      tags: ["Ad Insights"]
+      x-platforms: ["google"]
+      summary: Historical keyword metrics (Google Keyword Planner)
+      description: |
+        Google Ads only. Runs Keyword Planner's generateKeywordHistoricalMetrics for up to 1,000
+        exact keywords: historical search volume, competition and top-of-page bid ranges, plus
+        averageCpcMicros when includeAverageCpc is set. Rows come back verbatim; counters are int64s
+        encoded as strings, bid/CPC values are micros of the account currency.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, keywords]
+              properties:
+                accountId: { type: string, description: "Zernio googleads SocialAccount id." }
+                customerId: { type: string, description: "Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts." }
+                keywords: { type: array, items: { type: string, maxLength: 80 }, minItems: 1, maxItems: 1000 }
+                countries: { type: array, items: { type: string, minLength: 2, maxLength: 2 }, minItems: 1, maxItems: 10, description: "ISO 3166-1 alpha-2 country codes. Omitted = worldwide." }
+                languageConstantId: { type: string, default: "1000", description: "Google languageConstant id (1000 = English)." }
+                network: { type: string, enum: [GOOGLE_SEARCH, GOOGLE_SEARCH_AND_PARTNERS], default: GOOGLE_SEARCH }
+                includeAdultKeywords: { type: boolean }
+                includeAverageCpc: { type: boolean, description: "Adds averageCpcMicros to each row's keywordMetrics." }
+      responses:
+        '200':
+          description: Historical metric rows (raw Keyword Planner shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  customerId: { type: string, description: "The customer the request ran against." }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw KeywordHistoricalMetricsResult: text, closeVariants, keywordMetrics." }
+                  aggregateMetricResults: { type: [object, "null"] }
+        '400': { description: "Invalid input, or Google rejected the request — message carries Google's error" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '429': { description: "Per-user Google Ads operations budget or the shared Google quota reached; the message says which and when it resets." }
+        '501': { description: Only supported on Google Ads }
+
   /v1/ads/insights:
     get:
       operationId: queryAdInsights
       tags: ["Ad Insights"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "google"]
       summary: Flexible live insights query
       description: |
-        Live, flexible insights query against Meta's Graph API. Unlike GET /v1/ads/{adId}/analytics
-        (fixed metric set, cached), this forwards caller-chosen `fields`, `breakdowns` and `filtering`
-        to any Meta insights node and returns Meta's rows verbatim.
+        Live, flexible insights query. The account's platform picks the contract:
 
-        `objectId` selects the node: an ad account, campaign, ad set or ad platform id.
-        `level` sets row granularity independently of the node.
+        **Meta (facebook/instagram)**: forwards caller-chosen `fields`, `breakdowns` and `filtering`
+        to any Meta insights node and returns Meta's rows verbatim. `objectId` (required) selects the
+        node; `level` sets row granularity. Semantic validation is Meta's: an unknown field or invalid
+        breakdown combination returns a 400 carrying Meta's message. For long ranges or agency-scale
+        accounts prefer the async variant (POST /v1/ads/insights/reports).
 
-        Semantic validation is Meta's: an unknown field or invalid breakdown combination returns a 400
-        carrying Meta's message. For long ranges or agency-scale accounts prefer the async variant
-        (POST /v1/ads/insights/reports).
+        **Google Ads (googleads)**: raw GAQL passthrough. Send any read-only GAQL SELECT via `query`
+        (campaign/keyword/search-term/geo/demographic/asset/shopping resources, `change_event`, any
+        `segments.*`) and rows come back verbatim (camelCase, counters as strings). Results are paged
+        at a fixed 10,000 rows; follow `paging.nextPageToken` with `pageToken`. `customerId` is only
+        needed when the connection has several Google Ads accounts. Semantic validation is Google's:
+        an invalid query returns a 400 carrying Google's message (note: selecting `segments.date`
+        requires a finite date filter).
       security:
         - bearerAuth: []
       parameters:
-        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-        - { name: objectId, in: query, required: true, schema: { type: string }, description: "Meta insights node: act_<n>, campaign id, ad set id or ad id." }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract." }
+        - { name: objectId, in: query, schema: { type: string }, description: "Meta only (required there): insights node — act_<n>, campaign id, ad set id or ad id." }
+        - { name: query, in: query, schema: { type: string, maxLength: 10000 }, description: "Google only (required there): the GAQL SELECT statement to run." }
+        - { name: customerId, in: query, schema: { type: string }, description: "Google only: numeric customer id (no dashes) when the connection has several Google Ads accounts." }
+        - { name: pageToken, in: query, schema: { type: string }, description: "Google only: cursor from paging.nextPageToken of the previous page." }
         - { name: level, in: query, schema: { type: string, enum: [ad, adset, campaign, account] }, description: Row granularity }
         - { name: fields, in: query, schema: { type: string }, description: "Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set." }
         - { name: breakdowns, in: query, schema: { type: string }, description: "Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform)." }
@@ -35241,24 +35372,27 @@ paths:
         - { name: after, in: query, schema: { type: string }, description: "Cursor from paging.after of the previous page." }
       responses:
         '200':
-          description: Insight rows (raw Meta shape)
+          description: Insight rows (raw platform shape)
           content:
             application/json:
               schema:
                 type: object
                 properties:
-                  objectId: { type: string }
+                  objectId: { type: string, description: "Meta responses only." }
+                  customerId: { type: string, description: "Google responses only: the customer the query ran against." }
+                  fieldMask: { type: [string, "null"], description: "Google responses only: the selected fields echoed by Google." }
                   data:
                     type: array
-                    items: { type: object, description: "Raw Meta insights row; keys are the requested Graph fields plus date_start/date_stop." }
+                    items: { type: object, description: "Raw platform row. Meta: keys are the requested Graph fields plus date_start/date_stop. Google: nested GAQL resources in camelCase, int64 counters as strings." }
                   paging:
                     type: object
                     properties:
-                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
-        '400': { description: "Invalid input, or Meta rejected the query (unknown field, invalid breakdown combo) — message carries Meta's error" }
+                      after: { type: [string, "null"], description: "Meta cursor for the next page; null when exhausted." }
+                      nextPageToken: { type: [string, "null"], description: "Google cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or the platform rejected the query (unknown field, invalid breakdown combo, malformed GAQL) — message carries the platform's error" }
         '401': { $ref: '#/components/responses/Unauthorized' }
-        '429': { description: Meta rate limit reached }
-        '501': { description: Only supported on Meta (facebook/instagram) }
+        '429': { description: "Platform rate limit reached. For Google this is the per-user operations budget or the shared quota; the message says which and when it resets." }
+        '501': { description: Only supported on Meta (facebook/instagram) and Google Ads }
 
   /v1/ads/insights/reports:
     post:

data/spec/api/ad_insights_api_spec.rb

@@ -44,6 +44,30 @@ describe 'AdInsightsApi' do
     end
   end
 
+  # unit tests for generate_keyword_historical_metrics
+  # Historical keyword metrics (Google Keyword Planner)
+  # Google Ads only. Runs Keyword Planner's generateKeywordHistoricalMetrics for up to 1,000 exact keywords: historical search volume, competition and top-of-page bid ranges, plus averageCpcMicros when includeAverageCpc is set. Rows come back verbatim; counters are int64s encoded as strings, bid/CPC values are micros of the account currency. 
+  # @param generate_keyword_historical_metrics_request 
+  # @param [Hash] opts the optional parameters
+  # @return [GenerateKeywordHistoricalMetrics200Response]
+  describe 'generate_keyword_historical_metrics 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 generate_keyword_ideas
+  # Generate keyword ideas (Google Keyword Planner)
+  # Google Ads only. Runs Keyword Planner's generateKeywordIdeas from seed keywords, a seed URL, or both, returning idea rows verbatim (avgMonthlySearches, competition, competitionIndex, top-of-page bid micros, monthlySearchVolumes). Counters are int64s encoded as strings; bid values are micros of the account currency. Omitting `countries` targets worldwide. 
+  # @param generate_keyword_ideas_request 
+  # @param [Hash] opts the optional parameters
+  # @return [GenerateKeywordIdeas200Response]
+  describe 'generate_keyword_ideas 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 get_ad_analytics
   # Get ad analytics
   # Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. 
@@ -92,10 +116,13 @@ describe 'AdInsightsApi' do
 
   # unit tests for query_ad_insights
   # Flexible live insights query
-  # Live, flexible insights query against Meta's Graph API. Unlike GET /v1/ads/{adId}/analytics (fixed metric set, cached), this forwards caller-chosen `fields`, `breakdowns` and `filtering` to any Meta insights node and returns Meta's rows verbatim.  `objectId` selects the node: an ad account, campaign, ad set or ad platform id. `level` sets row granularity independently of the node.  Semantic validation is Meta's: an unknown field or invalid breakdown combination returns a 400 carrying Meta's message. For long ranges or agency-scale accounts prefer the async variant (POST /v1/ads/insights/reports). 
-  # @param account_id Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
-  # @param object_id Meta insights node: act_<n>, campaign id, ad set id or ad id.
+  # Live, flexible insights query. The account's platform picks the contract:  **Meta (facebook/instagram)**: forwards caller-chosen `fields`, `breakdowns` and `filtering` to any Meta insights node and returns Meta's rows verbatim. `objectId` (required) selects the node; `level` sets row granularity. Semantic validation is Meta's: an unknown field or invalid breakdown combination returns a 400 carrying Meta's message. For long ranges or agency-scale accounts prefer the async variant (POST /v1/ads/insights/reports).  **Google Ads (googleads)**: raw GAQL passthrough. Send any read-only GAQL SELECT via `query` (campaign/keyword/search-term/geo/demographic/asset/shopping resources, `change_event`, any `segments.*`) and rows come back verbatim (camelCase, counters as strings). Results are paged at a fixed 10,000 rows; follow `paging.nextPageToken` with `pageToken`. `customerId` is only needed when the connection has several Google Ads accounts. Semantic validation is Google's: an invalid query returns a 400 carrying Google's message (note: selecting `segments.date` requires a finite date filter). 
+  # @param account_id Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract.
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :object_id Meta only (required there): insights node — act_<n>, campaign id, ad set id or ad id.
+  # @option opts [String] :query Google only (required there): the GAQL SELECT statement to run.
+  # @option opts [String] :customer_id Google only: numeric customer id (no dashes) when the connection has several Google Ads accounts.
+  # @option opts [String] :page_token Google only: cursor from paging.nextPageToken of the previous page.
   # @option opts [String] :level Row granularity
   # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
   # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).