zernio-sdk 0.0.816 → 0.0.818

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc07e6c420479acb2fff1475884e90566a8e0441d8f054c24e4ab10ff166a3a2
-  data.tar.gz: 3c2d67a0fb1eb4801c83a9a3a3009c926f0a0758593776c9cd8074c46e47e5a8
+  metadata.gz: 178d9a86c3ca37d445d083262a0adc5b9ce7efe0ae39acc3b3e04990d9862e48
+  data.tar.gz: 75fd49c2c80b9584e3038d3c991cd1e1cf320dda36a3339e08a54c1be77a3db7
 SHA512:
-  metadata.gz: 270bd107f5d79c0735320051b95397810b873ae09454e1e675c3e3504c3e7ee5c05b4728d49cd9d4772c59520d050a321e045b8bf9100d76e360b2cddc4b4a82
-  data.tar.gz: 2ceadbcc2c30843e788039f526598de93eee3bd5f04857fd841263075801e2a098fea6785631fa324a29e6c033e8e7ae1210e028a90512de24bbfd3f22fccb55
+  metadata.gz: de3ec72370eda4c0ff20d2dbea2f97701d0c431ac722ba9c044ecc1e3e338efc1700db25738aae4473d1c65581720a22680d74107a2e596787a2deadae3c0c9e
+  data.tar.gz: 825357536562f978232dbd8770b831f7752f0487fa7c680f60cda1818dea30774377e2cfb117f848f85d1d0b7e43f0e557c61befc9030c99edb88846b7b615ca

data/docs/ConnectApi.md

@@ -1279,7 +1279,7 @@ end
 
 Get pending OAuth data
 
-Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Token is one-time use and expires after 10 minutes. No authentication required. 
+Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required. 
 
 ### Examples
 

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

@@ -1244,7 +1244,7 @@ module Zernio
     end
 
     # Get pending OAuth data
-    # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Token is one-time use and expires after 10 minutes. No authentication required. 
+    # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required. 
     # @param token [String] The pending data token from the OAuth redirect URL (pendingDataToken parameter)
     # @param [Hash] opts the optional parameters
     # @return [GetPendingOAuthData200Response]
@@ -1254,7 +1254,7 @@ module Zernio
     end
 
     # Get pending OAuth data
-    # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Token is one-time use and expires after 10 minutes. No authentication required. 
+    # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required. 
     # @param token [String] The pending data token from the OAuth redirect URL (pendingDataToken parameter)
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetPendingOAuthData200Response, Integer, Hash)>] GetPendingOAuthData200Response data, response status code and response headers

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -20508,9 +20508,9 @@ paths:
       description: |
         Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.
 
-        **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).
+        **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).
 
-        Token is one-time use and expires after 10 minutes. No authentication required.
+        Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required.
       parameters:
         - name: token
           in: query
@@ -40722,6 +40722,8 @@ paths:
         '400':
           description: Invalid input or campaign spans multiple social accounts
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404':
           description: No ads found for this campaign
 
@@ -40805,6 +40807,8 @@ paths:
                   platformSpecificData: { type: object }
         '400': { description: "Invalid input, or a field the resolved platform does not support at the campaign level (see the support table)" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Campaign not found }
         '409': { description: "Campaign is ABO — route to /v1/ads/ad-sets/{adSetId} instead" }
         '501': { description: Operation not supported on this platform }
@@ -40914,6 +40918,8 @@ paths:
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
   /v1/ads/campaigns/{campaignId}/duplicate:
     post:
       x-resource-group: "ads"
@@ -41008,6 +41014,8 @@ paths:
                     description: Platform-native response from the copy endpoint (Meta includes ad_object_ids for child copies)
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Source campaign not found }
         '501': { description: Operation not supported on this platform }
 
@@ -41069,6 +41077,8 @@ paths:
                   raw: { type: object, description: Meta's native copy response (includes ad_object_ids for child copies) }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Source ad set not found }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
@@ -41124,6 +41134,8 @@ paths:
                   raw: { type: object }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad not found }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
@@ -41311,6 +41323,8 @@ paths:
                   platformSpecificData: { type: object }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad set not found }
         '409': { description: "Campaign is CBO — route to /v1/ads/campaigns/{campaignId} instead" }
         '422': { description: "bidStrategy is LOWEST_COST_WITH_MIN_ROAS on OpenAI (unsupported: no ROAS-based bidding)" }
@@ -41406,6 +41420,8 @@ paths:
                   message: { type: string, description: 'Present only where the platform has no ad-set switch and no child ad was actionable' }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad set not found }
 
   /v1/ads/tree:
@@ -41692,6 +41708,8 @@ paths:
         '400':
           description: 'Invalid status transition, budget below minimum, or a LinkedIn creative update without imageUrl or videoUrl'
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { $ref: '#/components/responses/NotFound' }
         '501': { description: "targeting or creative not supported on the platform (supported on Meta, TikTok, and LinkedIn)" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -41762,6 +41780,8 @@ paths:
                   message: { type: string, description: "Human-readable summary (present only when skipped)" }
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Ad not found }
 
   /v1/ads/campaigns/{campaignId}/assets:
@@ -41842,6 +41862,8 @@ paths:
                   structuredSnippetAssetResourceNames: { type: array, items: { type: string } }
         '400': { description: "Invalid input, Google rejected the assets, an unknown customerId (not one of this connection's Google Ads accounts), or a required customerId missing when the connection has multiple Google Ads accounts" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '422': { description: "No Google Ads customer accounts on this connection. Reconnect Google Ads." }
         '501': { description: Only supported on Google Ads }
 
@@ -42488,6 +42510,8 @@ paths:
       responses:
         '200': { description: "Updated" }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: "Ad not found" }
         '405': { description: "Platform has no click-URL tracking surface" }
         '422': { description: "Meta creative cannot be rebuilt (e.g. placement-customized/asset-feed/dark creative)" }
@@ -44012,7 +44036,7 @@ paths:
           description: Missing required fields or invalid values
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+          description: 'Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '409':
           description: |
             An identical boost request is already in progress (with or without
@@ -45069,7 +45093,7 @@ paths:
           description: 'Missing required fields, invalid values, non-Meta platform used with creatives[] / adSetId, or a Meta validateOnly validation failure (verbatim)'
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+          description: 'Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '422':
           description: Platform ads connection required (TikTok Ads, X Ads) or missing linked account
         '502':
@@ -47759,6 +47783,8 @@ paths:
           description: Ad(s) created and submitted for review
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Account not found }
         '422': { description: "No Facebook Page resolved for the account" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -47799,6 +47825,8 @@ paths:
           description: Ad(s) created and submitted for review
         '400': { description: Invalid input }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: 'Returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: Account not found }
         '422': { description: "No Facebook Page resolved for the account" }
         '502': { description: "Meta accepted the request then failed to produce the media (upload session, chunk transfer, processing timeout, or a response with no image hash). Inspect `platformError.reason`." }
@@ -47861,7 +47889,8 @@ paths:
                     multi: '#/components/schemas/CtwaMultiResponse'
         '400': { description: Invalid body. }
         '401': { $ref: '#/components/responses/Unauthorized' }
-        '403': { description: "Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans." }
+        '403':
+          description: 'Forbidden. Also returned with code `ads_allowance_exceeded` when the team has no payment method on file and has reached the 500 free live ads: add a card to resume.'
         '404': { description: SocialAccount not found. }
         '422':
           description: Page is not connected to a verified WhatsApp number.

data/spec/api/connect_api_spec.rb

@@ -257,7 +257,7 @@ describe 'ConnectApi' do
 
   # unit tests for get_pending_o_auth_data
   # Get pending OAuth data
-  # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Token is one-time use and expires after 10 minutes. No authentication required. 
+  # Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.  **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).  Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required. 
   # @param token The pending data token from the OAuth redirect URL (pendingDataToken parameter)
   # @param [Hash] opts the optional parameters
   # @return [GetPendingOAuthData200Response]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.816
+  version: 0.0.818
 platform: ruby
 authors:
 - OpenAPI-Generator