fix(source-google-analytics-data-api): improve error messages and 403 handling (#76185)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: bot_apk <apk@cognition.ai>
Co-authored-by: suisui.xia <suisui.xia@airbyte.io>

Author: 3 people

airbyte-integrations/connectors/source-google-analytics-data-api/manifest.yaml

@@ -183,10 +183,20 @@ definitions:
         - type: ConstantBackoffStrategy
           backoff_time_in_seconds: 30
       response_filters:
-        - predicate: ""
+        - type: HttpResponseFilter
+          http_codes: [400]
           action: FAIL
           failure_type: config_error
-          error_message: "Incorrect Property ID. Access was denied to the property ID entered. Check your access to the Property ID or use Google Analytics https://developers.google.com/analytics/devguides/reporting/data/v1/property-id#what_is_my_property_id to find your Property ID."
+          error_message: "{{ response.error.message }}"
+        - type: HttpResponseFilter
+          predicate: "{{ response.error.status == 'PERMISSION_DENIED' }}"
+          action: FAIL
+          failure_type: config_error
+          error_message: "{{ response.error.message }}"
+        - type: HttpResponseFilter
+          http_codes: [403]
+          action: RETRY
+          error_message: "{{ response.error.message }}"
 
 dynamic_streams:
   - type: DynamicDeclarativeStream

airbyte-integrations/connectors/source-google-analytics-data-api/metadata.yaml

@@ -12,7 +12,7 @@ data:
   connectorSubtype: api
   connectorType: source
   definitionId: 3cc2eafd-84aa-4dca-93af-322d9dfeec1a
-  dockerImageTag: 2.9.30
+  dockerImageTag: 2.9.31
   dockerRepository: airbyte/source-google-analytics-data-api
   documentationUrl: https://docs.airbyte.com/integrations/sources/google-analytics-data-api
   externalDocumentationUrls:

docs/integrations/sources/google-analytics-data-api.md

@@ -280,6 +280,7 @@ The Google Analytics connector is subject to Google Analytics Data API quotas. P
 
 | Version        | Date       | Pull Request                                             | Subject                                                                                                                                                                |
 |:---------------|:-----------|:---------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 2.9.31 | 2026-04-09 | [76185](https://github.com/airbytehq/airbyte/pull/76185) | Improve error messages for HTTP 400/403 responses; use predicate-based 403 handling to distinguish permission errors (config_error) from other 403s (retry) |
 | 2.9.30 | 2026-04-09 | [76190](https://github.com/airbytehq/airbyte/pull/76190) | Add access_token to extract_output and complete_oauth_output_specification to fix OAuth secretId 422 regression |
 | 2.9.29 | 2026-04-01 | [75580](https://github.com/airbytehq/airbyte/pull/75580) | Add `oauth_connector_input_specification` with granular scopes |
 | 2.9.28 | 2026-03-31 | [75678](https://github.com/airbytehq/airbyte/pull/75678) | Update dependencies |