zernio-sdk 0.0.781 → 0.0.783

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0758606d9249aa5531fc4d4c27c7eb0c3dd7d6c238f24ad976cfff84815a3f64'
-  data.tar.gz: 149a4f99191dc15420d969dc47edc897c269d1eeae7663982cc7a202eec8854b
+  metadata.gz: 9a0bc51395c10adcf6db858d0db9fed18d74534f47650cd085fb2a3dde269bf4
+  data.tar.gz: 681dbd28bd5cfe96bcca836e86415b2c14e62d24fb9acc1c4484bd42b2eb17b0
 SHA512:
-  metadata.gz: 823d67f0fdfe4ba9330cd500c586103d4f3e73f18fb81b9c2884697ffd955e5a276565aeedef390cfdd034e976f31cc4aaee90f35749e081e6ce0f26eb412f43
-  data.tar.gz: 1081074c28dcc6e269539214cb720d5730a907d2d0ac091d3dace3e2b17ea4c83cd515b9623a5096117a158132e9774ae3b7a42ee4c520e9f04238022d87bccb
+  metadata.gz: 411d260d794a379815491cfbec765b65cb8988fdf6542988c3d742bc3594e0b727d2a84474a6103ed48a8165c8a639f384ea43eed4ddf0cc85acc7cd4af23fb5
+  data.tar.gz: d4802dd9779762d3d62ff5f74d4144be9be0dced53587fbbd679d5db2152189d326f55217255aca105abe9cf51145d8fe52326defae438fdcf736609e2a81cbb

data/README.md

@@ -277,6 +277,7 @@ Class | Method | HTTP request | Description
 *Zernio::ConnectApi* | [**get_shopify_connect_url**](docs/ConnectApi.md#get_shopify_connect_url) | **GET** /v1/connect/shopify | Get Shopify OAuth connect URL
 *Zernio::ConnectApi* | [**get_subreddit_rules**](docs/ConnectApi.md#get_subreddit_rules) | **GET** /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules | Get subreddit rules
 *Zernio::ConnectApi* | [**get_telegram_connect_status**](docs/ConnectApi.md#get_telegram_connect_status) | **GET** /v1/connect/telegram | Generate Telegram code
+*Zernio::ConnectApi* | [**get_youtube_captions**](docs/ConnectApi.md#get_youtube_captions) | **GET** /v1/accounts/{accountId}/youtube-captions | Get a YouTube video transcript
 *Zernio::ConnectApi* | [**get_youtube_playlists**](docs/ConnectApi.md#get_youtube_playlists) | **GET** /v1/accounts/{accountId}/youtube-playlists | List YouTube playlists
 *Zernio::ConnectApi* | [**handle_o_auth_callback**](docs/ConnectApi.md#handle_o_auth_callback) | **POST** /v1/connect/{platform} | Complete OAuth callback
 *Zernio::ConnectApi* | [**initiate_telegram_connect**](docs/ConnectApi.md#initiate_telegram_connect) | **POST** /v1/connect/telegram | Connect Telegram directly
@@ -1454,6 +1455,9 @@ Class | Method | HTTP request | Description
  - [Zernio::GetYouTubeDemographics412Response](docs/GetYouTubeDemographics412Response.md)
  - [Zernio::GetYouTubeDemographics412ResponseScopeStatus](docs/GetYouTubeDemographics412ResponseScopeStatus.md)
  - [Zernio::GetYouTubeVideoRetention404Response](docs/GetYouTubeVideoRetention404Response.md)
+ - [Zernio::GetYoutubeCaptions200Response](docs/GetYoutubeCaptions200Response.md)
+ - [Zernio::GetYoutubeCaptions200ResponseAvailableTracksInner](docs/GetYoutubeCaptions200ResponseAvailableTracksInner.md)
+ - [Zernio::GetYoutubeCaptions200ResponseCuesInner](docs/GetYoutubeCaptions200ResponseCuesInner.md)
  - [Zernio::GetYoutubePlaylists200Response](docs/GetYoutubePlaylists200Response.md)
  - [Zernio::GetYoutubePlaylists200ResponsePlaylistsInner](docs/GetYoutubePlaylists200ResponsePlaylistsInner.md)
  - [Zernio::GoogleBusinessPlatformData](docs/GoogleBusinessPlatformData.md)
@@ -2204,13 +2208,19 @@ Class | Method | HTTP request | Description
  - [Zernio::UploadedOrDerivedAudience](docs/UploadedOrDerivedAudience.md)
  - [Zernio::UploadedOrDerivedAudienceCompaniesInner](docs/UploadedOrDerivedAudienceCompaniesInner.md)
  - [Zernio::UploadedOrDerivedAudienceMatchRulesInner](docs/UploadedOrDerivedAudienceMatchRulesInner.md)
+ - [Zernio::UsageAttributionGroup](docs/UsageAttributionGroup.md)
+ - [Zernio::UsageAttributionSlice](docs/UsageAttributionSlice.md)
+ - [Zernio::UsageAttributionSliceByProduct](docs/UsageAttributionSliceByProduct.md)
  - [Zernio::UsageMetering](docs/UsageMetering.md)
+ - [Zernio::UsageMeteringAttribution](docs/UsageMeteringAttribution.md)
  - [Zernio::UsageMeteringCallUsage](docs/UsageMeteringCallUsage.md)
  - [Zernio::UsageMeteringCallUsageWhatsapp](docs/UsageMeteringCallUsageWhatsapp.md)
  - [Zernio::UsageMeteringDaysInner](docs/UsageMeteringDaysInner.md)
  - [Zernio::UsageMeteringLineItemsInner](docs/UsageMeteringLineItemsInner.md)
  - [Zernio::UsageMeteringPeaks](docs/UsageMeteringPeaks.md)
  - [Zernio::UsageMeteringPeriod](docs/UsageMeteringPeriod.md)
+ - [Zernio::UsageMeteringScope](docs/UsageMeteringScope.md)
+ - [Zernio::UsageMeteringScopeOneOf](docs/UsageMeteringScopeOneOf.md)
  - [Zernio::UsageMeteringTax](docs/UsageMeteringTax.md)
  - [Zernio::UsageMeteringTotals](docs/UsageMeteringTotals.md)
  - [Zernio::UsageStats](docs/UsageStats.md)

data/docs/ConnectApi.md

@@ -28,6 +28,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**get_shopify_connect_url**](ConnectApi.md#get_shopify_connect_url) | **GET** /v1/connect/shopify | Get Shopify OAuth connect URL |
 | [**get_subreddit_rules**](ConnectApi.md#get_subreddit_rules) | **GET** /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules | Get subreddit rules |
 | [**get_telegram_connect_status**](ConnectApi.md#get_telegram_connect_status) | **GET** /v1/connect/telegram | Generate Telegram code |
+| [**get_youtube_captions**](ConnectApi.md#get_youtube_captions) | **GET** /v1/accounts/{accountId}/youtube-captions | Get a YouTube video transcript |
 | [**get_youtube_playlists**](ConnectApi.md#get_youtube_playlists) | **GET** /v1/accounts/{accountId}/youtube-playlists | List YouTube playlists |
 | [**handle_o_auth_callback**](ConnectApi.md#handle_o_auth_callback) | **POST** /v1/connect/{platform} | Complete OAuth callback |
 | [**initiate_telegram_connect**](ConnectApi.md#initiate_telegram_connect) | **POST** /v1/connect/telegram | Connect Telegram directly |
@@ -1765,6 +1766,85 @@ end
 - **Accept**: application/json
 
 
+## get_youtube_captions
+
+> <GetYoutubeCaptions200Response> get_youtube_captions(account_id, video_id, opts)
+
+Get a YouTube video transcript
+
+Returns the caption track YouTube already holds for one of the connected channel's own videos, as plain text plus timed cues. Use it instead of downloading and transcribing the video yourself.  Auto-generated (ASR) tracks are included: YouTube serves them to the channel owner, which is what the connected account is. Uploaded tracks win over auto-generated ones when both exist for a language.  Caching: we store the transcript on first read and serve it from there afterwards, so you do not need to cache it yourself. A cached read costs no YouTube quota and does not call YouTube at all. `source` tells you which happened (`youtube` on the first read, `cache` after). Pass `refresh=true` only when the captions actually changed on YouTube, since that re-downloads.  Notes: - Only videos owned by this connected channel. Anything else returns 404. - `contentDetails.caption` in YouTube's own API reads `false` on videos that DO have a serving auto-generated track, so it is not a usable availability signal. Call this endpoint and handle the 404. - YouTube generates auto-captions only for videos with recognisable speech, and can take a few hours after upload to publish them. 
+
+### 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::ConnectApi.new
+account_id = 'account_id_example' # String | The connected YouTube account.
+video_id = 'video_id_example' # String | The YouTube video id (the `platformPostId` on a synced external post).
+opts = {
+  language: 'language_example', # String | BCP-47 language tag as YouTube labels the track. `en` also matches an `en-GB` track. Omit to take the best available track.
+  format: 'json', # String | `json` returns timed `cues`; `srt` returns the raw SubRip body instead. `text` is present either way.
+  refresh: true # Boolean | Re-download from YouTube instead of serving the stored copy. Spends 200 quota units.
+}
+
+begin
+  # Get a YouTube video transcript
+  result = api_instance.get_youtube_captions(account_id, video_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling ConnectApi->get_youtube_captions: #{e}"
+end
+```
+
+#### Using the get_youtube_captions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetYoutubeCaptions200Response>, Integer, Hash)> get_youtube_captions_with_http_info(account_id, video_id, opts)
+
+```ruby
+begin
+  # Get a YouTube video transcript
+  data, status_code, headers = api_instance.get_youtube_captions_with_http_info(account_id, video_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetYoutubeCaptions200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling ConnectApi->get_youtube_captions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The connected YouTube account. |  |
+| **video_id** | **String** | The YouTube video id (the &#x60;platformPostId&#x60; on a synced external post). |  |
+| **language** | **String** | BCP-47 language tag as YouTube labels the track. &#x60;en&#x60; also matches an &#x60;en-GB&#x60; track. Omit to take the best available track. | [optional] |
+| **format** | **String** | &#x60;json&#x60; returns timed &#x60;cues&#x60;; &#x60;srt&#x60; returns the raw SubRip body instead. &#x60;text&#x60; is present either way. | [optional][default to &#39;json&#39;] |
+| **refresh** | **Boolean** | Re-download from YouTube instead of serving the stored copy. Spends 200 quota units. | [optional][default to false] |
+
+### Return type
+
+[**GetYoutubeCaptions200Response**](GetYoutubeCaptions200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_youtube_playlists
 
 > <GetYoutubePlaylists200Response> get_youtube_playlists(account_id)

data/docs/GetYoutubeCaptions200Response.md

@@ -0,0 +1,38 @@
+# Zernio::GetYoutubeCaptions200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** |  | [optional] |
+| **video_id** | **String** |  | [optional] |
+| **language** | **String** | The language of the returned track. | [optional] |
+| **track_id** | **String** | YouTube's own caption track id. | [optional] |
+| **track_kind** | **String** | `asr` is YouTube's auto-generated track; `standard` was uploaded by the channel. | [optional] |
+| **source** | **String** | `cache` when served from our stored copy, `youtube` when this call spent the quota units. | [optional] |
+| **fetched_at** | **Time** | When the stored copy was downloaded from YouTube. | [optional] |
+| **text** | **String** | The whole transcript as one paragraph, no timings. | [optional] |
+| **cues** | [**Array<GetYoutubeCaptions200ResponseCuesInner>**](GetYoutubeCaptions200ResponseCuesInner.md) | Timed cues. Present when format is json. Auto-generated cues overlap in time by design (captions roll), so `start` can precede the previous cue's `end`. | [optional] |
+| **srt** | **String** | Raw SubRip body. Present when format is srt. | [optional] |
+| **available_tracks** | [**Array<GetYoutubeCaptions200ResponseAvailableTracksInner>**](GetYoutubeCaptions200ResponseAvailableTracksInner.md) | Every track on the video, so you can re-request another language. On a cached read this is the listing as it stood when we downloaded, so a language added to the video since then appears only after a `refresh=true` or when you request that language directly. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetYoutubeCaptions200Response.new(
+  account_id: null,
+  video_id: null,
+  language: null,
+  track_id: null,
+  track_kind: null,
+  source: null,
+  fetched_at: null,
+  text: null,
+  cues: null,
+  srt: null,
+  available_tracks: null
+)
+```
+

data/docs/GetYoutubeCaptions200ResponseAvailableTracksInner.md

@@ -0,0 +1,24 @@
+# Zernio::GetYoutubeCaptions200ResponseAvailableTracksInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **track_id** | **String** |  | [optional] |
+| **language** | **String** |  | [optional] |
+| **track_kind** | **String** |  | [optional] |
+| **name** | **String** | The track's display name. Empty for auto-generated tracks. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetYoutubeCaptions200ResponseAvailableTracksInner.new(
+  track_id: null,
+  language: null,
+  track_kind: null,
+  name: null
+)
+```
+

data/docs/GetYoutubeCaptions200ResponseCuesInner.md

@@ -0,0 +1,22 @@
+# Zernio::GetYoutubeCaptions200ResponseCuesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **start** | **Float** | Seconds from the start of the video. | [optional] |
+| **_end** | **Float** |  | [optional] |
+| **text** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetYoutubeCaptions200ResponseCuesInner.new(
+  start: null,
+  _end: null,
+  text: null
+)
+```
+

data/docs/UsageApi.md

@@ -240,7 +240,7 @@ end
 
 Usage snapshot (default) or billed-spend metering (with params)
 
-Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
+Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  **Attribution (metering mode):** `groupBy=profile|account` adds an `attribution` breakdown of the window's spend per profile or account, assembled from your own records and pro-rated against the invoice so `sum(groups) + unattributed` equals `totals` exactly. `profileId` / `accountId` instead project the whole payload (`days`, `totals`, `lineItems`) onto that one group; `peaks`, `callUsage` and `tax` are then `null` (workspace-level facts). Projected `days` spread the group's period share over each day (usage is attributed per period, not per day). Profile-scoped API keys and members only see their profiles' groups (`attribution.restricted: true`, with `totals` summing the visible groups). Credits, 10DLC fees and Verify are always unattributed. `profileId` / `accountId` on their own do not select metering mode: pair them with `range`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
 
 ### Examples
 
@@ -259,7 +259,10 @@ opts = {
   range: 'cycle', # String | Window to report. `cycle` / `prev-cycle` resolve to the customer's real billing-period bounds (falling back to a trailing 30 days when no invoice exists yet); `7d`…`12mo` are trailing windows; `custom` uses `from` / `to`. 
   from: Date.parse('2013-10-20'), # Date | Inclusive start (UTC date). Required when `range=custom`.
   to: Date.parse('2013-10-20'), # Date | Inclusive end (UTC date). Required when `range=custom`. Max span 366 days.
-  granularity: 'day' # String | Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`. 
+  granularity: 'day', # String | Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`. 
+  group_by: 'profile', # String | Metering mode. Adds `attribution`: the window's spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`).
+  profile_id: 'profile_id_example', # String | Metering mode (pair with `range`). Project the payload onto this profile's attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key's profiles).
+  account_id: 'account_id_example' # String | Metering mode (pair with `range`). Project the payload onto this account's attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller.
 }
 
 begin
@@ -298,6 +301,9 @@ end
 | **from** | **Date** | Inclusive start (UTC date). Required when `range=custom`. | [optional] |
 | **to** | **Date** | Inclusive end (UTC date). Required when `range=custom`. Max span 366 days. | [optional] |
 | **granularity** | **String** | Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`.  | [optional][default to 'day'] |
+| **group_by** | **String** | Metering mode. Adds `attribution`: the window's spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`). | [optional] |
+| **profile_id** | **String** | Metering mode (pair with `range`). Project the payload onto this profile's attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key's profiles). | [optional] |
+| **account_id** | **String** | Metering mode (pair with `range`). Project the payload onto this account's attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller. | [optional] |
 
 ### Return type
 

data/docs/UsageAttributionGroup.md

@@ -0,0 +1,22 @@
+# Zernio::UsageAttributionGroup
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **by_product** | [**UsageAttributionSliceByProduct**](UsageAttributionSliceByProduct.md) |  | [optional] |
+| **total_usd** | **Float** |  | [optional] |
+| **key** | **String** | Profile id or account id, per `groupBy`. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UsageAttributionGroup.new(
+  by_product: null,
+  total_usd: null,
+  key: null
+)
+```
+

data/docs/UsageAttributionSlice.md

@@ -0,0 +1,20 @@
+# Zernio::UsageAttributionSlice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **by_product** | [**UsageAttributionSliceByProduct**](UsageAttributionSliceByProduct.md) |  | [optional] |
+| **total_usd** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UsageAttributionSlice.new(
+  by_product: null,
+  total_usd: null
+)
+```
+

data/docs/UsageAttributionSliceByProduct.md

@@ -0,0 +1,34 @@
+# Zernio::UsageAttributionSliceByProduct
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **accounts** | **Float** |  | [optional] |
+| **numbers** | **Float** |  | [optional] |
+| **calls** | **Float** |  | [optional] |
+| **sms** | **Float** |  | [optional] |
+| **verify** | **Float** |  | [optional] |
+| **dlc** | **Float** |  | [optional] |
+| **x_api** | **Float** |  | [optional] |
+| **credits** | **Float** |  | [optional] |
+| **other** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UsageAttributionSliceByProduct.new(
+  accounts: null,
+  numbers: null,
+  calls: null,
+  sms: null,
+  verify: null,
+  dlc: null,
+  x_api: null,
+  credits: null,
+  other: null
+)
+```
+

data/docs/UsageMetering.md

@@ -13,6 +13,8 @@
 | **call_usage** | [**UsageMeteringCallUsage**](UsageMeteringCallUsage.md) |  | [optional] |
 | **period** | [**UsageMeteringPeriod**](UsageMeteringPeriod.md) |  | [optional] |
 | **tax** | [**UsageMeteringTax**](UsageMeteringTax.md) |  | [optional] |
+| **attribution** | [**UsageMeteringAttribution**](UsageMeteringAttribution.md) |  | [optional] |
+| **scope** | [**UsageMeteringScope**](UsageMeteringScope.md) |  | [optional] |
 
 ## Example
 
@@ -28,7 +30,9 @@ instance = Zernio::UsageMetering.new(
   peaks: null,
   call_usage: null,
   period: null,
-  tax: null
+  tax: null,
+  attribution: null,
+  scope: null
 )
 ```
 

data/docs/UsageMeteringAttribution.md

@@ -0,0 +1,26 @@
+# Zernio::UsageMeteringAttribution
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **group_by** | **String** |  | [optional] |
+| **groups** | [**Array<UsageAttributionGroup>**](UsageAttributionGroup.md) |  | [optional] |
+| **unattributed** | [**UsageAttributionSlice**](UsageAttributionSlice.md) | Spend no profile/account can claim: credits, 10DLC fees, Verify, and usage whose record no longer resolves to an account. Zero for a restricted principal. | [optional] |
+| **totals** | [**UsageAttributionSlice**](UsageAttributionSlice.md) | The window totals; for a restricted principal, the sum of the visible groups. | [optional] |
+| **restricted** | **Boolean** | True when the caller (profile-scoped API key or member) cannot see every profile: `groups` are filtered, `totals` sum them, `unattributed` is zero, and the top-level `days` / `totals` / `lineItems` are projected onto the visible groups with `peaks`, `callUsage` and `tax` null. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UsageMeteringAttribution.new(
+  group_by: null,
+  groups: null,
+  unattributed: null,
+  totals: null,
+  restricted: null
+)
+```
+

data/docs/UsageMeteringScope.md

@@ -0,0 +1,49 @@
+# Zernio::UsageMeteringScope
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::UsageMeteringScope.openapi_one_of
+# =>
+# [
+#   :'DeleteInboxReviewReplyRequest',
+#   :'UsageMeteringScopeOneOf'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::UsageMeteringScope.build(data)
+# => #<DeleteInboxReviewReplyRequest:0x00007fdd4aab02a0>
+
+Zernio::UsageMeteringScope.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `DeleteInboxReviewReplyRequest`
+- `UsageMeteringScopeOneOf`
+- `nil` (if no type matches)
+

data/docs/UsageMeteringScopeOneOf.md

@@ -0,0 +1,18 @@
+# Zernio::UsageMeteringScopeOneOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **profile_id** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UsageMeteringScopeOneOf.new(
+  profile_id: null
+)
+```
+

data/lib/zernio-sdk/api/connect_api.rb

@@ -1714,6 +1714,89 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Get a YouTube video transcript
+    # Returns the caption track YouTube already holds for one of the connected channel's own videos, as plain text plus timed cues. Use it instead of downloading and transcribing the video yourself.  Auto-generated (ASR) tracks are included: YouTube serves them to the channel owner, which is what the connected account is. Uploaded tracks win over auto-generated ones when both exist for a language.  Caching: we store the transcript on first read and serve it from there afterwards, so you do not need to cache it yourself. A cached read costs no YouTube quota and does not call YouTube at all. `source` tells you which happened (`youtube` on the first read, `cache` after). Pass `refresh=true` only when the captions actually changed on YouTube, since that re-downloads.  Notes: - Only videos owned by this connected channel. Anything else returns 404. - `contentDetails.caption` in YouTube's own API reads `false` on videos that DO have a serving auto-generated track, so it is not a usable availability signal. Call this endpoint and handle the 404. - YouTube generates auto-captions only for videos with recognisable speech, and can take a few hours after upload to publish them. 
+    # @param account_id [String] The connected YouTube account.
+    # @param video_id [String] The YouTube video id (the `platformPostId` on a synced external post).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :language BCP-47 language tag as YouTube labels the track. `en` also matches an `en-GB` track. Omit to take the best available track.
+    # @option opts [String] :format `json` returns timed `cues`; `srt` returns the raw SubRip body instead. `text` is present either way. (default to 'json')
+    # @option opts [Boolean] :refresh Re-download from YouTube instead of serving the stored copy. Spends 200 quota units. (default to false)
+    # @return [GetYoutubeCaptions200Response]
+    def get_youtube_captions(account_id, video_id, opts = {})
+      data, _status_code, _headers = get_youtube_captions_with_http_info(account_id, video_id, opts)
+      data
+    end
+
+    # Get a YouTube video transcript
+    # Returns the caption track YouTube already holds for one of the connected channel's own videos, as plain text plus timed cues. Use it instead of downloading and transcribing the video yourself.  Auto-generated (ASR) tracks are included: YouTube serves them to the channel owner, which is what the connected account is. Uploaded tracks win over auto-generated ones when both exist for a language.  Caching: we store the transcript on first read and serve it from there afterwards, so you do not need to cache it yourself. A cached read costs no YouTube quota and does not call YouTube at all. `source` tells you which happened (`youtube` on the first read, `cache` after). Pass `refresh=true` only when the captions actually changed on YouTube, since that re-downloads.  Notes: - Only videos owned by this connected channel. Anything else returns 404. - `contentDetails.caption` in YouTube's own API reads `false` on videos that DO have a serving auto-generated track, so it is not a usable availability signal. Call this endpoint and handle the 404. - YouTube generates auto-captions only for videos with recognisable speech, and can take a few hours after upload to publish them. 
+    # @param account_id [String] The connected YouTube account.
+    # @param video_id [String] The YouTube video id (the `platformPostId` on a synced external post).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :language BCP-47 language tag as YouTube labels the track. `en` also matches an `en-GB` track. Omit to take the best available track.
+    # @option opts [String] :format `json` returns timed `cues`; `srt` returns the raw SubRip body instead. `text` is present either way. (default to 'json')
+    # @option opts [Boolean] :refresh Re-download from YouTube instead of serving the stored copy. Spends 200 quota units. (default to false)
+    # @return [Array<(GetYoutubeCaptions200Response, Integer, Hash)>] GetYoutubeCaptions200Response data, response status code and response headers
+    def get_youtube_captions_with_http_info(account_id, video_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConnectApi.get_youtube_captions ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling ConnectApi.get_youtube_captions"
+      end
+      # verify the required parameter 'video_id' is set
+      if @api_client.config.client_side_validation && video_id.nil?
+        fail ArgumentError, "Missing the required parameter 'video_id' when calling ConnectApi.get_youtube_captions"
+      end
+      allowable_values = ["json", "srt"]
+      if @api_client.config.client_side_validation && opts[:'format'] && !allowable_values.include?(opts[:'format'])
+        fail ArgumentError, "invalid value for \"format\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/youtube-captions'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'videoId'] = video_id
+      query_params[:'language'] = opts[:'language'] if !opts[:'language'].nil?
+      query_params[:'format'] = opts[:'format'] if !opts[:'format'].nil?
+      query_params[:'refresh'] = opts[:'refresh'] if !opts[:'refresh'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetYoutubeCaptions200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConnectApi.get_youtube_captions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ConnectApi#get_youtube_captions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List YouTube playlists
     # Returns the playlists available for a connected YouTube account. Use this to get a playlist ID when creating a YouTube post with the playlistId field.
     # @param account_id [String] 

data/lib/zernio-sdk/api/usage_api.rb

@@ -230,13 +230,16 @@ module Zernio
     end
 
     # Usage snapshot (default) or billed-spend metering (with params)
-    # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
+    # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  **Attribution (metering mode):** `groupBy=profile|account` adds an `attribution` breakdown of the window's spend per profile or account, assembled from your own records and pro-rated against the invoice so `sum(groups) + unattributed` equals `totals` exactly. `profileId` / `accountId` instead project the whole payload (`days`, `totals`, `lineItems`) onto that one group; `peaks`, `callUsage` and `tax` are then `null` (workspace-level facts). Projected `days` spread the group's period share over each day (usage is attributed per period, not per day). Profile-scoped API keys and members only see their profiles' groups (`attribution.restricted: true`, with `totals` summing the visible groups). Credits, 10DLC fees and Verify are always unattributed. `profileId` / `accountId` on their own do not select metering mode: pair them with `range`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :reconcile Snapshot mode only. For Stripe subscription users, `true` forces a subscription reconciliation pass even when cached plan data looks complete. 
     # @option opts [String] :range Window to report. `cycle` / `prev-cycle` resolve to the customer's real billing-period bounds (falling back to a trailing 30 days when no invoice exists yet); `7d`…`12mo` are trailing windows; `custom` uses `from` / `to`.  (default to 'cycle')
     # @option opts [Date] :from Inclusive start (UTC date). Required when `range=custom`.
     # @option opts [Date] :to Inclusive end (UTC date). Required when `range=custom`. Max span 366 days.
     # @option opts [String] :granularity Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`.  (default to 'day')
+    # @option opts [String] :group_by Metering mode. Adds `attribution`: the window's spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`).
+    # @option opts [String] :profile_id Metering mode (pair with `range`). Project the payload onto this profile's attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key's profiles).
+    # @option opts [String] :account_id Metering mode (pair with `range`). Project the payload onto this account's attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller.
     # @return [GetUsage200Response]
     def get_usage(opts = {})
       data, _status_code, _headers = get_usage_with_http_info(opts)
@@ -244,13 +247,16 @@ module Zernio
     end
 
     # Usage snapshot (default) or billed-spend metering (with params)
-    # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
+    # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  **Attribution (metering mode):** `groupBy=profile|account` adds an `attribution` breakdown of the window's spend per profile or account, assembled from your own records and pro-rated against the invoice so `sum(groups) + unattributed` equals `totals` exactly. `profileId` / `accountId` instead project the whole payload (`days`, `totals`, `lineItems`) onto that one group; `peaks`, `callUsage` and `tax` are then `null` (workspace-level facts). Projected `days` spread the group's period share over each day (usage is attributed per period, not per day). Profile-scoped API keys and members only see their profiles' groups (`attribution.restricted: true`, with `totals` summing the visible groups). Credits, 10DLC fees and Verify are always unattributed. `profileId` / `accountId` on their own do not select metering mode: pair them with `range`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :reconcile Snapshot mode only. For Stripe subscription users, `true` forces a subscription reconciliation pass even when cached plan data looks complete. 
     # @option opts [String] :range Window to report. `cycle` / `prev-cycle` resolve to the customer's real billing-period bounds (falling back to a trailing 30 days when no invoice exists yet); `7d`…`12mo` are trailing windows; `custom` uses `from` / `to`.  (default to 'cycle')
     # @option opts [Date] :from Inclusive start (UTC date). Required when `range=custom`.
     # @option opts [Date] :to Inclusive end (UTC date). Required when `range=custom`. Max span 366 days.
     # @option opts [String] :granularity Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`.  (default to 'day')
+    # @option opts [String] :group_by Metering mode. Adds `attribution`: the window's spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`).
+    # @option opts [String] :profile_id Metering mode (pair with `range`). Project the payload onto this profile's attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key's profiles).
+    # @option opts [String] :account_id Metering mode (pair with `range`). Project the payload onto this account's attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller.
     # @return [Array<(GetUsage200Response, Integer, Hash)>] GetUsage200Response data, response status code and response headers
     def get_usage_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -264,6 +270,10 @@ module Zernio
       if @api_client.config.client_side_validation && opts[:'granularity'] && !allowable_values.include?(opts[:'granularity'])
         fail ArgumentError, "invalid value for \"granularity\", must be one of #{allowable_values}"
       end
+      allowable_values = ["profile", "account"]
+      if @api_client.config.client_side_validation && opts[:'group_by'] && !allowable_values.include?(opts[:'group_by'])
+        fail ArgumentError, "invalid value for \"group_by\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/v1/usage'
 
@@ -274,6 +284,9 @@ module Zernio
       query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
       query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
       query_params[:'granularity'] = opts[:'granularity'] if !opts[:'granularity'].nil?
+      query_params[:'groupBy'] = opts[:'group_by'] if !opts[:'group_by'].nil?
+      query_params[:'profileId'] = opts[:'profile_id'] if !opts[:'profile_id'].nil?
+      query_params[:'accountId'] = opts[:'account_id'] if !opts[:'account_id'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}