late-sdk 0.0.716 → 0.0.718

data/docs/AdInsightsApi.md

@@ -11,6 +11,8 @@ All URIs are relative to *https://zernio.com/api*
 | [**get_ad_insights_report**](AdInsightsApi.md#get_ad_insights_report) | **GET** /v1/ads/insights/reports/{reportRunId} | Poll an async insights report run |
 | [**get_ads_search_terms**](AdInsightsApi.md#get_ads_search_terms) | **GET** /v1/ads/search-terms | Google Ads search terms report |
 | [**get_campaign_analytics**](AdInsightsApi.md#get_campaign_analytics) | **GET** /v1/ads/campaigns/{campaignId}/analytics | Get campaign analytics |
+| [**list_local_services_lead_conversations**](AdInsightsApi.md#list_local_services_lead_conversations) | **GET** /v1/ads/local-services/leads/{leadId}/conversations | Conversations of a Local Services lead |
+| [**list_local_services_leads**](AdInsightsApi.md#list_local_services_leads) | **GET** /v1/ads/local-services/leads | Google Local Services Ads leads |
 | [**query_ad_insights**](AdInsightsApi.md#query_ad_insights) | **GET** /v1/ads/insights | Flexible live insights query |
 
 
@@ -537,6 +539,168 @@ end
 - **Accept**: application/json
 
 
+## list_local_services_lead_conversations
+
+> <ListLocalServicesLeadConversations200Response> list_local_services_lead_conversations(lead_id, account_id, opts)
+
+Conversations of a Local Services lead
+
+Conversation entries of one Local Services lead: phone calls (duration, recording URL) and messages (text, attachment URLs), oldest first. Read live from `local_services_lead_conversation`, always scoped to a single lead. Call-recording URLs require read access on the Google Ads account. Draws on the shared Google Ads operations budget.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AdInsightsApi.new
+lead_id = 'lead_id_example' # String | Numeric lead id from /v1/ads/local-services/leads.
+account_id = 'account_id_example' # String | Google ads SocialAccount id.
+opts = {
+  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  page_token: 'page_token_example' # String | Cursor from paging.nextPageToken of the previous page.
+}
+
+begin
+  # Conversations of a Local Services lead
+  result = api_instance.list_local_services_lead_conversations(lead_id, account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdInsightsApi->list_local_services_lead_conversations: #{e}"
+end
+```
+
+#### Using the list_local_services_lead_conversations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListLocalServicesLeadConversations200Response>, Integer, Hash)> list_local_services_lead_conversations_with_http_info(lead_id, account_id, opts)
+
+```ruby
+begin
+  # Conversations of a Local Services lead
+  data, status_code, headers = api_instance.list_local_services_lead_conversations_with_http_info(lead_id, account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListLocalServicesLeadConversations200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdInsightsApi->list_local_services_lead_conversations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **lead_id** | **String** | Numeric lead id from /v1/ads/local-services/leads. |  |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account&#39;s connected customer. | [optional] |
+| **page_token** | **String** | Cursor from paging.nextPageToken of the previous page. | [optional] |
+
+### Return type
+
+[**ListLocalServicesLeadConversations200Response**](ListLocalServicesLeadConversations200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_local_services_leads
+
+> <ListLocalServicesLeads200Response> list_local_services_leads(account_id, opts)
+
+Google Local Services Ads leads
+
+Leads generated by Local Services Ads (phone calls, messages, bookings), read live from Google's `local_services_lead` resource, newest first. No persistence: Google is the source of truth and lead/credit statuses keep changing server-side. Google never returns healthcare-category leads, and `WIPED_OUT` leads arrive with contact erased (`contact` is null). Draws on the shared Google Ads operations budget.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AdInsightsApi.new
+account_id = 'account_id_example' # String | Google ads SocialAccount id.
+opts = {
+  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  from_date: Date.parse('2013-10-20'), # Date | Leads created at/after this day.
+  to_date: Date.parse('2013-10-20'), # Date | Leads created at/before this day.
+  lead_type: 'PHONE_CALL', # String | 
+  lead_status: 'lead_status_example', # String | Google LocalServicesLeadStatus enum value (e.g. NEW, BOOKED, WIPED_OUT).
+  charged_only: true, # Boolean | true = only leads Google charged for.
+  page_token: 'page_token_example' # String | Cursor from paging.nextPageToken of the previous page.
+}
+
+begin
+  # Google Local Services Ads leads
+  result = api_instance.list_local_services_leads(account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdInsightsApi->list_local_services_leads: #{e}"
+end
+```
+
+#### Using the list_local_services_leads_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListLocalServicesLeads200Response>, Integer, Hash)> list_local_services_leads_with_http_info(account_id, opts)
+
+```ruby
+begin
+  # Google Local Services Ads leads
+  data, status_code, headers = api_instance.list_local_services_leads_with_http_info(account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListLocalServicesLeads200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdInsightsApi->list_local_services_leads_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account&#39;s connected customer. | [optional] |
+| **from_date** | **Date** | Leads created at/after this day. | [optional] |
+| **to_date** | **Date** | Leads created at/before this day. | [optional] |
+| **lead_type** | **String** |  | [optional] |
+| **lead_status** | **String** | Google LocalServicesLeadStatus enum value (e.g. NEW, BOOKED, WIPED_OUT). | [optional] |
+| **charged_only** | **Boolean** | true &#x3D; only leads Google charged for. | [optional] |
+| **page_token** | **String** | Cursor from paging.nextPageToken of the previous page. | [optional] |
+
+### Return type
+
+[**ListLocalServicesLeads200Response**](ListLocalServicesLeads200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## query_ad_insights
 
 > <QueryAdInsights200Response> query_ad_insights(account_id, opts)

data/docs/AdMetrics.md

@@ -14,7 +14,7 @@
 | **engagement** | **Integer** |  | [optional] |
 | **conversions** | **Float** | Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired. | [optional] |
 | **cost_per_conversion** | **Float** | Derived spend / conversions in the same currency as spend. 0 when conversions is 0. | [optional] |
-| **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
+| **actions** | **Hash<String, Integer>** | Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them. | [optional] |
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
 | **purchase_value** | **Float** | Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only. | [optional] |
 | **roas** | **Float** | Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level. | [optional] |

data/docs/AdTargetingApi.md

@@ -295,7 +295,7 @@ end
 
 Search targeting options
 
-Resolve a human-readable query into the platform's opaque targeting ids used in the `TargetingSpec` (`countries`/`regions`/`cities`/`zips`/`metros` geo keys, and `interests`/`behaviors` entity ids) on `POST /v1/ads/create`, `POST /v1/ads/targeting/reach-estimate`, and `saved_targeting` audiences.  The `dimension` param selects what is searched, `geo` (locations, further scoped by `geoType`), `interest`, `behavior`, or `income`. Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only). Results are normalized across platforms into a single shape, so the same client code consumes Meta, TikTok, LinkedIn, X, Pinterest, and Google results.  TikTok geo searches return every matching level in one list (`type` is `country`, `region`, `city`, `district`, or `metro` for DMA areas) — `geoType` is not applied. Results are scoped to the advertiser's targetable markets, and every id is usable in `regions`/`cities`/`metros` keys on `POST /v1/ads/create`.  For geo queries, `q` should contain only the locality name (e.g. `\"Amsterdam\"`, not `\"Amsterdam, NL\"`). Use `countryCode` to disambiguate. 
+Resolve a human-readable query into the platform's opaque targeting ids used in the `TargetingSpec` (`countries`/`regions`/`cities`/`zips`/`metros` geo keys, and `interests`/`behaviors` entity ids) on `POST /v1/ads/create`, `POST /v1/ads/targeting/reach-estimate`, and `saved_targeting` audiences.  The `dimension` param selects what is searched, `geo` (locations, further scoped by `geoType`), `interest`, `behavior`, or `income`. Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only). Results are normalized across platforms into a single shape, so the same client code consumes Meta, TikTok, LinkedIn, X, Pinterest, and Google results.  TikTok geo searches return every matching level in one list (`type` is `country`, `region`, `city`, `district`, or `metro` for DMA areas) — `geoType` is not applied. Results are scoped to the advertiser's targetable markets, and every id is usable in `regions`/`cities`/`metros` keys on `POST /v1/ads/create`.  LinkedIn geo searches also return every matching level in one list, and neither `geoType` nor `countryCode` is applied: LinkedIn's typeahead only returns a name and a URN per result, with no level or country field to filter on. Every result has `type` set to `location`, and its id is a `urn:li:geo:*` URN usable as a `regions[].key` on `POST /v1/ads/create`, `POST /v1/ads/boost` and `POST /v1/ads/targeting/reach-estimate`.  Pinterest resolves against three whole-catalog endpoints (interests, locations, regions) with no server-side query or pagination, so matching, ranking and the `limit` cutoff all happen in Zernio; the catalog is independent of any ad account and results never carry `audienceSize`. Names come back localized to the connected Pinterest account's language (there is no way to force a locale), so match against whatever language that account returns. `geoType` routes to a different catalog: `country` and `metro_area` read the locations catalog (`type` is `country` or `metro`); `region` reads the regions catalog (`type` is `region`, its id a `regions[].key` on `POST /v1/ads/create`); `all` and the default `city` merge both catalogs with honest per-entry `type`s, since Pinterest has no city-level catalog and `city` is an alias for `all`, not a literal city search. `zip`, `subcity`, `neighborhood`, `place` and `geo_market` return a 400: Pinterest exposes no postal-code catalog, pass postal codes directly as `targeting.zips: [{ key }]` on `POST /v1/ads/create`.  For geo queries, `q` should contain only the locality name (e.g. `\"Amsterdam\"`, not `\"Amsterdam, NL\"`). Use `countryCode` to disambiguate. 
 
 ### Examples
 
@@ -313,7 +313,7 @@ account_id = 'account_id_example' # String | Social account ID (a connected acco
 q = 'q_example' # String | Search query. For geo, the locality name only (no region/country suffix).
 opts = {
   dimension: 'geo', # String | What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options. Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
-  geo_type: 'country', # String | Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`.
+  geo_type: 'all', # String | Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
   country_code: 'country_code_example', # String | ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
   limit: 56 # Integer | Maximum results to return.
 }
@@ -352,7 +352,7 @@ end
 | **account_id** | **String** | Social account ID (a connected account on the target ad platform). |  |
 | **q** | **String** | Search query. For geo, the locality name only (no region/country suffix). |  |
 | **dimension** | **String** | What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options. Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias. | [optional][default to 'interest'] |
-| **geo_type** | **String** | Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`. | [optional][default to 'city'] |
+| **geo_type** | **String** | Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`. | [optional][default to 'city'] |
 | **country_code** | **String** | ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search. | [optional] |
 | **limit** | **Integer** | Maximum results to return. | [optional][default to 25] |
 

data/docs/AdTreeCampaign.md

@@ -23,7 +23,7 @@
 | **platform_ad_account_name** | **String** | Human-readable advertiser/account name from the platform. Refreshed on every sync. | [optional] |
 | **account_id** | **String** |  | [optional] |
 | **profile_id** | **String** |  | [optional] |
-| **advertising_channel_type** | **String** | Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms. | [optional] |
+| **advertising_channel_type** | **String** | Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms. | [optional] |
 | **platform_objective** | **String** | Raw Meta campaign objective (e.g. OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_TRAFFIC) | [optional] |
 | **optimization_goal** | **String** | Optimization goal shared across ad sets, or comma-separated values when ad sets differ. Meta: e.g. OFFSITE_CONVERSIONS, VALUE, LEAD_GENERATION. LinkedIn: the campaign optimizationTargetType (e.g. MAX_CLICK, MAX_IMPRESSION, NONE); `NONE` with a manual costType is a campaign LinkedIn will not deliver. | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |

data/docs/AddBroadcastRecipientsRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **contact_ids** | **Array<String>** | Specific contact IDs to add | [optional] |
+| **contact_ids** | **Array<String>** | Specific contact IDs to add. Zernio contact ids (24-character hex), as returned by the list-contacts endpoint. A platform identifier such as a WhatsApp wa_id is rejected with 400; use phones for raw numbers. | [optional] |
 | **phones** | **Array<String>** | Raw phone numbers (auto-creates contacts). Useful for WhatsApp/Telegram manual entry | [optional] |
 | **use_segment** | **Boolean** | Auto-populate from broadcast segment filters | [optional] |
 

data/docs/AnalyticsListResponsePostsInner.md

@@ -18,7 +18,7 @@
 | **profile_id** | **String** |  | [optional] |
 | **thumbnail_url** | **String** |  | [optional] |
 | **media_type** | **String** |  | [optional] |
-| **media_items** | [**Array<AnalyticsSinglePostResponseMediaItemsInner>**](AnalyticsSinglePostResponseMediaItemsInner.md) | All media items for this post. Carousel posts contain one entry per slide. | [optional] |
+| **media_items** | [**Array<AnalyticsListResponsePostsInnerMediaItemsInner>**](AnalyticsListResponsePostsInnerMediaItemsInner.md) | All media items for this post. Carousel posts contain one entry per slide. | [optional] |
 
 ## Example
 

data/docs/AnalyticsListResponsePostsInnerMediaItemsInner.md

@@ -0,0 +1,24 @@
+# Zernio::AnalyticsListResponsePostsInnerMediaItemsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** |  | [optional] |
+| **url** | **String** | Direct URL to the media | [optional] |
+| **thumbnail** | **String** | Thumbnail URL (same as url for images) | [optional] |
+| **alt_text** | **String** | Accessibility alt text set on the media, when present. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AnalyticsListResponsePostsInnerMediaItemsInner.new(
+  type: null,
+  url: null,
+  thumbnail: null,
+  alt_text: null
+)
+```
+

data/docs/AnalyticsSinglePostResponseMediaItemsInner.md

@@ -5,9 +5,11 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **type** | **String** |  | [optional] |
-| **url** | **String** | Direct URL to the media | [optional] |
-| **thumbnail** | **String** | Thumbnail URL (same as url for images) | [optional] |
+| **url** | **String** | 'Direct URL to the media file. Null when the platform withholds it: check mediaStatus before downloading. Instagram omits the video file for Reels it flags as containing copyrighted material (its docs name audio as the usual cause), so type stays \"video\" while the file is permanently unreachable.' | [optional] |
+| **thumbnail** | **String** | Thumbnail URL (same as url for images). Still present when url is null. | [optional] |
 | **alt_text** | **String** | Accessibility alt text set on the media, when present. | [optional] |
+| **media_status** | **String** | unavailable means the media file could not be retrieved (url is null or, for LinkedIn videos, a cover image standing in for the file). available or absent means the file is available at url (older synced items omit the field). | [optional] |
+| **unavailable_reason** | **String** | Why the file is missing. platform_withheld means the platform declined to return it and retrying will not help. | [optional] |
 
 ## Example
 
@@ -18,7 +20,9 @@ instance = Zernio::AnalyticsSinglePostResponseMediaItemsInner.new(
   type: null,
   url: null,
   thumbnail: null,
-  alt_text: null
+  alt_text: null,
+  media_status: null,
+  unavailable_reason: null
 )
 ```
 

data/docs/BillingSnapshot.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **billing_system** | **String** |  | [optional] |
 | **plan** | [**BillingSnapshotPlan**](BillingSnapshotPlan.md) |  | [optional] |
+| **shopify_shop_domain** | **String** | myshopify.com domain owning the subscription; present only when billingSystem is shopify. | [optional] |
 | **period** | [**BillingSnapshotPeriod**](BillingSnapshotPeriod.md) |  | [optional] |
 | **balance** | [**BillingSnapshotBalance**](BillingSnapshotBalance.md) |  | [optional] |
 | **caps** | [**BillingSnapshotCaps**](BillingSnapshotCaps.md) |  | [optional] |
@@ -20,6 +21,7 @@ require 'zernio-sdk'
 instance = Zernio::BillingSnapshot.new(
   billing_system: null,
   plan: null,
+  shopify_shop_domain: null,
   period: null,
   balance: null,
   caps: null,

data/docs/BillingSnapshotPlan.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **name** | **String** |  | [optional] |
 | **is_usage_based** | **Boolean** |  | [optional] |
+| **is_paid** | **Boolean** | True when the key belongs to an account with an active paid billing relationship (Stripe subscription, Metronome enrollment, or Shopify-managed billing). | [optional] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'zernio-sdk'
 
 instance = Zernio::BillingSnapshotPlan.new(
   name: null,
-  is_usage_based: null
+  is_usage_based: null,
+  is_paid: null
 )
 ```
 

data/docs/Blog.md

@@ -0,0 +1,24 @@
+# Zernio::Blog
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Platform-native blog id (numeric string for Shopify). | [optional] |
+| **platform** | **String** |  | [optional] |
+| **title** | **String** |  | [optional] |
+| **handle** | **String** | URL slug of the blog. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::Blog.new(
+  id: null,
+  platform: null,
+  title: null,
+  handle: null
+)
+```
+

data/docs/BlogArticle.md

@@ -0,0 +1,44 @@
+# Zernio::BlogArticle
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Platform-native article id (numeric string for Shopify). | [optional] |
+| **blog_id** | **String** | Platform-native id of the blog the article belongs to. | [optional] |
+| **platform** | **String** |  | [optional] |
+| **title** | **String** |  | [optional] |
+| **body_html** | **String** | Article body as HTML. | [optional] |
+| **handle** | **String** | URL slug of the article. | [optional] |
+| **tags** | **Array<String>** |  | [optional] |
+| **author** | **String** | Display name of the article author. | [optional] |
+| **excerpt** | **String** | Short summary shown in blog listings. | [optional] |
+| **image** | [**BlogArticleImage**](BlogArticleImage.md) |  | [optional] |
+| **is_published** | **Boolean** | False while the article is a draft or its publish date is still in the future. | [optional] |
+| **published_at** | **Time** | When the article was (or is scheduled to be) published; null for drafts. | [optional] |
+| **created_at** | **Time** |  | [optional] |
+| **updated_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::BlogArticle.new(
+  id: null,
+  blog_id: null,
+  platform: null,
+  title: null,
+  body_html: null,
+  handle: null,
+  tags: null,
+  author: null,
+  excerpt: null,
+  image: null,
+  is_published: null,
+  published_at: null,
+  created_at: null,
+  updated_at: null
+)
+```
+

data/docs/BlogArticleImage.md

@@ -0,0 +1,20 @@
+# Zernio::BlogArticleImage
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** |  | [optional] |
+| **alt_text** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::BlogArticleImage.new(
+  url: null,
+  alt_text: null
+)
+```
+