feat: Add REST Interceptors which support reading metadata

feat: Add support for reading selective GAPIC generation methods from service YAML
chore: Update gapic-generator-python to v1.22.0

PiperOrigin-RevId: 724026024

Source-Link: googleapis/googleapis@ad99638

Source-Link: googleapis/googleapis-gen@e291c4d
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZTI5MWM0ZGQxZDY3MGVkYTE5OTk4ZGU3NmY5NjdlMTYwM2E0ODk5MyJ9

owl-bot-staging/v1/.coveragerc

@@ -0,0 +1,13 @@
+[run]
+branch = True
+
+[report]
+show_missing = True
+omit =
+    google/cloud/aiplatform/v1/schema/trainingjob/definition/__init__.py
+    google/cloud/aiplatform/v1/schema/trainingjob/definition/gapic_version.py
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__

owl-bot-staging/v1/.flake8

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2020 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 by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  **/services/**
+  **/types/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  **/.nox/**
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py

owl-bot-staging/v1/MANIFEST.in

@@ -0,0 +1,2 @@
+recursive-include google/cloud/aiplatform/v1/schema/trainingjob/definition *.py
+recursive-include google/cloud/aiplatform/v1/schema/trainingjob/definition_v1 *.py

owl-bot-staging/v1/README.rst

@@ -0,0 +1,143 @@
+Python Client for Google Cloud Aiplatform V1 Schema Trainingjob Definition API
+=================================================
+
+Quick Start
+-----------
+
+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 Google Cloud Aiplatform V1 Schema Trainingjob Definition API.
+4. `Setup 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
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    python3 -m venv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install /path/to/library
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    python3 -m venv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install \path\to\library
+
+
+Logging
+-------
+
+This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
+Note the following:
+
+#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
+#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
+#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
+
+
+Simple, environment-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
+logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
+messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
+event.
+
+A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
+
+- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
+- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
+
+**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
+
+
+Examples
+^^^^^^^^
+
+- Enabling the default handler for all Google-based loggers
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
+
+- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
+
+
+Advanced, code-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also configure a valid logging scope using Python's standard `logging` mechanism.
+
+
+Examples
+^^^^^^^^
+
+- Configuring a handler for all Google-based loggers
+
+.. code-block:: python
+
+    import logging
+
+    from google.cloud.translate_v3 import translate
+
+    base_logger = logging.getLogger("google")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: python
+
+    import logging
+
+    from google.cloud.translate_v3 import translate
+
+    base_logger = logging.getLogger("google.cloud.library_v1")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+
+Logging details
+~~~~~~~~~~~~~~~
+
+#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
+   logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
+   :code:`logging.getLogger("google").propagate = True` in your code.
+#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
+   one library, but decide you need to also set up environment-based logging configuration for another library.
+
+   #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
+      if the code -based configuration gets applied first.
+
+#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
+   executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
+   (This is the reason for 2.i. above.)

owl-bot-staging/v1/docs/_static/custom.css

@@ -0,0 +1,3 @@
+dl.field-list > dt {
+    min-width: 100px
+}

owl-bot-staging/v1/docs/aiplatform_v1/dataset_service.rst

@@ -0,0 +1,10 @@
+DatasetService
+--------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.dataset_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.dataset_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/deployment_resource_pool_service.rst

@@ -0,0 +1,10 @@
+DeploymentResourcePoolService
+-----------------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.deployment_resource_pool_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.deployment_resource_pool_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/endpoint_service.rst

@@ -0,0 +1,10 @@
+EndpointService
+---------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.endpoint_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.endpoint_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/evaluation_service.rst

@@ -0,0 +1,6 @@
+EvaluationService
+-----------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.evaluation_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/feature_online_store_admin_service.rst

@@ -0,0 +1,10 @@
+FeatureOnlineStoreAdminService
+------------------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.feature_online_store_admin_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.feature_online_store_admin_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/feature_online_store_service.rst

@@ -0,0 +1,6 @@
+FeatureOnlineStoreService
+-------------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.feature_online_store_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/feature_registry_service.rst

@@ -0,0 +1,10 @@
+FeatureRegistryService
+----------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.feature_registry_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.feature_registry_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/featurestore_online_serving_service.rst

@@ -0,0 +1,6 @@
+FeaturestoreOnlineServingService
+--------------------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.featurestore_online_serving_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/featurestore_service.rst

@@ -0,0 +1,10 @@
+FeaturestoreService
+-------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.featurestore_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.featurestore_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/gen_ai_cache_service.rst

@@ -0,0 +1,10 @@
+GenAiCacheService
+-----------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.gen_ai_cache_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.gen_ai_cache_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/gen_ai_tuning_service.rst

@@ -0,0 +1,10 @@
+GenAiTuningService
+------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.gen_ai_tuning_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.gen_ai_tuning_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/index_endpoint_service.rst

@@ -0,0 +1,10 @@
+IndexEndpointService
+--------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.index_endpoint_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.index_endpoint_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/index_service.rst

@@ -0,0 +1,10 @@
+IndexService
+------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.index_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.index_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/job_service.rst

@@ -0,0 +1,10 @@
+JobService
+----------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.job_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.job_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/llm_utility_service.rst

@@ -0,0 +1,6 @@
+LlmUtilityService
+-----------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.llm_utility_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/match_service.rst

@@ -0,0 +1,6 @@
+MatchService
+------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.match_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/metadata_service.rst

@@ -0,0 +1,10 @@
+MetadataService
+---------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.metadata_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.metadata_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/migration_service.rst

@@ -0,0 +1,10 @@
+MigrationService
+----------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.migration_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.migration_service.pagers
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/model_garden_service.rst

@@ -0,0 +1,6 @@
+ModelGardenService
+------------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.model_garden_service
+    :members:
+    :inherited-members:

owl-bot-staging/v1/docs/aiplatform_v1/model_service.rst

@@ -0,0 +1,10 @@
+ModelService
+------------------------------
+
+.. automodule:: google.cloud.aiplatform_v1.services.model_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.aiplatform_v1.services.model_service.pagers
+    :members:
+    :inherited-members: