google-analytics-admin 0.27.0__tar.gz → 0.29.0__tar.gz

{google_analytics_admin-0.27.0/google_analytics_admin.egg-info → google_analytics_admin-0.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-analytics-admin
-Version: 0.27.0
+Version: 0.29.0
 Summary: Google Analytics Admin API client library
 Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-analytics-admin
 Author: Google LLC
@@ -12,8 +12,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -22,15 +20,15 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
-Requires-Python: >=3.7
+Requires-Python: >=3.9
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.1
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.11.0
 Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
 Requires-Dist: grpcio<2.0.0,>=1.33.2
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
 Requires-Dist: proto-plus<2.0.0,>=1.22.3
 Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
+Requires-Dist: protobuf<8.0.0,>=4.25.8
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -43,12 +41,18 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-Python Client for Analytics Admin
-=================================
+Python Client for Google Analytics Admin
+========================================
 
 |preview| |pypi| |versions|
 
-`Analytics Admin`_: allows you to manage Google Analytics accounts and properties.
+`Google Analytics Admin`_: Manage properties in Google Analytics.  Warning: Creating multiple Customer
+Applications, Accounts, or Projects to simulate or act as a single
+Customer Application, Account, or Project (respectively) or to circumvent
+Service-specific usage limits or quotas is a direct violation of Google
+Cloud Platform Terms of Service as well as Google APIs Terms of Service.
+These actions can result in immediate termination of your GCP project(s)
+without any warning.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -59,7 +63,7 @@ Python Client for Analytics Admin
    :target: https://pypi.org/project/google-analytics-admin/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-analytics-admin.svg
    :target: https://pypi.org/project/google-analytics-admin/
-.. _Analytics Admin: https://developers.google.com/analytics/
+.. _Google Analytics Admin: https://developers.google.com/analytics/
 .. _Client Library Documentation: https://googleapis.dev/python/analyticsadmin/latest
 .. _Product Documentation:  https://developers.google.com/analytics/
 
@@ -70,12 +74,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Analytics Admin.`_
+3. `Enable the Google Analytics Admin.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Analytics Admin.:  https://developers.google.com/analytics/
+.. _Enable the Google Analytics Admin.:  https://developers.google.com/analytics/
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -106,14 +110,14 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.7, including 3.14
+Python >= 3.9, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.6
+Python <= 3.8
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -142,14 +146,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Analytics Admin
+-  Read the `Client Library Documentation`_ for Google Analytics Admin
    to see other available methods on the client.
--  Read the `Analytics Admin Product documentation`_ to learn
+-  Read the `Google Analytics Admin Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Analytics Admin Product documentation:  https://developers.google.com/analytics/
+.. _Google Analytics Admin Product documentation:  https://developers.google.com/analytics/
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/README.rst

@@ -1,9 +1,15 @@
-Python Client for Analytics Admin
-=================================
+Python Client for Google Analytics Admin
+========================================
 
 |preview| |pypi| |versions|
 
-`Analytics Admin`_: allows you to manage Google Analytics accounts and properties.
+`Google Analytics Admin`_: Manage properties in Google Analytics.  Warning: Creating multiple Customer
+Applications, Accounts, or Projects to simulate or act as a single
+Customer Application, Account, or Project (respectively) or to circumvent
+Service-specific usage limits or quotas is a direct violation of Google
+Cloud Platform Terms of Service as well as Google APIs Terms of Service.
+These actions can result in immediate termination of your GCP project(s)
+without any warning.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -14,7 +20,7 @@ Python Client for Analytics Admin
    :target: https://pypi.org/project/google-analytics-admin/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-analytics-admin.svg
    :target: https://pypi.org/project/google-analytics-admin/
-.. _Analytics Admin: https://developers.google.com/analytics/
+.. _Google Analytics Admin: https://developers.google.com/analytics/
 .. _Client Library Documentation: https://googleapis.dev/python/analyticsadmin/latest
 .. _Product Documentation:  https://developers.google.com/analytics/
 
@@ -25,12 +31,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Analytics Admin.`_
+3. `Enable the Google Analytics Admin.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Analytics Admin.:  https://developers.google.com/analytics/
+.. _Enable the Google Analytics Admin.:  https://developers.google.com/analytics/
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -61,14 +67,14 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.7, including 3.14
+Python >= 3.9, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.6
+Python <= 3.8
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -97,14 +103,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Analytics Admin
+-  Read the `Client Library Documentation`_ for Google Analytics Admin
    to see other available methods on the client.
--  Read the `Analytics Admin Product documentation`_ to learn
+-  Read the `Google Analytics Admin Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Analytics Admin Product documentation:  https://developers.google.com/analytics/
+.. _Google Analytics Admin Product documentation:  https://developers.google.com/analytics/
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/google/analytics/admin/__init__.py

@@ -144,6 +144,7 @@ from google.analytics.admin_v1alpha.types.analytics_admin import (
     GetSKAdNetworkConversionValueSchemaRequest,
     GetSubpropertyEventFilterRequest,
     GetSubpropertySyncConfigRequest,
+    GetUserProvidedDataSettingsRequest,
     ListAccessBindingsRequest,
     ListAccessBindingsResponse,
     ListAccountsRequest,
@@ -320,6 +321,7 @@ from google.analytics.admin_v1alpha.types.resources import (
     ServiceLevel,
     SKAdNetworkConversionValueSchema,
     SubpropertySyncConfig,
+    UserProvidedDataSettings,
 )
 from google.analytics.admin_v1alpha.types.subproperty_event_filter import (
     SubpropertyEventFilter,
@@ -449,6 +451,7 @@ __all__ = (
     "GetSKAdNetworkConversionValueSchemaRequest",
     "GetSubpropertyEventFilterRequest",
     "GetSubpropertySyncConfigRequest",
+    "GetUserProvidedDataSettingsRequest",
     "ListAccessBindingsRequest",
     "ListAccessBindingsResponse",
     "ListAccountsRequest",
@@ -604,6 +607,7 @@ __all__ = (
     "SearchAds360Link",
     "SKAdNetworkConversionValueSchema",
     "SubpropertySyncConfig",
+    "UserProvidedDataSettings",
     "ActionType",
     "ActorType",
     "ChangeHistoryResourceType",

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/google/analytics/admin/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.27.0"  # {x-release-please-version}
+__version__ = "0.29.0"  # {x-release-please-version}

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/google/analytics/admin_v1alpha/__init__.py

@@ -28,6 +28,7 @@ else:  # pragma: NO COVER
     # this code path once we drop support for Python 3.7
     import importlib_metadata as metadata
 
+
 from .services.analytics_admin_service import (
     AnalyticsAdminServiceAsyncClient,
     AnalyticsAdminServiceClient,
@@ -152,6 +153,7 @@ from .types.analytics_admin import (
     GetSKAdNetworkConversionValueSchemaRequest,
     GetSubpropertyEventFilterRequest,
     GetSubpropertySyncConfigRequest,
+    GetUserProvidedDataSettingsRequest,
     ListAccessBindingsRequest,
     ListAccessBindingsResponse,
     ListAccountsRequest,
@@ -328,6 +330,7 @@ from .types.resources import (
     ServiceLevel,
     SKAdNetworkConversionValueSchema,
     SubpropertySyncConfig,
+    UserProvidedDataSettings,
 )
 from .types.subproperty_event_filter import (
     SubpropertyEventFilter,
@@ -596,6 +599,7 @@ __all__ = (
     "GetSearchAds360LinkRequest",
     "GetSubpropertyEventFilterRequest",
     "GetSubpropertySyncConfigRequest",
+    "GetUserProvidedDataSettingsRequest",
     "GlobalSiteTag",
     "GoogleAdsLink",
     "GoogleSignalsConsent",
@@ -722,4 +726,5 @@ __all__ = (
     "UpdateSearchAds360LinkRequest",
     "UpdateSubpropertyEventFilterRequest",
     "UpdateSubpropertySyncConfigRequest",
+    "UserProvidedDataSettings",
 )

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/google/analytics/admin_v1alpha/gapic_metadata.json

@@ -470,6 +470,11 @@
                 "get_subproperty_sync_config"
               ]
             },
+            "GetUserProvidedDataSettings": {
+              "methods": [
+                "get_user_provided_data_settings"
+              ]
+            },
             "ListAccessBindings": {
               "methods": [
                 "list_access_bindings"
@@ -1245,6 +1250,11 @@
                 "get_subproperty_sync_config"
               ]
             },
+            "GetUserProvidedDataSettings": {
+              "methods": [
+                "get_user_provided_data_settings"
+              ]
+            },
             "ListAccessBindings": {
               "methods": [
                 "list_access_bindings"
@@ -2020,6 +2030,11 @@
                 "get_subproperty_sync_config"
               ]
             },
+            "GetUserProvidedDataSettings": {
+              "methods": [
+                "get_user_provided_data_settings"
+              ]
+            },
             "ListAccessBindings": {
               "methods": [
                 "list_access_bindings"

{google_analytics_admin-0.27.0/google/analytics/admin_v1beta → google_analytics_admin-0.29.0/google/analytics/admin_v1alpha}/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.27.0"  # {x-release-please-version}
+__version__ = "0.29.0"  # {x-release-please-version}

{google_analytics_admin-0.27.0 → google_analytics_admin-0.29.0}/google/analytics/admin_v1alpha/services/analytics_admin_service/async_client.py

@@ -13,9 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-from collections import OrderedDict
 import logging as std_logging
 import re
+import warnings
+from collections import OrderedDict
 from typing import (
     Callable,
     Dict,
@@ -28,15 +29,14 @@ from typing import (
     Type,
     Union,
 )
-import warnings
 
+import google.protobuf
 from google.api_core import exceptions as core_exceptions
 from google.api_core import gapic_v1
 from google.api_core import retry_async as retries
 from google.api_core.client_options import ClientOptions
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.oauth2 import service_account  # type: ignore
-import google.protobuf
 
 from google.analytics.admin_v1alpha import gapic_version as package_version
 
@@ -45,12 +45,23 @@ try:
 except AttributeError:  # pragma: NO COVER
     OptionalRetry = Union[retries.AsyncRetry, object, None]  # type: ignore
 
-from google.protobuf import field_mask_pb2  # type: ignore
-from google.protobuf import timestamp_pb2  # type: ignore
-from google.protobuf import wrappers_pb2  # type: ignore
-from google.type import date_pb2  # type: ignore
+import google.protobuf.field_mask_pb2 as field_mask_pb2  # type: ignore
+import google.protobuf.timestamp_pb2 as timestamp_pb2  # type: ignore
+import google.protobuf.wrappers_pb2 as wrappers_pb2  # type: ignore
+import google.type.date_pb2 as date_pb2  # type: ignore
 
 from google.analytics.admin_v1alpha.services.analytics_admin_service import pagers
+from google.analytics.admin_v1alpha.types import (
+    access_report,
+    analytics_admin,
+    audience,
+    channel_group,
+    event_create_and_edit,
+    expanded_data_set,
+    resources,
+    subproperty_event_filter,
+)
+from google.analytics.admin_v1alpha.types import audience as gaa_audience
 from google.analytics.admin_v1alpha.types import channel_group as gaa_channel_group
 from google.analytics.admin_v1alpha.types import (
     expanded_data_set as gaa_expanded_data_set,
@@ -58,14 +69,6 @@ from google.analytics.admin_v1alpha.types import (
 from google.analytics.admin_v1alpha.types import (
     subproperty_event_filter as gaa_subproperty_event_filter,
 )
-from google.analytics.admin_v1alpha.types import access_report, analytics_admin
-from google.analytics.admin_v1alpha.types import audience
-from google.analytics.admin_v1alpha.types import audience as gaa_audience
-from google.analytics.admin_v1alpha.types import channel_group
-from google.analytics.admin_v1alpha.types import event_create_and_edit
-from google.analytics.admin_v1alpha.types import expanded_data_set
-from google.analytics.admin_v1alpha.types import resources
-from google.analytics.admin_v1alpha.types import subproperty_event_filter
 
 from .client import AnalyticsAdminServiceClient
 from .transports.base import DEFAULT_CLIENT_INFO, AnalyticsAdminServiceTransport
@@ -285,6 +288,12 @@ class AnalyticsAdminServiceAsyncClient:
     parse_subproperty_sync_config_path = staticmethod(
         AnalyticsAdminServiceClient.parse_subproperty_sync_config_path
     )
+    user_provided_data_settings_path = staticmethod(
+        AnalyticsAdminServiceClient.user_provided_data_settings_path
+    )
+    parse_user_provided_data_settings_path = staticmethod(
+        AnalyticsAdminServiceClient.parse_user_provided_data_settings_path
+    )
     common_billing_account_path = staticmethod(
         AnalyticsAdminServiceClient.common_billing_account_path
     )
@@ -325,7 +334,10 @@ class AnalyticsAdminServiceAsyncClient:
         Returns:
             AnalyticsAdminServiceAsyncClient: The constructed client.
         """
-        return AnalyticsAdminServiceClient.from_service_account_info.__func__(AnalyticsAdminServiceAsyncClient, info, *args, **kwargs)  # type: ignore
+        sa_info_func = (
+            AnalyticsAdminServiceClient.from_service_account_info.__func__  # type: ignore
+        )
+        return sa_info_func(AnalyticsAdminServiceAsyncClient, info, *args, **kwargs)
 
     @classmethod
     def from_service_account_file(cls, filename: str, *args, **kwargs):
@@ -341,7 +353,10 @@ class AnalyticsAdminServiceAsyncClient:
         Returns:
             AnalyticsAdminServiceAsyncClient: The constructed client.
         """
-        return AnalyticsAdminServiceClient.from_service_account_file.__func__(AnalyticsAdminServiceAsyncClient, filename, *args, **kwargs)  # type: ignore
+        sa_file_func = (
+            AnalyticsAdminServiceClient.from_service_account_file.__func__  # type: ignore
+        )
+        return sa_file_func(AnalyticsAdminServiceAsyncClient, filename, *args, **kwargs)
 
     from_service_account_json = from_service_account_file
 
@@ -379,7 +394,9 @@ class AnalyticsAdminServiceAsyncClient:
         Raises:
             google.auth.exceptions.MutualTLSChannelError: If any errors happen.
         """
-        return AnalyticsAdminServiceClient.get_mtls_endpoint_and_cert_source(client_options)  # type: ignore
+        return AnalyticsAdminServiceClient.get_mtls_endpoint_and_cert_source(
+            client_options
+        )  # type: ignore
 
     @property
     def transport(self) -> AnalyticsAdminServiceTransport:
@@ -391,7 +408,7 @@ class AnalyticsAdminServiceAsyncClient:
         return self._client.transport
 
     @property
-    def api_endpoint(self):
+    def api_endpoint(self) -> str:
         """Return the API endpoint used by the client instance.
 
         Returns:
@@ -14661,8 +14678,8 @@ class AnalyticsAdminServiceAsyncClient:
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> resources.ReportingIdentitySettings:
-        r"""Returns the singleton data retention settings for
-        this property.
+        r"""Returns the reporting identity settings for this
+        property.
 
         Args:
             request (Optional[Union[google.analytics.admin_v1alpha.types.GetReportingIdentitySettingsRequest, dict]]):
@@ -14742,6 +14759,97 @@ class AnalyticsAdminServiceAsyncClient:
         # Done; return the response.
         return response
 
+    async def get_user_provided_data_settings(
+        self,
+        request: Optional[
+            Union[analytics_admin.GetUserProvidedDataSettingsRequest, dict]
+        ] = None,
+        *,
+        name: Optional[str] = None,
+        retry: OptionalRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
+    ) -> resources.UserProvidedDataSettings:
+        r"""Looks up settings related to user-provided data for a
+        property.
+
+        Args:
+            request (Optional[Union[google.analytics.admin_v1alpha.types.GetUserProvidedDataSettingsRequest, dict]]):
+                The request object. Request message for
+                GetUserProvidedDataSettings RPC
+            name (:class:`str`):
+                Required. The name of the user
+                provided data settings to retrieve.
+                Format:
+                properties/{property}/userProvidedDataSettings
+
+                This corresponds to the ``name`` field
+                on the ``request`` instance; if ``request`` is provided, this
+                should not be set.
+            retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
+                should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+
+        Returns:
+            google.analytics.admin_v1alpha.types.UserProvidedDataSettings:
+                Configuration for user-provided data
+                collection. This is a singleton resource
+                for a Google Analytics property.
+
+        """
+        # Create or coerce a protobuf request object.
+        # - Quick check: If we got a request object, we should *not* have
+        #   gotten any keyword arguments that map to the request.
+        flattened_params = [name]
+        has_flattened_params = (
+            len([param for param in flattened_params if param is not None]) > 0
+        )
+        if request is not None and has_flattened_params:
+            raise ValueError(
+                "If the `request` argument is set, then none of "
+                "the individual field arguments should be set."
+            )
+
+        # - Use the request object if provided (there's no risk of modifying the input as
+        #   there are no flattened fields), or create one.
+        if not isinstance(request, analytics_admin.GetUserProvidedDataSettingsRequest):
+            request = analytics_admin.GetUserProvidedDataSettingsRequest(request)
+
+        # If we have keyword arguments corresponding to fields on the
+        # request, apply these.
+        if name is not None:
+            request.name = name
+
+        # Wrap the RPC method; this adds retry and timeout information,
+        # and friendly error handling.
+        rpc = self._client._transport._wrapped_methods[
+            self._client._transport.get_user_provided_data_settings
+        ]
+
+        # Certain fields should be provided within the metadata header;
+        # add these here.
+        metadata = tuple(metadata) + (
+            gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
+        )
+
+        # Validate the universe domain.
+        self._client._validate_universe_domain()
+
+        # Send the request.
+        response = await rpc(
+            request,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+
+        # Done; return the response.
+        return response
+
     async def __aenter__(self) -> "AnalyticsAdminServiceAsyncClient":
         return self