Merge remote-tracking branch 'github/main' into prerelease_and_pandas_3

Author: TrevorBergeron

.github/CODEOWNERS

@@ -5,8 +5,8 @@
 # https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners#codeowners-syntax
 # Note: This file is autogenerated. To make changes to the codeowner team, please update .repo-metadata.json.
 
-# @googleapis/yoshi-python @googleapis/api-bigquery-dataframe are the default owners for changes in this repo
-*     @googleapis/yoshi-python @googleapis/api-bigquery-dataframe
+# @googleapis/cloud-sdk-python-team @googleapis/bigquery-dataframe-team are the default owners for changes in this repo
+*     @googleapis/cloud-sdk-python-team @googleapis/bigquery-dataframe-team
 
-# @googleapis/python-samples-reviewers @googleapis/api-bigquery-dataframe are the default owners for samples changes
-/samples/   @googleapis/python-samples-reviewers @googleapis/api-bigquery-dataframe
+# @googleapis/python-samples-reviewers @googleapis/bigquery-dataframe-team are the default owners for samples changes
+/samples/   @googleapis/python-samples-reviewers @googleapis/bigquery-dataframe-team

.github/blunderbuss.yml

@@ -4,14 +4,14 @@
 # Note: This file is autogenerated. To make changes to the assignee
 # team, please update `codeowner_team` in `.repo-metadata.json`.
 assign_issues:
-  - googleapis/api-bigquery-dataframe
+  - googleapis/bigquery-dataframe-team
 
 assign_issues_by:
   - labels:
       - "samples"
     to:
       - googleapis/python-samples-reviewers
-      - googleapis/api-bigquery-dataframe
+      - googleapis/bigquery-dataframe-team
 
 assign_prs:
-  - googleapis/api-bigquery-dataframe
+  - googleapis/bigquery-dataframe-team

.librarian/state.yaml

@@ -1,7 +1,7 @@
 image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:1a2a85ab507aea26d787c06cc7979decb117164c81dd78a745982dfda80d4f68
 libraries:
   - id: bigframes
-    version: 2.35.0
+    version: 2.36.0
     last_generated_commit: ""
     apis: []
     source_roots:

.repo-metadata.json

@@ -11,6 +11,6 @@
     "distribution_name": "bigframes",
     "api_id": "bigquery.googleapis.com",
     "default_version": "",
-    "codeowner_team": "@googleapis/api-bigquery-dataframe",
+    "codeowner_team": "@googleapis/bigquery-dataframe-team",
     "api_shortname": "bigquery"
 }

CHANGELOG.md

@@ -4,6 +4,24 @@
 
 [1]: https://pypi.org/project/bigframes/#history
 
+## [2.36.0](https://github.com/googleapis/python-bigquery-dataframes/compare/v2.35.0...v2.36.0) (2026-02-17)
+
+
+### Documentation
+
+* update multimodal dataframe notebook to use public APIs (#2456) ([342fa723c4631d371364a87ae0ddd6fa03360a4b](https://github.com/googleapis/python-bigquery-dataframes/commit/342fa723c4631d371364a87ae0ddd6fa03360a4b))
+* use direct API for pdf chunk and pdf extract (#2452) ([543ce52c18269eab2a89886f226d1478dbabf9ba](https://github.com/googleapis/python-bigquery-dataframes/commit/543ce52c18269eab2a89886f226d1478dbabf9ba))
+* fix generate_text and generate_table input docs (#2455) ([078bd32ebd28af0d2cfba6bb874ba79e904183e2](https://github.com/googleapis/python-bigquery-dataframes/commit/078bd32ebd28af0d2cfba6bb874ba79e904183e2))
+* Update multimodal notebook to use public runtime helpers (#2451) ([e36dd8b492fd7ab433fa4cac732b31774c1e428b](https://github.com/googleapis/python-bigquery-dataframes/commit/e36dd8b492fd7ab433fa4cac732b31774c1e428b))
+* use direct API for audio transcription (#2447) ([59cbc5db66fd178ecce03bf4b8b4a504d7ef3e9f](https://github.com/googleapis/python-bigquery-dataframes/commit/59cbc5db66fd178ecce03bf4b8b4a504d7ef3e9f))
+* Add EXIF metadata extraction example to multimodal notebook (#2429) ([84c6f883aef8048e7013a8b3c03a1bde47e94eea](https://github.com/googleapis/python-bigquery-dataframes/commit/84c6f883aef8048e7013a8b3c03a1bde47e94eea))
+
+
+### Features
+
+* Initial support for biglake iceberg tables (#2409) ([ae35a9890a2f9903b12e431488362c091118bbdd](https://github.com/googleapis/python-bigquery-dataframes/commit/ae35a9890a2f9903b12e431488362c091118bbdd))
+* add bigquery.ai.generate_table function (#2453) ([b925aa243dad0e42ad126c9397f42be0aad7152d](https://github.com/googleapis/python-bigquery-dataframes/commit/b925aa243dad0e42ad126c9397f42be0aad7152d))
+
 ## [2.35.0](https://github.com/googleapis/python-bigquery-dataframes/compare/v2.34.0...v2.35.0) (2026-02-07)
 
 

bigframes/_config/bigquery_options.py

@@ -127,6 +127,11 @@ def application_name(self) -> Optional[str]:
         The recommended format is  ``"application-name/major.minor.patch_version"``
         or ``"(gpn:PartnerName;)"`` for official Google partners.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.application_name = "my-app/1.0.0"  # doctest: +SKIP
+
         Returns:
             None or str:
                 Application name as a string if exists; otherwise None.
@@ -145,6 +150,13 @@ def application_name(self, value: Optional[str]):
     def credentials(self) -> Optional[google.auth.credentials.Credentials]:
         """The OAuth2 credentials to use for this client.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> import google.auth
+            >>> credentials, project = google.auth.default()  # doctest: +SKIP
+            >>> bpd.options.bigquery.credentials = credentials  # doctest: +SKIP
+
         Returns:
             None or google.auth.credentials.Credentials:
                 google.auth.credentials.Credentials if exists; otherwise None.
@@ -163,6 +175,11 @@ def location(self) -> Optional[str]:
 
         For more information, see https://cloud.google.com/bigquery/docs/locations BigQuery locations.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.location = "US"  # doctest: +SKIP
+
         Returns:
             None or str:
                 Default location as a string; otherwise None.
@@ -179,6 +196,11 @@ def location(self, value: Optional[str]):
     def project(self) -> Optional[str]:
         """Google Cloud project ID to use for billing and as the default project.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.project = "my-project"  # doctest: +SKIP
+
         Returns:
             None or str:
                 Google Cloud project ID as a string; otherwise None.
@@ -206,6 +228,11 @@ def bq_connection(self) -> Optional[str]:
         If this option isn't provided, or project or location aren't provided,
         session will use its default project/location/connection_id as default connection.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.bq_connection = "my-project.us.my-connection"  # doctest: +SKIP
+
         Returns:
             None or str:
                 Name of the BigQuery connection as a string; otherwise None.
@@ -228,6 +255,11 @@ def skip_bq_connection_check(self) -> bool:
         necessary permissions set up to support BigQuery DataFrames operations,
         then a runtime error will be reported.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.skip_bq_connection_check = True  # doctest: +SKIP
+
         Returns:
             bool:
                 A boolean value, where True indicates a BigQuery connection is
@@ -300,6 +332,12 @@ def use_regional_endpoints(self) -> bool:
         does not promise any guarantee on the request remaining within the
         location during transit.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.location = "europe-west3"  # doctest: +SKIP
+            >>> bpd.options.bigquery.use_regional_endpoints = True  # doctest: +SKIP
+
         Returns:
             bool:
               A boolean value, where True indicates that regional endpoints
@@ -339,6 +377,11 @@ def kms_key_name(self) -> Optional[str]:
         For more information, see https://cloud.google.com/bigquery/docs/customer-managed-encryption#assign_role
         Assign the Encrypter/Decrypter.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.kms_key_name = "projects/my-project/locations/us/keyRings/my-ring/cryptoKeys/my-key"  # doctest: +SKIP
+
         Returns:
             None or str:
                 Name of the customer managed encryption key as a string; otherwise None.
@@ -356,6 +399,11 @@ def kms_key_name(self, value: str):
     def ordering_mode(self) -> Literal["strict", "partial"]:
         """Controls whether total row order is always maintained for DataFrame/Series.
 
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.ordering_mode = "partial"  # doctest: +SKIP
+
         Returns:
             Literal:
                 A literal string value of either strict or partial ordering mode.
@@ -432,7 +480,14 @@ def requests_transport_adapters(
 
     @property
     def enable_polars_execution(self) -> bool:
-        """If True, will use polars to execute some simple query plans locally."""
+        """If True, will use polars to execute some simple query plans locally.
+
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.bigquery.enable_polars_execution = True  # doctest: +SKIP
+
+        """
         return self._enable_polars_execution
 
     @enable_polars_execution.setter

bigframes/_config/compute_options.py

@@ -28,30 +28,30 @@ class ComputeOptions:
         >>> import bigframes.pandas as bpd
         >>> df = bpd.read_gbq("bigquery-public-data.ml_datasets.penguins")
 
-        >>> bpd.options.compute.maximum_bytes_billed = 500
+        >>> bpd.options.compute.maximum_bytes_billed = 500  # doctest: +SKIP
         >>> df.to_pandas() # this should fail  # doctest: +SKIP
         google.api_core.exceptions.InternalServerError: 500 Query exceeded limit for bytes billed: 500. 10485760 or higher required.
 
-        >>> bpd.options.compute.maximum_bytes_billed = None  # reset option
+        >>> bpd.options.compute.maximum_bytes_billed = None  # reset option  # doctest: +SKIP
 
     To add multiple extra labels to a query configuration, use the `assign_extra_query_labels`
     method with keyword arguments:
 
-        >>> bpd.options.compute.assign_extra_query_labels(test1=1, test2="abc")
-        >>> bpd.options.compute.extra_query_labels
+        >>> bpd.options.compute.assign_extra_query_labels(test1=1, test2="abc")  # doctest: +SKIP
+        >>> bpd.options.compute.extra_query_labels  # doctest: +SKIP
         {'test1': 1, 'test2': 'abc'}
 
     Alternatively, you can add labels individually by directly accessing the `extra_query_labels`
     dictionary:
 
-        >>> bpd.options.compute.extra_query_labels["test3"] = False
-        >>> bpd.options.compute.extra_query_labels
+        >>> bpd.options.compute.extra_query_labels["test3"] = False  # doctest: +SKIP
+        >>> bpd.options.compute.extra_query_labels  # doctest: +SKIP
         {'test1': 1, 'test2': 'abc', 'test3': False}
 
     To remove a label from the configuration, use the `del` keyword on the desired label key:
 
-        >>> del bpd.options.compute.extra_query_labels["test1"]
-        >>> bpd.options.compute.extra_query_labels
+        >>> del bpd.options.compute.extra_query_labels["test1"]  # doctest: +SKIP
+        >>> bpd.options.compute.extra_query_labels  # doctest: +SKIP
         {'test2': 'abc', 'test3': False}
     """
 
@@ -63,6 +63,11 @@ class ComputeOptions:
     their operations to resume. The default value is 0. Set the value to None
     to turn off the guard.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.ai_ops_confirmation_threshold = 100  # doctest: +SKIP
+
     Returns:
         Optional[int]: Number of rows.
     """
@@ -73,6 +78,11 @@ class ComputeOptions:
 
     When set to True, the operation automatically fails without asking for user inputs.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.ai_ops_threshold_autofail = True  # doctest: +SKIP
+
     Returns:
         bool: True if the guard is enabled.
     """
@@ -85,6 +95,10 @@ class ComputeOptions:
     10 GB for potentially faster execution; BigQuery will raise an error if this
     limit is exceeded. Setting to True removes this result size limit.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.allow_large_results = True  # doctest: +SKIP
 
     Returns:
         bool | None: True if results > 10 GB are enabled.
@@ -97,6 +111,10 @@ class ComputeOptions:
     query engine to handle. However this comes at the cost of increase cost and
     latency.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.enable_multi_query_execution = True  # doctest: +SKIP
 
     Returns:
         bool | None: True if enabled.
@@ -121,6 +139,11 @@ class ComputeOptions:
     default.  See `maximum_bytes_billed`:
     https://cloud.google.com/python/docs/reference/bigquery/latest/google.cloud.bigquery.job.QueryJobConfig#google_cloud_bigquery_job_QueryJobConfig_maximum_bytes_billed.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.maximum_bytes_billed = 1000  # doctest: +SKIP
+
     Returns:
         int | None: Number of bytes, if set.
     """
@@ -136,6 +159,11 @@ class ComputeOptions:
     of rows to be downloaded exceeds this limit, a
     ``bigframes.exceptions.MaximumResultRowsExceeded`` exception is raised.
 
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.compute.maximum_result_rows = 1000  # doctest: +SKIP
+
     Returns:
         int | None: Number of rows, if set.
     """

bigframes/_config/experiment_options.py

@@ -31,6 +31,13 @@ def __init__(self):
 
     @property
     def semantic_operators(self) -> bool:
+        """Deprecated.
+
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.experiments.semantic_operators = True  # doctest: +SKIP
+        """
         return self._semantic_operators
 
     @semantic_operators.setter
@@ -44,6 +51,13 @@ def semantic_operators(self, value: bool):
 
     @property
     def ai_operators(self) -> bool:
+        """If True, allow using the AI operators.
+
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.experiments.ai_operators = True  # doctest: +SKIP
+        """
         return self._ai_operators
 
     @ai_operators.setter

bigframes/_config/sampling_options.py

@@ -31,6 +31,11 @@ class SamplingOptions:
     Download size threshold in MB. Default 500.
 
     If value set to None, the download size won't be checked.
+
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.sampling.max_download_size = 1000  # doctest: +SKIP
     """
 
     enable_downsampling: bool = False
@@ -40,6 +45,11 @@ class SamplingOptions:
     If max_download_size is exceeded when downloading data (e.g., to_pandas()),
     the data will be downsampled if enable_downsampling is True, otherwise, an
     error will be raised.
+
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.sampling.enable_downsampling = True  # doctest: +SKIP
     """
 
     sampling_method: Literal["head", "uniform"] = "uniform"
@@ -50,6 +60,11 @@ class SamplingOptions:
     the beginning. It is fast and requires minimal computations to perform the
     downsampling.; "uniform": This algorithm returns uniform random samples of
     the data.
+
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.sampling.sampling_method = "head"  # doctest: +SKIP
     """
 
     random_state: Optional[int] = None
@@ -58,6 +73,11 @@ class SamplingOptions:
 
     If provided, the uniform method may take longer to execute and require more
     computation.
+
+    **Examples:**
+
+        >>> import bigframes.pandas as bpd
+        >>> bpd.options.sampling.random_state = 42  # doctest: +SKIP
     """
 
     def with_max_download_size(self, max_rows: Optional[int]) -> SamplingOptions: