overlay: 1.0.0
info:
  title: API Evangelist overlay — Google Analytics Admin accounts properties API
  version: 1.0.0
extends: ../openapi/google-analytics-properties-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/google-analytics-properties-api-openapi.yml plus the artifacts in this repository
x-provider: Google Analytics
x-providerId: google-analytics
actions:
- target: $.info
  description: Record provenance and lifecycle context on the document.
  update:
    x-api-evangelist:
      provenance: Converted by API Evangelist from the Google API Discovery document. Google publishes
        no OpenAPI for Google Analytics.
      discovery: discovery/
      protobuf: grpc/
      note: 'GA4-era surface. Authentication, quota, error-envelope and pagination semantics for this
        API are documented in conventions/google-analytics-conventions.yml, authentication/google-analytics-authentication.yml,
        scopes/google-analytics-scopes.yml, rate-limits/google-analytics-rate-limits.yml and errors/google-analytics-problem-types.yml.
        Live base URL: https://analyticsadmin.googleapis.com. Source of truth for this contract is Google''s
        API Discovery document (discovery/) and the .proto service definitions (grpc/); this OpenAPI is
        an API Evangelist conversion, not a Google-published artifact.'
      lifecycle: lifecycle/google-analytics-lifecycle.yml
      conventions: conventions/google-analytics-conventions.yml
      errors: errors/google-analytics-problem-types.yml
      rate_limits: rate-limits/google-analytics-rate-limits.yml
      authentication: authentication/google-analytics-authentication.yml
      scopes: scopes/google-analytics-scopes.yml
- target: $.paths.*.*
  description: Attach the error catalog and quota category reference to every operation.
  update:
    x-error-catalog: errors/google-analytics-problem-types.yml
    x-rate-limits: rate-limits/google-analytics-rate-limits.yml
    x-idempotent: false
- target: $.servers
  description: DEFECT NOTE — this document mixes two services. Operations whose operationId begins analyticsadmin.
    are served by https://analyticsadmin.googleapis.com; operations whose operationId begins analyticsdata.
    are served by https://analyticsdata.googleapis.com. The single servers[] entry below is correct for
    the admin operations only. The original document is not mutated; this overlay records the split.
  update: {}