feat: [AnalyticsData] remove SheetExportAudienceList method, associated resources, and OAuth scopes from v1 alpha (#9145)

* fix!: remove SheetExportAudienceList method, associated resources, and OAuth scopes from v1 alpha
feat: add RunReport and GetMetadata methods to v1 alpha
feat: add Metadata, Comparison, ComparisonMetadata, and ConversionMetadata types to v1 alpha
feat: add the ConversionSpec field to the RunReportRequest resource in v1 alpha
feat: add the Section field to the ResponseMetaData resource in v1 alpha
feat: add the conversions field to the Metadata response in v1 alpha
feat: add the sections field to the DimensionMetadata in v1 alpha
docs: update documentation for sampling_metadatas
docs: update copyright year to 2026 in proto files

PiperOrigin-RevId: 907145766

Source-Link: googleapis/googleapis@97bcfbd

Source-Link: googleapis/googleapis-gen@f7d8b88
Copy-Tag: eyJwIjoiQW5hbHl0aWNzRGF0YS8uT3dsQm90LnlhbWwiLCJoIjoiZjdkOGI4ODRjMmQ0OWRjZTFhMjRiMDdjODdjOTg5MDk3NmQwMTVkMSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

AnalyticsData/metadata/V1Alpha/AnalyticsDataApi.php

@@ -0,0 +1,90 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetMetadata_sync]
+use Google\Analytics\Data\V1alpha\Client\AlphaAnalyticsDataClient;
+use Google\Analytics\Data\V1alpha\GetMetadataRequest;
+use Google\Analytics\Data\V1alpha\Metadata;
+use Google\ApiCore\ApiException;
+
+/**
+ * Returns metadata for dimensions and metrics available in reporting methods.
+ * Used to explore the dimensions and metrics. In this method, a Google
+ * Analytics property identifier is specified in the request, and
+ * the metadata response includes Custom dimensions and metrics as well as
+ * Universal metadata.
+ *
+ * For example if a custom metric with parameter name `levels_unlocked` is
+ * registered to a property, the Metadata response will contain
+ * `customEvent:levels_unlocked`. Universal metadata are dimensions and
+ * metrics applicable to any property such as `country` and `totalUsers`.
+ *
+ * @param string $formattedName The resource name of the metadata to retrieve. This name field is
+ *                              specified in the URL path and not URL parameters. Property is a numeric
+ *                              Google Analytics property identifier. To learn more, see [where to find
+ *                              your Property
+ *                              ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
+ *
+ *                              Example: properties/1234/metadata
+ *
+ *                              Set the Property ID to 0 for dimensions and metrics common to all
+ *                              properties. In this special mode, this method will not return custom
+ *                              dimensions and metrics. Please see
+ *                              {@see AlphaAnalyticsDataClient::metadataName()} for help formatting this field.
+ */
+function get_metadata_sample(string $formattedName): void
+{
+    // Create a client.
+    $alphaAnalyticsDataClient = new AlphaAnalyticsDataClient();
+
+    // Prepare the request message.
+    $request = (new GetMetadataRequest())
+        ->setName($formattedName);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var Metadata $response */
+        $response = $alphaAnalyticsDataClient->getMetadata($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedName = AlphaAnalyticsDataClient::metadataName('[PROPERTY]');
+
+    get_metadata_sample($formattedName);
+}
+// [END analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetMetadata_sync]

AnalyticsData/metadata/V1Alpha/Data.php

@@ -0,0 +1,83 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START analyticsdata_v1alpha_generated_AlphaAnalyticsData_RunReport_sync]
+use Google\Analytics\Data\V1alpha\Client\AlphaAnalyticsDataClient;
+use Google\Analytics\Data\V1alpha\RunReportRequest;
+use Google\Analytics\Data\V1alpha\RunReportResponse;
+use Google\ApiCore\ApiException;
+
+/**
+ * Returns a customized report of your Google Analytics event data. Reports
+ * contain statistics derived from data collected by the Google Analytics
+ * tracking code. The data returned from the API is as a table with columns
+ * for the requested dimensions and metrics. Metrics are individual
+ * measurements of user activity on your property, such as active users or
+ * event count. Dimensions break down metrics across some common criteria,
+ * such as country or event name.
+ *
+ * @param string $property A Google Analytics property identifier whose events are tracked.
+ *                         Specified in the URL path and not the body. To learn more, see [where to
+ *                         find your Property
+ *                         ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
+ *                         Within a batch request, this property should either be unspecified or
+ *                         consistent with the batch-level property.
+ *
+ *                         Example: properties/1234
+ */
+function run_report_sample(string $property): void
+{
+    // Create a client.
+    $alphaAnalyticsDataClient = new AlphaAnalyticsDataClient();
+
+    // Prepare the request message.
+    $request = (new RunReportRequest())
+        ->setProperty($property);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var RunReportResponse $response */
+        $response = $alphaAnalyticsDataClient->runReport($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $property = '[PROPERTY]';
+
+    run_report_sample($property);
+}
+// [END analyticsdata_v1alpha_generated_AlphaAnalyticsData_RunReport_sync]

AnalyticsData/samples/V1alpha/AlphaAnalyticsDataClient/get_metadata.php

@@ -30,13 +30,17 @@
 use Google\Analytics\Data\V1alpha\CreateAudienceListRequest;
 use Google\Analytics\Data\V1alpha\CreateRecurringAudienceListRequest;
 use Google\Analytics\Data\V1alpha\CreateReportTaskRequest;
+use Google\Analytics\Data\V1alpha\Dimension;
 use Google\Analytics\Data\V1alpha\GetAudienceListRequest;
+use Google\Analytics\Data\V1alpha\GetMetadataRequest;
 use Google\Analytics\Data\V1alpha\GetPropertyQuotasSnapshotRequest;
 use Google\Analytics\Data\V1alpha\GetRecurringAudienceListRequest;
 use Google\Analytics\Data\V1alpha\GetReportTaskRequest;
 use Google\Analytics\Data\V1alpha\ListAudienceListsRequest;
 use Google\Analytics\Data\V1alpha\ListRecurringAudienceListsRequest;
 use Google\Analytics\Data\V1alpha\ListReportTasksRequest;
+use Google\Analytics\Data\V1alpha\Metadata;
+use Google\Analytics\Data\V1alpha\Metric;
 use Google\Analytics\Data\V1alpha\PropertyQuotasSnapshot;
 use Google\Analytics\Data\V1alpha\QueryAudienceListRequest;
 use Google\Analytics\Data\V1alpha\QueryAudienceListResponse;
@@ -46,9 +50,9 @@
 use Google\Analytics\Data\V1alpha\ReportTask;
 use Google\Analytics\Data\V1alpha\RunFunnelReportRequest;
 use Google\Analytics\Data\V1alpha\RunFunnelReportResponse;
+use Google\Analytics\Data\V1alpha\RunReportRequest;
+use Google\Analytics\Data\V1alpha\RunReportResponse;
 use Google\Analytics\Data\V1alpha\Segment;
-use Google\Analytics\Data\V1alpha\SheetExportAudienceListRequest;
-use Google\Analytics\Data\V1alpha\SheetExportAudienceListResponse;
 use Google\ApiCore\ApiException;
 use Google\ApiCore\CredentialsWrapper;
 use Google\ApiCore\GapicClientTrait;
@@ -82,6 +86,7 @@
  * @method PromiseInterface<RecurringAudienceList> createRecurringAudienceListAsync(CreateRecurringAudienceListRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<OperationResponse> createReportTaskAsync(CreateReportTaskRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<AudienceList> getAudienceListAsync(GetAudienceListRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface<Metadata> getMetadataAsync(GetMetadataRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<PropertyQuotasSnapshot> getPropertyQuotasSnapshotAsync(GetPropertyQuotasSnapshotRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<RecurringAudienceList> getRecurringAudienceListAsync(GetRecurringAudienceListRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<ReportTask> getReportTaskAsync(GetReportTaskRequest $request, array $optionalArgs = [])
@@ -91,7 +96,7 @@
  * @method PromiseInterface<QueryAudienceListResponse> queryAudienceListAsync(QueryAudienceListRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<QueryReportTaskResponse> queryReportTaskAsync(QueryReportTaskRequest $request, array $optionalArgs = [])
  * @method PromiseInterface<RunFunnelReportResponse> runFunnelReportAsync(RunFunnelReportRequest $request, array $optionalArgs = [])
- * @method PromiseInterface<SheetExportAudienceListResponse> sheetExportAudienceListAsync(SheetExportAudienceListRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface<RunReportResponse> runReportAsync(RunReportRequest $request, array $optionalArgs = [])
  */
 final class AlphaAnalyticsDataClient
 {
@@ -121,9 +126,6 @@ final class AlphaAnalyticsDataClient
     public static $serviceScopes = [
         'https://www.googleapis.com/auth/analytics',
         'https://www.googleapis.com/auth/analytics.readonly',
-        'https://www.googleapis.com/auth/drive',
-        'https://www.googleapis.com/auth/drive.file',
-        'https://www.googleapis.com/auth/spreadsheets',
     ];
 
     private $operationsClient;
@@ -218,6 +220,23 @@ public static function audienceListName(string $property, string $audienceList):
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a metadata
+     * resource.
+     *
+     * @param string $property
+     *
+     * @return string The formatted metadata resource.
+     *
+     * @experimental
+     */
+    public static function metadataName(string $property): string
+    {
+        return self::getPathTemplate('metadata')->render([
+            'property' => $property,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a property
      * resource.
@@ -295,6 +314,7 @@ public static function reportTaskName(string $property, string $reportTask): str
      * The following name formats are supported:
      * Template: Pattern
      * - audienceList: properties/{property}/audienceLists/{audience_list}
+     * - metadata: properties/{property}/metadata
      * - property: properties/{property}
      * - propertyQuotasSnapshot: properties/{property}/propertyQuotasSnapshot
      * - recurringAudienceList: properties/{property}/recurringAudienceLists/{recurring_audience_list}
@@ -584,6 +604,43 @@ public function getAudienceList(GetAudienceListRequest $request, array $callOpti
         return $this->startApiCall('GetAudienceList', $request, $callOptions)->wait();
     }
 
+    /**
+     * Returns metadata for dimensions and metrics available in reporting methods.
+     * Used to explore the dimensions and metrics. In this method, a Google
+     * Analytics property identifier is specified in the request, and
+     * the metadata response includes Custom dimensions and metrics as well as
+     * Universal metadata.
+     *
+     * For example if a custom metric with parameter name `levels_unlocked` is
+     * registered to a property, the Metadata response will contain
+     * `customEvent:levels_unlocked`. Universal metadata are dimensions and
+     * metrics applicable to any property such as `country` and `totalUsers`.
+     *
+     * The async variant is {@see AlphaAnalyticsDataClient::getMetadataAsync()} .
+     *
+     * @example samples/V1alpha/AlphaAnalyticsDataClient/get_metadata.php
+     *
+     * @param GetMetadataRequest $request     A request to house fields associated with the call.
+     * @param array              $callOptions {
+     *     Optional.
+     *
+     *     @type RetrySettings|array $retrySettings
+     *           Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
+     *           associative array of retry settings parameters. See the documentation on
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return Metadata
+     *
+     * @throws ApiException Thrown if the API call fails.
+     *
+     * @experimental
+     */
+    public function getMetadata(GetMetadataRequest $request, array $callOptions = []): Metadata
+    {
+        return $this->startApiCall('GetMetadata', $request, $callOptions)->wait();
+    }
+
     /**
      * Get all property quotas organized by quota category for a given property.
      * This will charge 1 property quota from the category with the most quota.
@@ -921,33 +978,20 @@ public function runFunnelReport(RunFunnelReportRequest $request, array $callOpti
     }
 
     /**
-     * Exports an audience list of users to a Google Sheet. After creating an
-     * audience, the users are not immediately available for listing. First, a
-     * request to `CreateAudienceList` is necessary to create an audience list of
-     * users, and then second, this method is used to export those users in the
-     * audience list to a Google Sheet.
+     * Returns a customized report of your Google Analytics event data. Reports
+     * contain statistics derived from data collected by the Google Analytics
+     * tracking code. The data returned from the API is as a table with columns
+     * for the requested dimensions and metrics. Metrics are individual
+     * measurements of user activity on your property, such as active users or
+     * event count. Dimensions break down metrics across some common criteria,
+     * such as country or event name.
      *
-     * See [Creating an Audience
-     * List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
-     * for an introduction to Audience Lists with examples.
+     * The async variant is {@see AlphaAnalyticsDataClient::runReportAsync()} .
      *
-     * Audiences in Google Analytics 4 allow you to segment your users in the ways
-     * that are important to your business. To learn more, see
-     * https://support.google.com/analytics/answer/9267572.
-     *
-     * This method is introduced at alpha stability with the intention of
-     * gathering feedback on syntax and capabilities before entering beta. To give
-     * your feedback on this API, complete the
-     * [Google Analytics Audience Export API
-     * Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
-     *
-     * The async variant is
-     * {@see AlphaAnalyticsDataClient::sheetExportAudienceListAsync()} .
+     * @example samples/V1alpha/AlphaAnalyticsDataClient/run_report.php
      *
-     * @example samples/V1alpha/AlphaAnalyticsDataClient/sheet_export_audience_list.php
-     *
-     * @param SheetExportAudienceListRequest $request     A request to house fields associated with the call.
-     * @param array                          $callOptions {
+     * @param RunReportRequest $request     A request to house fields associated with the call.
+     * @param array            $callOptions {
      *     Optional.
      *
      *     @type RetrySettings|array $retrySettings
@@ -956,16 +1000,14 @@ public function runFunnelReport(RunFunnelReportRequest $request, array $callOpti
      *           {@see RetrySettings} for example usage.
      * }
      *
-     * @return SheetExportAudienceListResponse
+     * @return RunReportResponse
      *
      * @throws ApiException Thrown if the API call fails.
      *
      * @experimental
      */
-    public function sheetExportAudienceList(
-        SheetExportAudienceListRequest $request,
-        array $callOptions = []
-    ): SheetExportAudienceListResponse {
-        return $this->startApiCall('SheetExportAudienceList', $request, $callOptions)->wait();
+    public function runReport(RunReportRequest $request, array $callOptions = []): RunReportResponse
+    {
+        return $this->startApiCall('RunReport', $request, $callOptions)->wait();
     }
 }