From 80f1f5d56109fdc4ef0a90d83251753f9d98e4fb Mon Sep 17 00:00:00 2001
From: EfeDurmaz16 <efebarandurmaz05@gmail.com>
Date: Wed, 6 May 2026 02:36:20 +0300
Subject: [PATCH] docs: add Parameter Manager integration

---
 docs/integrations/parameter-manager.md | 72 ++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 docs/integrations/parameter-manager.md

diff --git a/docs/integrations/parameter-manager.md b/docs/integrations/parameter-manager.md
new file mode 100644
index 0000000000..362aa004de
--- /dev/null
+++ b/docs/integrations/parameter-manager.md
@@ -0,0 +1,72 @@
+---
+catalog_title: Parameter Manager
+catalog_description: Retrieve configuration values from Google Cloud Parameter Manager
+catalog_icon: /integrations/assets/adk.png
+catalog_tags: ["config", "google-cloud"]
+---
+
+# Parameter Manager
+
+<div class="language-support-tag">
+  <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python v1.31.0</span><span class="lst-preview">Experimental</span>
+</div>
+
+The Parameter Manager integration provides a small client for retrieving
+rendered parameter values from Google Cloud Parameter Manager. Use it when your
+agent needs configuration values that should be managed outside the agent
+process.
+
+## Initialize the client
+
+If you do not pass credentials explicitly, `ParameterManagerClient` uses default
+Google Cloud credentials.
+
+```python
+from google.adk.integrations.parameter_manager.parameter_client import (
+    ParameterManagerClient,
+)
+
+client = ParameterManagerClient()
+```
+
+You can also initialize the client with a service account JSON string:
+
+```python
+client = ParameterManagerClient(
+    service_account_json='{"type": "service_account", "...": "..."}',
+)
+```
+
+Or with an existing authorization token:
+
+```python
+client = ParameterManagerClient(auth_token="ya29...")
+```
+
+To use a regional Parameter Manager endpoint, pass `location`:
+
+```python
+client = ParameterManagerClient(location="us-central1")
+```
+
+## Retrieve a parameter
+
+Call `get_parameter` with the full parameter version resource name. Use
+`versions/latest` when you want the latest version.
+
+```python
+value = client.get_parameter(
+    "projects/my-project/locations/global/parameters/my-param/versions/latest"
+)
+```
+
+The method returns the rendered parameter payload as a string.
+
+## Authentication notes
+
+Provide only one of `service_account_json` or `auth_token`. If neither is
+provided, the client attempts to use Application Default Credentials with the
+`https://www.googleapis.com/auth/cloud-platform` scope.
+
+For broader guidance on credential handling in ADK agents, see
+[Authenticating with Tools](/tools-custom/authentication/).