late-sdk 0.0.1486 → 0.0.1487

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 837a34677ee59020792e1d575a4e6a70d8301e6f62e4a04a04c4cc9b740f75ea
-  data.tar.gz: aa553f153a0e78cab8df37cdef6339c7c203ecd99c090b442b0633cdc8ff1c76
+  metadata.gz: 6d1436e39b63e20deda256dcbdc73020df3da373372e2f6eb9c72954578b8b1b
+  data.tar.gz: d09fe055ede9a9d499642afe4a50a57ef4d0f27ad924515d722abb4ea1acc8bf
 SHA512:
-  metadata.gz: 4a7befccf633f683e1a273cbcb715c7912232e95259d1a86fcf0bfc104e7c00f2e318b998eff064ec29370ecccd3d0e9f7c452b97bd7d6ec10bec6060ba5bba2
-  data.tar.gz: 0c985247e9f6e1f007c297f27a960642c27a84c7cedb5c3758731f484253119a15320ac4a543fb2117e7abe6c086bc8f9c18dec422e3c4712db61b19d1df21eb
+  metadata.gz: e69243e4430441f4bbab1acb2907f511875ceb2eb74d5bc3567f96132a7bdaff50605bc3dd24bb6cad6c8bfcd9517a0099569ea7d65532e6789283fe02f24d7f
+  data.tar.gz: c52e5b50097027dc4f6d37fff206d4bc4ea602015e1c91e92640a2fb479e0981647ae222a05fb1d8f72a844abc5ca79a13f17ec390d8c4a1807fffb450be68da

data/README.md

@@ -142,6 +142,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdAccountsApi* | [**delete_ad_negative_keyword_list**](docs/AdAccountsApi.md#delete_ad_negative_keyword_list) | **DELETE** /v1/ads/accounts/negative-keyword-lists/{listId} | Delete a negative keyword list
 *Zernio::AdAccountsApi* | [**delete_value_rule_set**](docs/AdAccountsApi.md#delete_value_rule_set) | **DELETE** /v1/ads/value-rule-sets/{valueRuleSetId} | Delete a value rule set
 *Zernio::AdAccountsApi* | [**detach_ad_label**](docs/AdAccountsApi.md#detach_ad_label) | **DELETE** /v1/ads/labels/{labelId}/assignments | Detach a Google Ads label
+*Zernio::AdAccountsApi* | [**get_ad_account_billing**](docs/AdAccountsApi.md#get_ad_account_billing) | **GET** /v1/ads/accounts/billing | Get ad account billing
 *Zernio::AdAccountsApi* | [**get_ad_account_finance**](docs/AdAccountsApi.md#get_ad_account_finance) | **GET** /v1/ads/accounts/finance | Ad account finances
 *Zernio::AdAccountsApi* | [**get_ad_account_hierarchy**](docs/AdAccountsApi.md#get_ad_account_hierarchy) | **GET** /v1/ads/accounts/hierarchy | Get manager account hierarchy
 *Zernio::AdAccountsApi* | [**get_ad_account_live_entities**](docs/AdAccountsApi.md#get_ad_account_live_entities) | **GET** /v1/ads/accounts/live | Read an ad account's campaigns and ad sets live
@@ -185,6 +186,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdAccountsApi* | [**replace_ad_negative_keyword_list_keywords**](docs/AdAccountsApi.md#replace_ad_negative_keyword_list_keywords) | **PUT** /v1/ads/accounts/negative-keyword-lists/{listId}/keywords | Replace negative list keywords
 *Zernio::AdAccountsApi* | [**reply_to_ad_comment**](docs/AdAccountsApi.md#reply_to_ad_comment) | **POST** /v1/ads/{adId}/comments/{commentId}/reply | Reply to an ad comment
 *Zernio::AdAccountsApi* | [**revoke_ad_account_user_invitation**](docs/AdAccountsApi.md#revoke_ad_account_user_invitation) | **DELETE** /v1/ads/accounts/user-invitations | Revoke a user access invitation
+*Zernio::AdAccountsApi* | [**set_up_ad_account_billing**](docs/AdAccountsApi.md#set_up_ad_account_billing) | **POST** /v1/ads/accounts/billing | Set up ad account billing (monthly invoicing)
 *Zernio::AdAccountsApi* | [**update_account_callouts**](docs/AdAccountsApi.md#update_account_callouts) | **PUT** /v1/ads/accounts/callouts | Update account callouts
 *Zernio::AdAccountsApi* | [**update_account_sitelinks**](docs/AdAccountsApi.md#update_account_sitelinks) | **PUT** /v1/ads/accounts/sitelinks | Update account sitelinks
 *Zernio::AdAccountsApi* | [**update_account_structured_snippets**](docs/AdAccountsApi.md#update_account_structured_snippets) | **PUT** /v1/ads/accounts/structured-snippets | Update account snippets
@@ -1898,6 +1900,11 @@ Class | Method | HTTP request | Description
  - [Zernio::GetAccountPosts200ResponsePostsInner](docs/GetAccountPosts200ResponsePostsInner.md)
  - [Zernio::GetAd200Response](docs/GetAd200Response.md)
  - [Zernio::GetAd200ResponseDarkPost](docs/GetAd200ResponseDarkPost.md)
+ - [Zernio::GetAdAccountBilling200Response](docs/GetAdAccountBilling200Response.md)
+ - [Zernio::GetAdAccountBilling200ResponseAccountBudgetsInner](docs/GetAdAccountBilling200ResponseAccountBudgetsInner.md)
+ - [Zernio::GetAdAccountBilling200ResponseBillingSetupsInner](docs/GetAdAccountBilling200ResponseBillingSetupsInner.md)
+ - [Zernio::GetAdAccountBilling200ResponsePaymentsAccountsInner](docs/GetAdAccountBilling200ResponsePaymentsAccountsInner.md)
+ - [Zernio::GetAdAccountBilling200ResponsePendingBudgetProposalsInner](docs/GetAdAccountBilling200ResponsePendingBudgetProposalsInner.md)
  - [Zernio::GetAdAccountFinance200Response](docs/GetAdAccountFinance200Response.md)
  - [Zernio::GetAdAccountFinance200ResponseFundingSource](docs/GetAdAccountFinance200ResponseFundingSource.md)
  - [Zernio::GetAdAccountHierarchy200Response](docs/GetAdAccountHierarchy200Response.md)
@@ -3237,6 +3244,9 @@ Class | Method | HTTP request | Description
  - [Zernio::SetRedditPostFlairRequest](docs/SetRedditPostFlairRequest.md)
  - [Zernio::SetTelegramCommandsRequest](docs/SetTelegramCommandsRequest.md)
  - [Zernio::SetTelegramCommandsRequestCommandsInner](docs/SetTelegramCommandsRequestCommandsInner.md)
+ - [Zernio::SetUpAdAccountBilling200Response](docs/SetUpAdAccountBilling200Response.md)
+ - [Zernio::SetUpAdAccountBilling201Response](docs/SetUpAdAccountBilling201Response.md)
+ - [Zernio::SetUpAdAccountBillingRequest](docs/SetUpAdAccountBillingRequest.md)
  - [Zernio::SetWhatsAppConversationalAutomationRequest](docs/SetWhatsAppConversationalAutomationRequest.md)
  - [Zernio::SetWhatsAppFlowsEncryptionKeyRequest](docs/SetWhatsAppFlowsEncryptionKeyRequest.md)
  - [Zernio::SetWhatsappBusinessUsername200Response](docs/SetWhatsappBusinessUsername200Response.md)

data/docs/AdAccountsApi.md

@@ -20,6 +20,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**delete_ad_negative_keyword_list**](AdAccountsApi.md#delete_ad_negative_keyword_list) | **DELETE** /v1/ads/accounts/negative-keyword-lists/{listId} | Delete a negative keyword list |
 | [**delete_value_rule_set**](AdAccountsApi.md#delete_value_rule_set) | **DELETE** /v1/ads/value-rule-sets/{valueRuleSetId} | Delete a value rule set |
 | [**detach_ad_label**](AdAccountsApi.md#detach_ad_label) | **DELETE** /v1/ads/labels/{labelId}/assignments | Detach a Google Ads label |
+| [**get_ad_account_billing**](AdAccountsApi.md#get_ad_account_billing) | **GET** /v1/ads/accounts/billing | Get ad account billing |
 | [**get_ad_account_finance**](AdAccountsApi.md#get_ad_account_finance) | **GET** /v1/ads/accounts/finance | Ad account finances |
 | [**get_ad_account_hierarchy**](AdAccountsApi.md#get_ad_account_hierarchy) | **GET** /v1/ads/accounts/hierarchy | Get manager account hierarchy |
 | [**get_ad_account_live_entities**](AdAccountsApi.md#get_ad_account_live_entities) | **GET** /v1/ads/accounts/live | Read an ad account's campaigns and ad sets live |
@@ -63,6 +64,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**replace_ad_negative_keyword_list_keywords**](AdAccountsApi.md#replace_ad_negative_keyword_list_keywords) | **PUT** /v1/ads/accounts/negative-keyword-lists/{listId}/keywords | Replace negative list keywords |
 | [**reply_to_ad_comment**](AdAccountsApi.md#reply_to_ad_comment) | **POST** /v1/ads/{adId}/comments/{commentId}/reply | Reply to an ad comment |
 | [**revoke_ad_account_user_invitation**](AdAccountsApi.md#revoke_ad_account_user_invitation) | **DELETE** /v1/ads/accounts/user-invitations | Revoke a user access invitation |
+| [**set_up_ad_account_billing**](AdAccountsApi.md#set_up_ad_account_billing) | **POST** /v1/ads/accounts/billing | Set up ad account billing (monthly invoicing) |
 | [**update_account_callouts**](AdAccountsApi.md#update_account_callouts) | **PUT** /v1/ads/accounts/callouts | Update account callouts |
 | [**update_account_sitelinks**](AdAccountsApi.md#update_account_sitelinks) | **PUT** /v1/ads/accounts/sitelinks | Update account sitelinks |
 | [**update_account_structured_snippets**](AdAccountsApi.md#update_account_structured_snippets) | **PUT** /v1/ads/accounts/structured-snippets | Update account snippets |
@@ -1218,6 +1220,79 @@ end
 - **Accept**: application/json
 
 
+## get_ad_account_billing
+
+> <GetAdAccountBilling200Response> get_ad_account_billing(account_id, opts)
+
+Get ad account billing
+
+Reads the payments accounts a Google Ads account can be billed to, plus its billing setups and account budgets.  Payments accounts come from Google's PaymentsAccountService, read as the manager above the customer: they are the monthly invoicing (consolidated billing) accounts of that manager. An empty `paymentsAccounts` means the manager has no monthly invoicing, so billing cannot be set up through the API and has to be added in Google Ads. Billing setups and account budgets are read live from Google with their status. Results are cached for 10 minutes and dropped on every setup through Zernio.
+
+### 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::AdAccountsApi.new
+account_id = 'account_id_example' # String | Google ads SocialAccount id.
+opts = {
+  ad_account_id: 'ad_account_id_example' # String | Google Ads customer id, digits only. Defaults to the connection's selected customer.
+}
+
+begin
+  # Get ad account billing
+  result = api_instance.get_ad_account_billing(account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->get_ad_account_billing: #{e}"
+end
+```
+
+#### Using the get_ad_account_billing_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetAdAccountBilling200Response>, Integer, Hash)> get_ad_account_billing_with_http_info(account_id, opts)
+
+```ruby
+begin
+  # Get ad account billing
+  data, status_code, headers = api_instance.get_ad_account_billing_with_http_info(account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetAdAccountBilling200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->get_ad_account_billing_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **ad_account_id** | **String** | Google Ads customer id, digits only. Defaults to the connection&#39;s selected customer. | [optional] |
+
+### Return type
+
+[**GetAdAccountBilling200Response**](GetAdAccountBilling200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_ad_account_finance
 
 > <GetAdAccountFinance200Response> get_ad_account_finance(account_id, ad_account_id)
@@ -4437,6 +4512,75 @@ end
 - **Accept**: application/json
 
 
+## set_up_ad_account_billing
+
+> <SetUpAdAccountBilling200Response> set_up_ad_account_billing(set_up_ad_account_billing_request)
+
+Set up ad account billing (monthly invoicing)
+
+Bills a Google Ads account to a monthly invoicing payments account of a manager above it, and proposes its account budget, so the account can serve without anyone opening Google Ads.  Monthly invoicing only. Google's API cannot add a card or other payment method, so `paymentsAccountId` must be one of the manager's monthly invoicing (consolidated billing) payments accounts listed by GET /v1/ads/accounts/billing. A manager without monthly invoicing has none, and billing has to be added in Google Ads instead.  Creates a billing setup (Google's BillingSetupService) that starts now on that payments account, then an account budget proposal that starts now and never ends: unlimited by default, or capped at `spendingLimit` in the account currency. Google reviews the budget offline, usually within an hour; until then the setup reads `APPROVED_HELD` and ads do not serve. A customer whose current billing setup already has a budget is refused with 409, and so is one billed to another payments account: this call never replaces existing billing. A current setup on the same payments account without a budget (for example after a budget rejection) is reused, so resending the same request finishes it.  Not idempotent and never retried: after a 502 with details.creationStatus=unknown, read GET /v1/ads/accounts/billing before retrying. Google has no dry run for billing setups, so `validateOnly: true` checks the payments account and the existing billing without creating anything (and asks Google to validate the budget when a setup would be reused).
+
+### 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::AdAccountsApi.new
+set_up_ad_account_billing_request = Zernio::SetUpAdAccountBillingRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', payments_account_id: 'payments_account_id_example'}) # SetUpAdAccountBillingRequest | 
+
+begin
+  # Set up ad account billing (monthly invoicing)
+  result = api_instance.set_up_ad_account_billing(set_up_ad_account_billing_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->set_up_ad_account_billing: #{e}"
+end
+```
+
+#### Using the set_up_ad_account_billing_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SetUpAdAccountBilling200Response>, Integer, Hash)> set_up_ad_account_billing_with_http_info(set_up_ad_account_billing_request)
+
+```ruby
+begin
+  # Set up ad account billing (monthly invoicing)
+  data, status_code, headers = api_instance.set_up_ad_account_billing_with_http_info(set_up_ad_account_billing_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SetUpAdAccountBilling200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdAccountsApi->set_up_ad_account_billing_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **set_up_ad_account_billing_request** | [**SetUpAdAccountBillingRequest**](SetUpAdAccountBillingRequest.md) |  |  |
+
+### Return type
+
+[**SetUpAdAccountBilling200Response**](SetUpAdAccountBilling200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_account_callouts
 
 > <UpdateAccountCallouts200Response> update_account_callouts(update_account_callouts_request)

data/docs/GetAdAccountBilling200Response.md

@@ -0,0 +1,30 @@
+# Zernio::GetAdAccountBilling200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **payments_accounts** | [**Array<GetAdAccountBilling200ResponsePaymentsAccountsInner>**](GetAdAccountBilling200ResponsePaymentsAccountsInner.md) |  | [optional] |
+| **billing_setups** | [**Array<GetAdAccountBilling200ResponseBillingSetupsInner>**](GetAdAccountBilling200ResponseBillingSetupsInner.md) |  | [optional] |
+| **account_budgets** | [**Array<GetAdAccountBilling200ResponseAccountBudgetsInner>**](GetAdAccountBilling200ResponseAccountBudgetsInner.md) |  | [optional] |
+| **pending_budget_proposals** | [**Array<GetAdAccountBilling200ResponsePendingBudgetProposalsInner>**](GetAdAccountBilling200ResponsePendingBudgetProposalsInner.md) | New account budgets proposed but not yet approved by Google. A setup with one is not reused by the POST. | [optional] |
+| **cached_at** | **Time** | When this data was fetched from Google. Null when the cache is unavailable. | [optional] |
+| **stale** | **Boolean** | True when Google's quota was exhausted and this is the last successful fetch. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdAccountBilling200Response.new(
+  customer_id: null,
+  payments_accounts: null,
+  billing_setups: null,
+  account_budgets: null,
+  pending_budget_proposals: null,
+  cached_at: null,
+  stale: null
+)
+```
+

data/docs/GetAdAccountBilling200ResponseAccountBudgetsInner.md

@@ -0,0 +1,28 @@
+# Zernio::GetAdAccountBilling200ResponseAccountBudgetsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_budget_id** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **billing_setup_id** | **String** |  | [optional] |
+| **approved_spending_limit_micros** | **String** |  | [optional] |
+| **approved_spending_limit_type** | **String** | INFINITE for an unlimited budget. | [optional] |
+| **pending_proposal_id** | **String** | Account budget proposal still waiting for Google's review. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdAccountBilling200ResponseAccountBudgetsInner.new(
+  account_budget_id: null,
+  status: null,
+  billing_setup_id: null,
+  approved_spending_limit_micros: null,
+  approved_spending_limit_type: null,
+  pending_proposal_id: null
+)
+```
+

data/docs/GetAdAccountBilling200ResponseBillingSetupsInner.md

@@ -0,0 +1,26 @@
+# Zernio::GetAdAccountBilling200ResponseBillingSetupsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **billing_setup_id** | **String** |  | [optional] |
+| **status** | **String** | APPROVED_HELD means approved but waiting for its first account budget to be approved. | [optional] |
+| **payments_account_id** | **String** |  | [optional] |
+| **start_date_time** | **String** | In the account time zone, as Google returns it. | [optional] |
+| **end_date_time** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdAccountBilling200ResponseBillingSetupsInner.new(
+  billing_setup_id: null,
+  status: null,
+  payments_account_id: null,
+  start_date_time: null,
+  end_date_time: null
+)
+```
+

data/docs/GetAdAccountBilling200ResponsePaymentsAccountsInner.md

@@ -0,0 +1,26 @@
+# Zernio::GetAdAccountBilling200ResponsePaymentsAccountsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **payments_account_id** | **String** | Format 1234-5678-9012-3456. Pass it to POST /v1/ads/accounts/billing. | [optional] |
+| **name** | **String** |  | [optional] |
+| **currency** | **String** |  | [optional] |
+| **payments_profile_id** | **String** |  | [optional] |
+| **paying_manager_customer_id** | **String** | Manager whose monthly invoice pays this account. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdAccountBilling200ResponsePaymentsAccountsInner.new(
+  payments_account_id: null,
+  name: null,
+  currency: null,
+  payments_profile_id: null,
+  paying_manager_customer_id: null
+)
+```
+

data/docs/GetAdAccountBilling200ResponsePendingBudgetProposalsInner.md

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

data/docs/SetUpAdAccountBilling200Response.md

@@ -0,0 +1,30 @@
+# Zernio::SetUpAdAccountBilling200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **payments_account_id** | **String** |  | [optional] |
+| **payments_account_name** | **String** |  | [optional] |
+| **billing_setup_id** | **String** |  | [optional] |
+| **reused_billing_setup** | **Boolean** |  | [optional] |
+| **account_budget_proposal_id** | **String** | Always null for validateOnly. | [optional] |
+| **validate_only** | **Boolean** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SetUpAdAccountBilling200Response.new(
+  customer_id: null,
+  payments_account_id: null,
+  payments_account_name: null,
+  billing_setup_id: null,
+  reused_billing_setup: null,
+  account_budget_proposal_id: null,
+  validate_only: null
+)
+```
+

data/docs/SetUpAdAccountBilling201Response.md

@@ -0,0 +1,32 @@
+# Zernio::SetUpAdAccountBilling201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **payments_account_id** | **String** |  | [optional] |
+| **payments_account_name** | **String** |  | [optional] |
+| **billing_setup_id** | **String** |  | [optional] |
+| **reused_billing_setup** | **Boolean** | True when an existing setup on the same payments account without a budget was completed. | [optional] |
+| **account_budget_proposal_id** | **String** |  | [optional] |
+| **validate_only** | **Boolean** |  | [optional] |
+| **next_steps** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SetUpAdAccountBilling201Response.new(
+  customer_id: null,
+  payments_account_id: null,
+  payments_account_name: null,
+  billing_setup_id: null,
+  reused_billing_setup: null,
+  account_budget_proposal_id: null,
+  validate_only: null,
+  next_steps: null
+)
+```
+

data/docs/SetUpAdAccountBillingRequest.md

@@ -0,0 +1,30 @@
+# Zernio::SetUpAdAccountBillingRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **ad_account_id** | **String** | Google Ads customer id to bill, digits only. |  |
+| **payments_account_id** | **String** | Monthly invoicing payments account from GET /v1/ads/accounts/billing. |  |
+| **spending_limit** | **Float** | Account budget cap in the account currency. Omit for an unlimited budget. | [optional] |
+| **budget_name** | **String** |  | [optional][default to 'Zernio account budget'] |
+| **purchase_order_number** | **String** | Printed on the invoice. No effect on delivery. | [optional] |
+| **validate_only** | **Boolean** |  | [optional][default to false] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SetUpAdAccountBillingRequest.new(
+  account_id: null,
+  ad_account_id: null,
+  payments_account_id: null,
+  spending_limit: null,
+  budget_name: null,
+  purchase_order_number: null,
+  validate_only: null
+)
+```
+

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

@@ -1245,6 +1245,73 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Get ad account billing
+    # Reads the payments accounts a Google Ads account can be billed to, plus its billing setups and account budgets.  Payments accounts come from Google's PaymentsAccountService, read as the manager above the customer: they are the monthly invoicing (consolidated billing) accounts of that manager. An empty `paymentsAccounts` means the manager has no monthly invoicing, so billing cannot be set up through the API and has to be added in Google Ads. Billing setups and account budgets are read live from Google with their status. Results are cached for 10 minutes and dropped on every setup through Zernio.
+    # @param account_id [String] Google ads SocialAccount id.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Google Ads customer id, digits only. Defaults to the connection's selected customer.
+    # @return [GetAdAccountBilling200Response]
+    def get_ad_account_billing(account_id, opts = {})
+      data, _status_code, _headers = get_ad_account_billing_with_http_info(account_id, opts)
+      data
+    end
+
+    # Get ad account billing
+    # Reads the payments accounts a Google Ads account can be billed to, plus its billing setups and account budgets.  Payments accounts come from Google's PaymentsAccountService, read as the manager above the customer: they are the monthly invoicing (consolidated billing) accounts of that manager. An empty `paymentsAccounts` means the manager has no monthly invoicing, so billing cannot be set up through the API and has to be added in Google Ads. Billing setups and account budgets are read live from Google with their status. Results are cached for 10 minutes and dropped on every setup through Zernio.
+    # @param account_id [String] Google ads SocialAccount id.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ad_account_id Google Ads customer id, digits only. Defaults to the connection's selected customer.
+    # @return [Array<(GetAdAccountBilling200Response, Integer, Hash)>] GetAdAccountBilling200Response data, response status code and response headers
+    def get_ad_account_billing_with_http_info(account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdAccountsApi.get_ad_account_billing ...'
+      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 AdAccountsApi.get_ad_account_billing"
+      end
+      # resource path
+      local_var_path = '/v1/ads/accounts/billing'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'accountId'] = account_id
+      query_params[:'adAccountId'] = opts[:'ad_account_id'] if !opts[:'ad_account_id'].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] || 'GetAdAccountBilling200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdAccountsApi.get_ad_account_billing",
+        :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: AdAccountsApi#get_ad_account_billing\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Ad account finances
     # Shows a Meta ad account's balance, total spend, spend cap and funding source.  Finances of one Meta ad account: prepaid `balance`, lifetime `amountSpent`, account `spendCap` (null = no cap) and the `fundingSource`. Money values are converted from Meta's minor units to whole units of `currency`.
     # @param account_id [String] Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
@@ -4752,6 +4819,74 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Set up ad account billing (monthly invoicing)
+    # Bills a Google Ads account to a monthly invoicing payments account of a manager above it, and proposes its account budget, so the account can serve without anyone opening Google Ads.  Monthly invoicing only. Google's API cannot add a card or other payment method, so `paymentsAccountId` must be one of the manager's monthly invoicing (consolidated billing) payments accounts listed by GET /v1/ads/accounts/billing. A manager without monthly invoicing has none, and billing has to be added in Google Ads instead.  Creates a billing setup (Google's BillingSetupService) that starts now on that payments account, then an account budget proposal that starts now and never ends: unlimited by default, or capped at `spendingLimit` in the account currency. Google reviews the budget offline, usually within an hour; until then the setup reads `APPROVED_HELD` and ads do not serve. A customer whose current billing setup already has a budget is refused with 409, and so is one billed to another payments account: this call never replaces existing billing. A current setup on the same payments account without a budget (for example after a budget rejection) is reused, so resending the same request finishes it.  Not idempotent and never retried: after a 502 with details.creationStatus=unknown, read GET /v1/ads/accounts/billing before retrying. Google has no dry run for billing setups, so `validateOnly: true` checks the payments account and the existing billing without creating anything (and asks Google to validate the budget when a setup would be reused).
+    # @param set_up_ad_account_billing_request [SetUpAdAccountBillingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SetUpAdAccountBilling200Response]
+    def set_up_ad_account_billing(set_up_ad_account_billing_request, opts = {})
+      data, _status_code, _headers = set_up_ad_account_billing_with_http_info(set_up_ad_account_billing_request, opts)
+      data
+    end
+
+    # Set up ad account billing (monthly invoicing)
+    # Bills a Google Ads account to a monthly invoicing payments account of a manager above it, and proposes its account budget, so the account can serve without anyone opening Google Ads.  Monthly invoicing only. Google&#39;s API cannot add a card or other payment method, so &#x60;paymentsAccountId&#x60; must be one of the manager&#39;s monthly invoicing (consolidated billing) payments accounts listed by GET /v1/ads/accounts/billing. A manager without monthly invoicing has none, and billing has to be added in Google Ads instead.  Creates a billing setup (Google&#39;s BillingSetupService) that starts now on that payments account, then an account budget proposal that starts now and never ends: unlimited by default, or capped at &#x60;spendingLimit&#x60; in the account currency. Google reviews the budget offline, usually within an hour; until then the setup reads &#x60;APPROVED_HELD&#x60; and ads do not serve. A customer whose current billing setup already has a budget is refused with 409, and so is one billed to another payments account: this call never replaces existing billing. A current setup on the same payments account without a budget (for example after a budget rejection) is reused, so resending the same request finishes it.  Not idempotent and never retried: after a 502 with details.creationStatus&#x3D;unknown, read GET /v1/ads/accounts/billing before retrying. Google has no dry run for billing setups, so &#x60;validateOnly: true&#x60; checks the payments account and the existing billing without creating anything (and asks Google to validate the budget when a setup would be reused).
+    # @param set_up_ad_account_billing_request [SetUpAdAccountBillingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SetUpAdAccountBilling200Response, Integer, Hash)>] SetUpAdAccountBilling200Response data, response status code and response headers
+    def set_up_ad_account_billing_with_http_info(set_up_ad_account_billing_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdAccountsApi.set_up_ad_account_billing ...'
+      end
+      # verify the required parameter 'set_up_ad_account_billing_request' is set
+      if @api_client.config.client_side_validation && set_up_ad_account_billing_request.nil?
+        fail ArgumentError, "Missing the required parameter 'set_up_ad_account_billing_request' when calling AdAccountsApi.set_up_ad_account_billing"
+      end
+      # resource path
+      local_var_path = '/v1/ads/accounts/billing'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # 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']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(set_up_ad_account_billing_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SetUpAdAccountBilling200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdAccountsApi.set_up_ad_account_billing",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdAccountsApi#set_up_ad_account_billing\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update account callouts
     # Edits existing Google Ads callouts in place; the change applies everywhere that callout is used.  Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists. 
     # @param update_account_callouts_request [UpdateAccountCalloutsRequest]