feat: [analyticsdata] add CreateAudienceExport, `QueryAudienceExpor…

…t`, `GetAudienceExport`, `ListAudienceExports` methods to the Data API v1 beta (#10133)

* feat: add `CreateAudienceExport`, `QueryAudienceExport`, `GetAudienceExport`, `ListAudienceExports` methods to the Data API v1 beta
feat: add `sampling_metadatas` field to `ResponseMetaData`
feat: add `SamplingMetadata`, `AudienceExport`, `AudienceExportMetadata`, `AudienceDimensionValue` types
fix!: add `optional` label to `consumed`, `remaining` fields of the `QuotaStatus` type
docs: updated comments

PiperOrigin-RevId: 589214160

Source-Link: googleapis/googleapis@c3ee218

Source-Link: https://github.com/googleapis/googleapis-gen/commit/2ae3038701f796a5c83ff4f12d41c6ab828bb9a7
Copy-Tag: eyJwIjoiamF2YS1hbmFseXRpY3MtZGF0YS8uT3dsQm90LnlhbWwiLCJoIjoiMmFlMzAzODcwMWY3OTZhNWM4M2ZmNGYxMmQ0MWM2YWI4MjhiYjlhNyJ9

* 🦉 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>
Co-authored-by: Tomo Suzuki <suztomo@google.com>

java-analytics-data/README.md

@@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.analytics/google-analytics-data.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.analytics/google-analytics-data/0.41.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.analytics/google-analytics-data/0.42.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-analytics-data/google-analytics-data/src/main/java/com/google/analytics/data/v1beta/BetaAnalyticsDataSettings.java

@@ -16,6 +16,8 @@
 
 package com.google.analytics.data.v1beta;
 
+import static com.google.analytics.data.v1beta.BetaAnalyticsDataClient.ListAudienceExportsPagedResponse;
+
 import com.google.analytics.data.v1beta.stub.BetaAnalyticsDataStubSettings;
 import com.google.api.core.ApiFunction;
 import com.google.api.core.BetaApi;
@@ -26,8 +28,11 @@
 import com.google.api.gax.rpc.ApiClientHeaderProvider;
 import com.google.api.gax.rpc.ClientContext;
 import com.google.api.gax.rpc.ClientSettings;
+import com.google.api.gax.rpc.OperationCallSettings;
+import com.google.api.gax.rpc.PagedCallSettings;
 import com.google.api.gax.rpc.TransportChannelProvider;
 import com.google.api.gax.rpc.UnaryCallSettings;
+import com.google.longrunning.Operation;
 import java.io.IOException;
 import java.util.List;
 import javax.annotation.Generated;
@@ -112,6 +117,36 @@ public UnaryCallSettings<GetMetadataRequest, Metadata> getMetadataSettings() {
     return ((BetaAnalyticsDataStubSettings) getStubSettings()).checkCompatibilitySettings();
   }
 
+  /** Returns the object with the settings used for calls to createAudienceExport. */
+  public UnaryCallSettings<CreateAudienceExportRequest, Operation> createAudienceExportSettings() {
+    return ((BetaAnalyticsDataStubSettings) getStubSettings()).createAudienceExportSettings();
+  }
+
+  /** Returns the object with the settings used for calls to createAudienceExport. */
+  public OperationCallSettings<CreateAudienceExportRequest, AudienceExport, AudienceExportMetadata>
+      createAudienceExportOperationSettings() {
+    return ((BetaAnalyticsDataStubSettings) getStubSettings())
+        .createAudienceExportOperationSettings();
+  }
+
+  /** Returns the object with the settings used for calls to queryAudienceExport. */
+  public UnaryCallSettings<QueryAudienceExportRequest, QueryAudienceExportResponse>
+      queryAudienceExportSettings() {
+    return ((BetaAnalyticsDataStubSettings) getStubSettings()).queryAudienceExportSettings();
+  }
+
+  /** Returns the object with the settings used for calls to getAudienceExport. */
+  public UnaryCallSettings<GetAudienceExportRequest, AudienceExport> getAudienceExportSettings() {
+    return ((BetaAnalyticsDataStubSettings) getStubSettings()).getAudienceExportSettings();
+  }
+
+  /** Returns the object with the settings used for calls to listAudienceExports. */
+  public PagedCallSettings<
+          ListAudienceExportsRequest, ListAudienceExportsResponse, ListAudienceExportsPagedResponse>
+      listAudienceExportsSettings() {
+    return ((BetaAnalyticsDataStubSettings) getStubSettings()).listAudienceExportsSettings();
+  }
+
   public static final BetaAnalyticsDataSettings create(BetaAnalyticsDataStubSettings stub)
       throws IOException {
     return new BetaAnalyticsDataSettings.Builder(stub.toBuilder()).build();
@@ -267,6 +302,40 @@ public UnaryCallSettings.Builder<GetMetadataRequest, Metadata> getMetadataSettin
       return getStubSettingsBuilder().checkCompatibilitySettings();
     }
 
+    /** Returns the builder for the settings used for calls to createAudienceExport. */
+    public UnaryCallSettings.Builder<CreateAudienceExportRequest, Operation>
+        createAudienceExportSettings() {
+      return getStubSettingsBuilder().createAudienceExportSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to createAudienceExport. */
+    public OperationCallSettings.Builder<
+            CreateAudienceExportRequest, AudienceExport, AudienceExportMetadata>
+        createAudienceExportOperationSettings() {
+      return getStubSettingsBuilder().createAudienceExportOperationSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to queryAudienceExport. */
+    public UnaryCallSettings.Builder<QueryAudienceExportRequest, QueryAudienceExportResponse>
+        queryAudienceExportSettings() {
+      return getStubSettingsBuilder().queryAudienceExportSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to getAudienceExport. */
+    public UnaryCallSettings.Builder<GetAudienceExportRequest, AudienceExport>
+        getAudienceExportSettings() {
+      return getStubSettingsBuilder().getAudienceExportSettings();
+    }
+
+    /** Returns the builder for the settings used for calls to listAudienceExports. */
+    public PagedCallSettings.Builder<
+            ListAudienceExportsRequest,
+            ListAudienceExportsResponse,
+            ListAudienceExportsPagedResponse>
+        listAudienceExportsSettings() {
+      return getStubSettingsBuilder().listAudienceExportsSettings();
+    }
+
     @Override
     public BetaAnalyticsDataSettings build() throws IOException {
       return new BetaAnalyticsDataSettings(this);

java-analytics-data/google-analytics-data/src/main/java/com/google/analytics/data/v1beta/gapic_metadata.json

@@ -19,9 +19,21 @@
             "CheckCompatibility": {
               "methods": ["checkCompatibility", "checkCompatibilityCallable"]
             },
+            "CreateAudienceExport": {
+              "methods": ["createAudienceExportAsync", "createAudienceExportAsync", "createAudienceExportAsync", "createAudienceExportOperationCallable", "createAudienceExportCallable"]
+            },
+            "GetAudienceExport": {
+              "methods": ["getAudienceExport", "getAudienceExport", "getAudienceExport", "getAudienceExportCallable"]
+            },
             "GetMetadata": {
               "methods": ["getMetadata", "getMetadata", "getMetadata", "getMetadataCallable"]
             },
+            "ListAudienceExports": {
+              "methods": ["listAudienceExports", "listAudienceExports", "listAudienceExports", "listAudienceExportsPagedCallable", "listAudienceExportsCallable"]
+            },
+            "QueryAudienceExport": {
+              "methods": ["queryAudienceExport", "queryAudienceExport", "queryAudienceExportCallable"]
+            },
             "RunPivotReport": {
               "methods": ["runPivotReport", "runPivotReportCallable"]
             },

java-analytics-data/google-analytics-data/src/main/java/com/google/analytics/data/v1beta/stub/BetaAnalyticsDataStub.java

@@ -16,14 +16,24 @@
 
 package com.google.analytics.data.v1beta.stub;
 
+import static com.google.analytics.data.v1beta.BetaAnalyticsDataClient.ListAudienceExportsPagedResponse;
+
+import com.google.analytics.data.v1beta.AudienceExport;
+import com.google.analytics.data.v1beta.AudienceExportMetadata;
 import com.google.analytics.data.v1beta.BatchRunPivotReportsRequest;
 import com.google.analytics.data.v1beta.BatchRunPivotReportsResponse;
 import com.google.analytics.data.v1beta.BatchRunReportsRequest;
 import com.google.analytics.data.v1beta.BatchRunReportsResponse;
 import com.google.analytics.data.v1beta.CheckCompatibilityRequest;
 import com.google.analytics.data.v1beta.CheckCompatibilityResponse;
+import com.google.analytics.data.v1beta.CreateAudienceExportRequest;
+import com.google.analytics.data.v1beta.GetAudienceExportRequest;
 import com.google.analytics.data.v1beta.GetMetadataRequest;
+import com.google.analytics.data.v1beta.ListAudienceExportsRequest;
+import com.google.analytics.data.v1beta.ListAudienceExportsResponse;
 import com.google.analytics.data.v1beta.Metadata;
+import com.google.analytics.data.v1beta.QueryAudienceExportRequest;
+import com.google.analytics.data.v1beta.QueryAudienceExportResponse;
 import com.google.analytics.data.v1beta.RunPivotReportRequest;
 import com.google.analytics.data.v1beta.RunPivotReportResponse;
 import com.google.analytics.data.v1beta.RunRealtimeReportRequest;
@@ -32,7 +42,10 @@
 import com.google.analytics.data.v1beta.RunReportResponse;
 import com.google.api.core.BetaApi;
 import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.OperationCallable;
 import com.google.api.gax.rpc.UnaryCallable;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
 import javax.annotation.Generated;
 
 // AUTO-GENERATED DOCUMENTATION AND CLASS.
@@ -45,6 +58,14 @@
 @Generated("by gapic-generator-java")
 public abstract class BetaAnalyticsDataStub implements BackgroundResource {
 
+  public OperationsStub getOperationsStub() {
+    return null;
+  }
+
+  public com.google.api.gax.httpjson.longrunning.stub.OperationsStub getHttpJsonOperationsStub() {
+    return null;
+  }
+
   public UnaryCallable<RunReportRequest, RunReportResponse> runReportCallable() {
     throw new UnsupportedOperationException("Not implemented: runReportCallable()");
   }
@@ -76,6 +97,35 @@ public UnaryCallable<GetMetadataRequest, Metadata> getMetadataCallable() {
     throw new UnsupportedOperationException("Not implemented: checkCompatibilityCallable()");
   }
 
+  public OperationCallable<CreateAudienceExportRequest, AudienceExport, AudienceExportMetadata>
+      createAudienceExportOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: createAudienceExportOperationCallable()");
+  }
+
+  public UnaryCallable<CreateAudienceExportRequest, Operation> createAudienceExportCallable() {
+    throw new UnsupportedOperationException("Not implemented: createAudienceExportCallable()");
+  }
+
+  public UnaryCallable<QueryAudienceExportRequest, QueryAudienceExportResponse>
+      queryAudienceExportCallable() {
+    throw new UnsupportedOperationException("Not implemented: queryAudienceExportCallable()");
+  }
+
+  public UnaryCallable<GetAudienceExportRequest, AudienceExport> getAudienceExportCallable() {
+    throw new UnsupportedOperationException("Not implemented: getAudienceExportCallable()");
+  }
+
+  public UnaryCallable<ListAudienceExportsRequest, ListAudienceExportsPagedResponse>
+      listAudienceExportsPagedCallable() {
+    throw new UnsupportedOperationException("Not implemented: listAudienceExportsPagedCallable()");
+  }
+
+  public UnaryCallable<ListAudienceExportsRequest, ListAudienceExportsResponse>
+      listAudienceExportsCallable() {
+    throw new UnsupportedOperationException("Not implemented: listAudienceExportsCallable()");
+  }
+
   @Override
   public abstract void close();
 }