oss: google consolidation updates (#1790)

mdrxy · web-flow · commit 5b5990b250eb · 2025-12-08T14:11:38.000-05:00
diff --git a/reference/python/docs/integrations/index.md b/reference/python/docs/integrations/index.md
@@ -43,14 +43,6 @@ To learn more about integrations in LangChain, visit the [Integrations overview]
 
     [:octicons-arrow-right-24: Reference](./langchain_google_genai/index.md)
 
-- :simple-googlecloud:{ .lg .middle } __`langchain-google-vertexai`__
-
-    ---
-
-    Use Google's Vertex AI model platform.
-
-    [:octicons-arrow-right-24: Reference](./langchain_google_vertexai/index.md)
-
 - :material-aws:{ .lg .middle } __`langchain-aws`__
 
     ---
diff --git a/reference/python/docs/integrations/langchain_google_genai/ChatGoogleGenerativeAI.md b/reference/python/docs/integrations/langchain_google_genai/ChatGoogleGenerativeAI.md
@@ -0,0 +1,10 @@
+---
+title: ChatGoogleGenerativeAI
+---
+
+# :simple-googlegemini:{ .lg .middle } `ChatGoogleGenerativeAI`
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for `ChatGoogleGenerativeAI`. See [the docs](https://docs.langchain.com/oss/python/integrations/chat/google_generative_ai) for conceptual guides, tutorials, and examples on using `ChatGoogleGenerativeAI`.
+
+::: langchain_google_genai.ChatGoogleGenerativeAI
diff --git a/reference/python/docs/integrations/langchain_google_genai/GoogleGenerativeAI.md b/reference/python/docs/integrations/langchain_google_genai/GoogleGenerativeAI.md
@@ -0,0 +1,10 @@
+---
+title: GoogleGenerativeAI (Legacy LLM)
+---
+
+# :simple-googlegemini:{ .lg .middle } `GoogleGenerativeAI` (Legacy LLM)
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for the legacy `GoogleGenerativeAI` LLM. See [the docs](https://docs.langchain.com/oss/python/integrations/chat/google_generative_ai) for conceptual guides, tutorials, and examples on using `GoogleGenerativeAI`.
+
+::: langchain_google_genai.GoogleGenerativeAI
diff --git a/reference/python/docs/integrations/langchain_google_genai/GoogleGenerativeAIEmbeddings.md b/reference/python/docs/integrations/langchain_google_genai/GoogleGenerativeAIEmbeddings.md
@@ -0,0 +1,10 @@
+---
+title: GoogleGenerativeAIEmbeddings
+---
+
+# :simple-googlegemini:{ .lg .middle } `GoogleGenerativeAIEmbeddings`
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for `GoogleGenerativeAIEmbeddings`. See [the docs](https://docs.langchain.com/oss/python/integrations/text_embedding/google_generative_ai) for conceptual guides, tutorials, and examples on using `GoogleGenerativeAIEmbeddings`.
+
+::: langchain_google_genai.GoogleGenerativeAIEmbeddings
diff --git a/reference/python/docs/integrations/langchain_google_genai/index.md b/reference/python/docs/integrations/langchain_google_genai/index.md
@@ -8,7 +8,43 @@ title: Google (GenAI)
 [![PyPI - License](https://img.shields.io/pypi/l/langchain-google-genai)](https://opensource.org/licenses/MIT)
 [![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-genai)](https://pypistats.org/packages/langchain-google-genai)
 
-!!! warning "Reference docs"
-    This page contains **reference documentation** for Google GenAI. See [the docs](https://docs.langchain.com/oss/python/integrations/providers/google) for conceptual guides, tutorials, and examples on using Google GenAI modules.
+LangChain integration for Google's Generative AI models, providing access to Gemini models via both the **Gemini Developer API** and **Vertex AI**.
 
-::: langchain_google_genai
+!!! note "Vertex AI consolidation"
+
+    As of `langchain-google-genai` 4.0.0, this package uses the consolidated [`google-genai`](https://googleapis.github.io/python-genai/) SDK instead of the legacy [`google-ai-generativelanguage`](https://googleapis.dev/python/generativelanguage/latest/) SDK.
+
+    This migration brings support for Gemini models both via the Gemini Developer API and Gemini API in Vertex AI, superseding certain classes in `langchain-google-vertexai`, such as `ChatVertexAI`. Refer to [the provider docs](https://docs.langchain.com/oss/python/integrations/providers/google) and [release notes](https://github.com/langchain-ai/langchain-google/discussions/1422) for more information.
+
+## Modules
+
+!!! note "Usage documentation"
+    Refer to [the docs](https://docs.langchain.com/oss/python/integrations/providers/google) for a high-level guide on how to use each module. These reference pages contain auto-generated API documentation for each module, focusing on the "what" rather than the "how" or "why" (i.e. no end-to-end tutorials or conceptual overviews).
+
+<div class="grid cards" markdown>
+
+- :material-message-text:{ .lg .middle } __`ChatGoogleGenerativeAI`__
+
+    ---
+
+    Gemini chat models.
+
+    [:octicons-arrow-right-24: Reference](./ChatGoogleGenerativeAI.md)
+
+- :material-message-text:{ .lg .middle } __`GoogleGenerativeAI`__
+
+    ---
+
+    (Legacy) Google text completion abstraction.
+
+    [:octicons-arrow-right-24: Reference](./GoogleGenerativeAI.md)
+
+- :fontawesome-solid-layer-group:{ .lg .middle } __`GoogleGenerativeAIEmbeddings`__
+
+    ---
+
+    Gemini embedding models.
+
+    [:octicons-arrow-right-24: Reference](./GoogleGenerativeAIEmbeddings.md)
+
+</div>
diff --git a/reference/python/docs/integrations/langchain_google_vertexai/ChatVertexAI.md b/reference/python/docs/integrations/langchain_google_vertexai/ChatVertexAI.md
@@ -0,0 +1,10 @@
+---
+title: ChatVertexAI
+---
+
+# :simple-googlecloud:{ .lg .middle } `ChatVertexAI`
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for `ChatVertexAI`. See [the docs](https://docs.langchain.com/oss/python/integrations/chat/google_vertex_ai) for conceptual guides, tutorials, and examples on using `ChatVertexAI`.
+
+::: langchain_google_vertexai.ChatVertexAI
diff --git a/reference/python/docs/integrations/langchain_google_vertexai/VertexAI.md b/reference/python/docs/integrations/langchain_google_vertexai/VertexAI.md
@@ -0,0 +1,10 @@
+---
+title: VertexAI (Legacy LLM)
+---
+
+# :simple-googlecloud:{ .lg .middle } `VertexAI`
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for the legacy `VertexAI` LLM. See [the docs](https://docs.langchain.com/oss/python/integrations/llms/google_vertex_ai) for conceptual guides, tutorials, and examples on using `VertexAI`.
+
+::: langchain_google_vertexai.VertexAI
diff --git a/reference/python/docs/integrations/langchain_google_vertexai/VertexAIEmbeddings.md b/reference/python/docs/integrations/langchain_google_vertexai/VertexAIEmbeddings.md
@@ -0,0 +1,10 @@
+---
+title: VertexAIEmbeddings
+---
+
+# :simple-googlecloud:{ .lg .middle } `VertexAIEmbeddings`
+
+!!! note "Reference docs"
+    This page contains **reference documentation** for `VertexAIEmbeddings`. See [the docs](https://docs.langchain.com/oss/python/integrations/text_embedding/google_vertex_ai) for conceptual guides, tutorials, and examples on using `VertexAIEmbeddings`.
+
+::: langchain_google_vertexai.VertexAIEmbeddings
diff --git a/reference/python/docs/integrations/langchain_google_vertexai/index.md b/reference/python/docs/integrations/langchain_google_vertexai/index.md
@@ -8,7 +8,49 @@ title: Google (VertexAI)
 [![PyPI - License](https://img.shields.io/pypi/l/langchain-google-vertexai)](https://opensource.org/licenses/MIT)
 [![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-google-vertexai)](https://pypistats.org/packages/langchain-google-vertexai)
 
-!!! note "Reference docs"
-    This page contains **reference documentation** for Google VertexAI. See [the docs](https://docs.langchain.com/oss/python/integrations/providers/google) for conceptual guides, tutorials, and examples on using Google VertexAI modules.
+LangChain integration for Google's Vertex AI Platform.
 
-::: langchain_google_vertexai
+!!! note "Vertex AI consolidation"
+
+    As of `langchain-google-vertexai` 3.2.0, certain classes are deprecated in favor of equivalents in `langchain-google-genai` 4.0.0, which uses the consolidated [`google-genai`](https://googleapis.github.io/python-genai/) SDK.
+
+    Refer to [the provider docs](https://docs.langchain.com/oss/python/integrations/providers/google) and [release notes](https://github.com/langchain-ai/langchain-google/discussions/1422) for more information.
+
+## Modules
+
+!!! note "Usage documentation"
+    Refer to [the docs](https://docs.langchain.com/oss/python/integrations/providers/google) for a high-level guide on how to use each module. These reference pages contain auto-generated API documentation for each module, focusing on the "what" rather than the "how" or "why" (i.e. no end-to-end tutorials or conceptual overviews).
+
+<div class="grid cards" markdown>
+
+- :material-message-text:{ .lg .middle } **`ChatVertexAI`**
+
+    ---
+
+    **Deprecated:** Use `ChatGoogleGenerativeAI` from `langchain-google-genai` instead.
+
+    [:octicons-arrow-right-24: Reference](./ChatVertexAI.md)
+
+- :material-message-text:{ .lg .middle } **`VertexAI`**
+
+    ---
+
+    **Deprecated:** Use `GoogleGenerativeAI` from `langchain-google-genai` instead.
+
+    [:octicons-arrow-right-24: Reference](./VertexAI.md)
+
+- :fontawesome-solid-layer-group:{ .lg .middle } **`VertexAIEmbeddings`**
+
+    ---
+
+    **Deprecated:** Use `GoogleGenerativeAIEmbeddings` from `langchain-google-genai` instead.
+
+    [:octicons-arrow-right-24: Reference](./VertexAIEmbeddings.md)
+
+- **Other**
+
+    ---
+
+    [:octicons-arrow-right-24: Reference](./other.md)
+
+</div>
diff --git a/reference/python/docs/integrations/langchain_google_vertexai/other.md b/reference/python/docs/integrations/langchain_google_vertexai/other.md
@@ -0,0 +1,15 @@
+---
+title: Other Vertex AI Integrations
+---
+
+# :simple-googlecloud:{ .lg .middle } `Other Vertex AI Integrations`
+
+::: langchain_google_vertexai
+    options:
+      docstring_options:
+        ignore_init_summary: true
+      merge_init_into_class: true
+      filters:
+        - "!^ChatVertexAI$"
+        - "!^VertexAI$"
+        - "!^VertexAIEmbeddings$"
diff --git a/reference/python/docs/langchain/messages.md b/reference/python/docs/langchain/messages.md
@@ -7,6 +7,9 @@
       summary: true
       inherited_members: false
       group_by_category: false
+      docstring_options:
+        ignore_init_summary: true
+      merge_init_into_class: true
       members:
         - AIMessage
         - AIMessageChunk
diff --git a/reference/python/docs/langchain/middleware.md b/reference/python/docs/langchain/middleware.md
@@ -59,7 +59,6 @@ Core types for building middleware:
 | [`ContextTokens`](#langchain.agents.middleware.summarization.ContextTokens) | Summarize at token threshold |
 | [`ContextMessages`](#langchain.agents.middleware.summarization.ContextMessages) | Summarize at message threshold |
 
-
 <!-- TODO: `ignore_init_summary` doesn't seem to work.  -->
 
 ::: langchain.agents.middleware.SummarizationMiddleware
diff --git a/reference/python/docs/langchain_core/callbacks.md b/reference/python/docs/langchain_core/callbacks.md
@@ -1,6 +1,11 @@
-::: langchain_core.callbacks.base.AsyncCallbackHandler
 ::: langchain_core.callbacks.base.BaseCallbackHandler
-::: langchain_core.callbacks.manager.AsyncCallbackManager
+    options:
+      show_inheritance_diagram: true
+::: langchain_core.callbacks.base.AsyncCallbackHandler
+
+::: langchain_core.callbacks.manager.BaseCallbackManager
 ::: langchain_core.callbacks.manager.CallbackManager
+::: langchain_core.callbacks.manager.AsyncCallbackManager
 ::: langchain_core.callbacks.usage.UsageMetadataCallbackHandler
+
 ::: langchain_core.callbacks.usage.get_usage_metadata_callback
diff --git a/reference/python/docs/langchain_core/language_models.md b/reference/python/docs/langchain_core/language_models.md
@@ -1,4 +1,3 @@
-<!-- `members: []` in order to show module docstring -->
 ::: langchain_core.language_models
     options:
       parameter_headings: true
diff --git a/reference/python/mkdocs.yml b/reference/python/mkdocs.yml
@@ -460,9 +460,19 @@ nav:
       - Fireworks: integrations/langchain_fireworks.md
       - Google:
         - integrations/langchain_google/index.md
-        - GenAI (Gemini): integrations/langchain_google_genai/index.md
-        - VertexAI: integrations/langchain_google_vertexai/index.md
-        - Google Community: integrations/langchain_google_community/index.md
+        - GenAI (Gemini):
+          - integrations/langchain_google_genai/index.md
+          - ChatGoogleGenerativeAI: integrations/langchain_google_genai/ChatGoogleGenerativeAI.md
+          - GoogleGenerativeAI: integrations/langchain_google_genai/GoogleGenerativeAI.md
+          - GoogleGenerativeAIEmbeddings: integrations/langchain_google_genai/GoogleGenerativeAIEmbeddings.md
+        - Vertex AI Platform:
+          - integrations/langchain_google_vertexai/index.md
+          - ChatVertexAI: integrations/langchain_google_vertexai/ChatVertexAI.md
+          - VertexAI: integrations/langchain_google_vertexai/VertexAI.md
+          - VertexAIEmbeddings: integrations/langchain_google_vertexai/VertexAIEmbeddings.md
+          - Other: integrations/langchain_google_vertexai/other.md
+        - Google Community:
+          - integrations/langchain_google_community/index.md
       - Groq: integrations/langchain_groq.md
       - HuggingFace: integrations/langchain_huggingface.md
       - IBM:
diff --git a/reference/python/uv.lock b/reference/python/uv.lock
diff --git a/src/oss/python/integrations/chat/google_generative_ai.mdx b/src/oss/python/integrations/chat/google_generative_ai.mdx
diff --git a/src/oss/python/integrations/chat/google_vertex_ai.mdx b/src/oss/python/integrations/chat/google_vertex_ai.mdx
diff --git a/src/oss/python/integrations/llms/google_vertex_ai.mdx b/src/oss/python/integrations/llms/google_vertex_ai.mdx
diff --git a/src/oss/python/integrations/providers/google.mdx b/src/oss/python/integrations/providers/google.mdx
diff --git a/src/oss/python/integrations/text_embedding/google_vertex_ai.mdx b/src/oss/python/integrations/text_embedding/google_vertex_ai.mdx
