# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Google Analytics Accounts API
  version: 1.0.0
extends: openapi/google-analytics-accounts-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 26
- target: $.paths['/v1beta/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List accessible Analytics accounts (v1beta)
      effect: read
      questions:
      - Which Google Analytics accounts can I reach through the v1beta Admin API accounts list?
      - Can the v1beta accounts list include accounts I've moved to the trash?
      instructions:
      - text: List every Analytics account I can access using the v1beta Admin API.
      - text: List my Analytics accounts via v1beta, including trashed ones, {pageSize} per page.
        slots:
          pageSize: query.pageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts:provisionAccountTicket'].post
  update:
    x-apievangelist-phrasing:
      intent: Request an account-creation ticket (v1beta)
      effect: write
      questions:
      - What does the v1beta provisionAccountTicket call give me when setting up a new Analytics account?
      - Where does the user land after accepting the Terms of Service on a v1beta account ticket?
      instructions:
      - text: Request a v1beta ticket to create a new Analytics account that redirects to {redirectUri} after Terms of Service.
        slots:
          redirectUri: requestBody.redirectUri
      - text: Get a v1beta account-creation ticket for an account named in {account}.
        slots:
          account: requestBody.account
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/{account}:searchChangeHistoryEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: Search account change history by resource name
      effect: read
      questions:
      - Who changed settings in my Analytics account, looked up by its accounts/ resource name?
      - Can I narrow v1beta change history by the email of the person who made the change?
      - What changes were made to one property under an account between two dates?
      instructions:
      - text: Search the change history of account resource {account} made by {actorEmail}.
        slots:
          account: path.account
          actorEmail: requestBody.actorEmail
      - text: Show changes to account resource {account} made after {earliestChangeTime}.
        slots:
          account: path.account
          earliestChangeTime: requestBody.earliestChangeTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one Analytics account (v1alpha)
      effect: read
      questions:
      - How do I fetch a single Analytics account's details with the v1alpha Admin API?
      - Can the v1alpha endpoint tell me an account's display name and country of business?
      instructions:
      - text: Get Analytics account {accountsId} using the v1alpha endpoint.
        slots:
          accountsId: path.accountsId
      - text: Look up account {name} via v1alpha, id {accountsId}.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Trash an Analytics account (v1alpha)
      effect: destructive
      questions:
      - Can a trashed Analytics account be restored after I delete it through v1alpha?
      - What happens to properties and streams when I soft-delete an account with the v1alpha API?
      instructions:
      - text: Move Analytics account {accountsId} to the trash using v1alpha.
        slots:
          accountsId: path.accountsId
      - text: Soft-delete account {name} (id {accountsId}) with the v1alpha delete call.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Analytics account (v1alpha)
      effect: write
      questions:
      - Can I rename an Analytics account using the v1alpha Admin API?
      - Which account fields must I list in the update mask for a v1alpha account update?
      instructions:
      - text: Rename account {accountsId} to {displayName} using v1alpha.
        slots:
          accountsId: path.accountsId
          displayName: requestBody.displayName
      - text: Set the country of business on account {accountsId} to {regionCode} via v1alpha.
        slots:
          accountsId: path.accountsId
          regionCode: requestBody.regionCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/dataSharingSettings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account's data sharing settings (v1alpha)
      effect: read
      questions:
      - What data sharing options are turned on for my Analytics account, per the v1alpha API?
      - Where do I read an account's data sharing settings in the v1alpha Admin API?
      instructions:
      - text: Show the data sharing settings for account {accountsId} using v1alpha.
        slots:
          accountsId: path.accountsId
      - text: Fetch v1alpha data sharing settings {name} for account {accountsId}.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List accessible Analytics accounts (v1alpha)
      effect: read
      questions:
      - Which Analytics accounts does the v1alpha Admin API return for my login?
      - Does the v1alpha account list leave out trashed accounts unless I ask for them?
      instructions:
      - text: List all Analytics accounts I can access through the v1alpha endpoint.
      - text: List my v1alpha Analytics accounts, including soft-deleted ones, {pageSize} at a time.
        slots:
          pageSize: query.pageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts:provisionAccountTicket'].post
  update:
    x-apievangelist-phrasing:
      intent: Request an account-creation ticket (v1alpha)
      effect: write
      questions:
      - How do I start creating a new Analytics account through a v1alpha provisioning ticket?
      - Does the v1alpha account ticket need a redirect URI configured in the Cloud Console?
      instructions:
      - text: Request a v1alpha account-creation ticket that sends the user to {redirectUri} after accepting terms.
        slots:
          redirectUri: requestBody.redirectUri
      - text: Open a v1alpha ticket to create the Analytics account described in {account}.
        slots:
          account: requestBody.account
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}:runAccessReport'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an account data access report (v1alpha)
      effect: read
      questions:
      - Who has been reading reporting data in my Analytics account, according to the v1alpha access report?
      - How far back do v1alpha data access records go for an account?
      - Can the v1alpha access report expand user groups into individual users?
      instructions:
      - text: Run a v1alpha data access report for account {accountsId} over {dateRanges}.
        slots:
          accountsId: path.accountsId
          dateRanges: requestBody.dateRanges
      - text: Show v1alpha access records for {entity} broken down by {dimensions}, limited to {limit} rows.
        slots:
          entity: query.entity
          dimensions: requestBody.dimensions
          limit: requestBody.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}:searchChangeHistoryEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: Search account change history (v1alpha)
      effect: read
      questions:
      - What changes happened in my Analytics account recently, via the v1alpha change history search?
      - Can the v1alpha change history search filter by resource type, like only property changes?
      instructions:
      - text: Search v1alpha change history for account {accountsId} filtered to actions {action}.
        slots:
          accountsId: path.accountsId
          action: requestBody.action
      - text: List v1alpha changes to account {accountsId} made before {latestChangeTime}.
        slots:
          accountsId: path.accountsId
          latestChangeTime: requestBody.latestChangeTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings:batchCreate'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant several users access at once
      effect: write
      questions:
      - Can I add many users to an Analytics account in one request?
      - If one of the new access bindings fails, are the others still created?
      instructions:
      - text: 'Batch-create these access bindings on account {accountsId}: {requests}.'
        slots:
          accountsId: path.accountsId
          requests: requestBody.requests
      - text: Grant roles to multiple users under {parent} in a single transaction.
        slots:
          parent: query.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings:batchDelete'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove several users' access at once
      effect: destructive
      questions:
      - Can I revoke access for a batch of users from an Analytics account together?
      - What's the maximum number of access bindings I can remove in one bulk request?
      instructions:
      - text: 'Batch-delete these access bindings from account {accountsId}: {requests}.'
        slots:
          accountsId: path.accountsId
          requests: requestBody.requests
      - text: Remove multiple users' links from {parent} in one call.
        slots:
          parent: query.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings:batchGet'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several named access bindings
      effect: read
      questions:
      - Can I look up several specific access bindings by name in one request?
      - What roles do a handful of named user bindings on my account have?
      instructions:
      - text: Get access bindings {names} on account {accountsId}.
        slots:
          names: query.names
          accountsId: path.accountsId
      - text: Batch-fetch the named access bindings under {parent}.
        slots:
          parent: query.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings:batchUpdate'].post
  update:
    x-apievangelist-phrasing:
      intent: Change roles for several users at once
      effect: write
      questions:
      - Can I change the roles of many users on an Analytics account in a single request?
      - How many access bindings can one bulk role update touch?
      instructions:
      - text: 'Batch-update these access bindings on account {accountsId}: {requests}.'
        slots:
          accountsId: path.accountsId
          requests: requestBody.requests
      - text: Apply role changes to multiple existing bindings under {parent}.
        slots:
          parent: query.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List who has access to an account
      effect: read
      questions:
      - Who currently has access to my Google Analytics account and with which roles?
      - Is there a way to page through every user permission on an account?
      instructions:
      - text: List all access bindings on account {accountsId}.
        slots:
          accountsId: path.accountsId
      - text: List users with access to {parent}, {pageSize} per page.
        slots:
          parent: query.parent
          pageSize: query.pageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant one user access to an account
      effect: write
      questions:
      - How do I give a colleague viewer access to my Analytics account?
      - Which predefined roles can I grant a single user on an account?
      instructions:
      - text: Give {user} the roles {roles} on account {accountsId}.
        slots:
          user: requestBody.user
          roles: requestBody.roles
          accountsId: path.accountsId
      - text: Add {user} as a new user on {parent}.
        slots:
          user: requestBody.user
          parent: query.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings/{accessBindingsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one user's access binding
      effect: read
      questions:
      - What roles does one particular access binding grant on my account?
      - Can I check a single user's permission record by its binding ID?
      instructions:
      - text: Show access binding {accessBindingsId} on account {accountsId}.
        slots:
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
      - text: Get the access binding named {name}, id {accessBindingsId} under account {accountsId}.
        slots:
          name: query.name
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings/{accessBindingsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke one user's access
      effect: destructive
      questions:
      - How do I remove a single person's access to my Analytics account?
      - Can I delete one access binding without touching the others?
      instructions:
      - text: Delete access binding {accessBindingsId} from account {accountsId}.
        slots:
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
      - text: Revoke the access granted by binding {name} (id {accessBindingsId}) on account {accountsId}.
        slots:
          name: query.name
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1alpha/accounts/{accountsId}/accessBindings/{accessBindingsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one user's roles
      effect: write
      questions:
      - Can I promote one user from viewer to editor on my Analytics account?
      - What happens to a user's existing roles when I update their single access binding?
      instructions:
      - text: Set the roles on access binding {accessBindingsId} in account {accountsId} to {roles}.
        slots:
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
          roles: requestBody.roles
      - text: Update binding {name} (id {accessBindingsId}, account {accountsId}) to grant {roles}.
        slots:
          name: query.name
          accessBindingsId: path.accessBindingsId
          accountsId: path.accountsId
          roles: requestBody.roles
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one Analytics account (v1beta)
      effect: read
      questions:
      - Where do I get a single account's details from the v1beta Admin API?
      - Does the v1beta account lookup show whether the account is in the trash?
      instructions:
      - text: Get Analytics account {accountsId} from the v1beta endpoint.
        slots:
          accountsId: path.accountsId
      - text: Look up account {name} (id {accountsId}) with v1beta.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Trash an Analytics account (v1beta)
      effect: destructive
      questions:
      - Is deleting an account with the v1beta Admin API permanent or can I restore it from the Trash Can?
      - Which child resources are purged if a v1beta-trashed account isn't restored in time?
      instructions:
      - text: Trash Analytics account {accountsId} using the v1beta delete endpoint.
        slots:
          accountsId: path.accountsId
      - text: Soft-delete account {name} (id {accountsId}) via v1beta.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Analytics account (v1beta)
      effect: write
      questions:
      - Can I change an account's display name with the v1beta Admin API?
      - Is the update mask required when updating an account through v1beta?
      instructions:
      - text: Rename account {accountsId} to {displayName} with v1beta.
        slots:
          accountsId: path.accountsId
          displayName: requestBody.displayName
      - text: Update account {accountsId} via v1beta, changing only {updateMask}.
        slots:
          accountsId: path.accountsId
          updateMask: query.updateMask
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}/dataSharingSettings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account's data sharing settings (v1beta)
      effect: read
      questions:
      - Is my Analytics account sharing data with Google, per the v1beta data sharing settings?
      - Can I read account-level data sharing settings through the v1beta API?
      instructions:
      - text: Get the v1beta data sharing settings for account {accountsId}.
        slots:
          accountsId: path.accountsId
      - text: Read data sharing settings {name} on account {accountsId} with v1beta.
        slots:
          name: query.name
          accountsId: path.accountsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}:runAccessReport'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an account data access report (v1beta)
      effect: read
      questions:
      - Can I audit which users pulled reporting data from my account using the v1beta access report?
      - How many dimensions and metrics can a v1beta data access report request?
      - Does the v1beta access report return my property's current quota state?
      instructions:
      - text: Run a v1beta access report on account {accountsId} for {dateRanges}.
        slots:
          accountsId: path.accountsId
          dateRanges: requestBody.dateRanges
      - text: Pull v1beta data access records for {entity} with metrics {metrics}.
        slots:
          entity: query.entity
          metrics: requestBody.metrics
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1beta/accounts/{accountsId}:searchChangeHistoryEvents'].post
  update:
    x-apievangelist-phrasing:
      intent: Search account change history by account ID (v1beta)
      effect: read
      questions:
      - What was changed in my account last week, searching v1beta change history by numeric account ID?
      - Can I page through v1beta change history events for an account ID?
      instructions:
      - text: Search v1beta change history for account ID {accountsId} on property {property}.
        slots:
          accountsId: path.accountsId
          property: requestBody.property
      - text: List v1beta changes for account ID {accountsId} affecting resource types {resourceType}.
        slots:
          accountsId: path.accountsId
          resourceType: requestBody.resourceType
      method: generated
      generated: '2026-09-26'