fix(api-core): add transcode alias, input validation, and gapic_v1 re-export

Author: hebaalazzeh

packages/google-api-core/google/api_core/gapic_v1/rest_helpers.py

@@ -0,0 +1,20 @@
+# Copyright 2026 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
+#
+#     http://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.
+
+from google.api_core.rest_helpers import (
+    transcode,
+    transcode_request,
+)
+
+__all__ = ["transcode", "transcode_request"]

packages/google-api-core/google/api_core/rest_helpers.py

@@ -135,6 +135,9 @@ def transcode_request(
             - The serialized request body JSON string, or None if no body.
             - The query parameters dictionary.
     """
+    if request is None:
+        raise TypeError("request cannot be None")
+
     # Convert proto-plus message to its underlying protobuf message if needed
     pb_request = getattr(request, "_pb", request)
 
@@ -163,3 +166,7 @@ def transcode_request(
         query_params_json["$alt"] = "json;enum-encoding=int"
 
     return transcoded_request, body_json, query_params_json
+
+
+transcode = transcode_request
+

packages/google-api-core/tests/unit/test_rest_helpers.py

@@ -252,3 +252,34 @@ def test_transcode_with_required_fields_existing_key():
     )
 
     assert query_params["name"] == "custom-name"
+
+
+def test_transcode_alias_and_gapic_v1_import():
+    from google.api_core.gapic_v1.rest_helpers import (
+        transcode as tr_gapic,
+        transcode_request as tr_req_gapic,
+    )
+    from google.api_core.rest_helpers import transcode as tr_top
+
+    assert tr_gapic is transcode_request
+    assert tr_req_gapic is transcode_request
+    assert tr_top is transcode_request
+
+
+def test_transcode_request_invalid_request():
+    http_options = [{"method": "get", "uri": "/v1/test"}]
+    with pytest.raises(TypeError, match="request cannot be None"):
+        transcode_request(http_options, None)
+
+
+def test_transcode_request_proto_plus_wrapper():
+    http_options = [{"method": "get", "uri": "/v1/test/{name}"}]
+    mock_pb = descriptor_pb2.FieldDescriptorProto()
+    mock_pb.name = "proto-plus-field"
+
+    mock_proto_plus = mock.Mock()
+    mock_proto_plus._pb = mock_pb
+
+    transcoded, _, _ = transcode_request(http_options, mock_proto_plus)
+    assert transcoded["uri"] == "/v1/test/proto-plus-field"
+