chore(merchant): restructure package

Author: AndreyMarkinPPC

libs/community/google/merchant/README.md

@@ -17,8 +17,8 @@
 
 ### Run as a library
 ```
-from garf_merchant_api import report_fetcher
-from garf_io import writer
+from garf.community.google.merchant import report_fetcher
+from garf.io import writer
 
 
 # Specify query

libs/community/google/merchant/garf/community/google/merchant/__init__.py

@@ -0,0 +1,29 @@
+# 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
+#
+#     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.
+
+"""Library for fetching reports from Google Merchant API."""
+
+from __future__ import annotations
+
+from garf.community.google.merchant.api_clients import MerchantApiClient
+from garf.community.google.merchant.report_fetcher import (
+  MerchantApiReportFetcher,
+)
+
+__all__ = [
+  'MerchantApiClient',
+  'MerchantApiReportFetcher',
+]
+
+__version__ = '0.0.1'

libs/community/google/merchant/garf/community/google/merchant/api_clients.py

@@ -0,0 +1,51 @@
+# 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
+#
+#     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.
+"""Creates API client for Merchant API."""
+
+from garf.community.google.merchant import exceptions
+from garf.core import api_clients, query_editor
+from google.shopping import merchant_reports_v1beta
+from typing_extensions import override
+
+
+class MerchantApiError(exceptions.GarfMerchantApiError):
+  """API specific error."""
+
+
+class MerchantApiClient(api_clients.BaseClient):
+  def __init__(
+    self,
+    **kwargs: str,
+  ) -> None:
+    """Initializes MerchantClient."""
+    self.query_args = kwargs
+
+  @override
+  def get_response(
+    self, request: query_editor.BaseQueryElements, **kwargs: str
+  ) -> api_clients.GarfApiResponse:
+    if not (account := kwargs.get('account')):
+      raise MerchantApiError('Missing account parameter')
+    client = merchant_reports_v1beta.ReportServiceClient()
+    merchant_request = merchant_reports_v1beta.SearchRequest(
+      parent=f'accounts/{account}',
+      query=request.text,
+    )
+    response = client.search(request=merchant_request)
+    results = []
+    for page in response:
+      for rows in page.get('results'):
+        for _, row in rows.items():
+          results.append(row)
+    return api_clients.GarfApiResponse(results=results)

libs/community/google/merchant/garf/community/google/merchant/exceptions.py

@@ -0,0 +1,19 @@
+# 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
+#
+#     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.
+
+from garf.core import exceptions
+
+
+class GarfMerchantApiError(exceptions.GarfError):
+  """Base class for all library exceptions."""

libs/community/google/merchant/garf/community/google/merchant/query_editor.py

@@ -0,0 +1,45 @@
+# 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
+#
+#     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.
+"""Defines MerchantQuery."""
+
+from garf.core import query_editor
+from typing_extensions import Self
+
+
+def _to_camel_case(field: str) -> str:
+  first, *others = field.split('_')
+  return ''.join([first.lower(), *map(str.title, others)])
+
+
+class MerchantApiQuery(query_editor.QuerySpecification):
+  """Query to Knowledge Graph Search api."""
+
+  def __init__(
+    self,
+    text: str,
+    title: str | None = None,
+    args: dict[str, str] | None = None,
+    **kwargs,
+  ) -> None:
+    """Initializes MerchantApiQuery."""
+    super().__init__(text, title, args, **kwargs)
+
+  def extract_fields(self) -> Self:
+    for line in self._extract_query_lines():
+      line_elements = query_editor.ExtractedLineElements.from_query_line(line)
+      if field := line_elements.field:
+        self.query.fields.append(
+          _to_camel_case(field) if '_' in field else field
+        )
+    return self

libs/community/google/merchant/garf/community/google/merchant/report_fetcher.py

@@ -0,0 +1,32 @@
+# 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
+#
+#     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.
+
+"""Defines report fetcher."""
+
+from garf.community.google.merchant import MerchantApiClient, query_editor
+from garf.core import parsers, report_fetcher
+
+
+class MerchantApiReportFetcher(report_fetcher.ApiReportFetcher):
+  """Defines report fetcher."""
+
+  def __init__(
+    self,
+    api_client: MerchantApiClient = MerchantApiClient(),
+    parser: parsers.BaseParser = parsers.NumericConverterDictParser,
+    query_spec: query_editor.MerchantApiQuery = query_editor.MerchantApiQuery,
+    **kwargs: str,
+  ) -> None:
+    """Initializes MerchantApiReportFetcher."""
+    super().__init__(api_client, parser, query_spec, **kwargs)

libs/community/google/merchant/garf_merchant_api/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2025 Google LLC
+# 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.
@@ -12,18 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Library for fetching reports from Google Merchant API."""
+import warnings
 
-from __future__ import annotations
+from garf.community.google.merchant import *
 
-from garf_merchant_api.api_clients import MerchantApiClient
-from garf_merchant_api.report_fetcher import (
-  MerchantApiReportFetcher,
+warnings.warn(
+  "The 'garf_merchant_api' namespace is deprecated. "
+  "Please use 'garf.community.google.merchant' instead.",
+  DeprecationWarning,
+  stacklevel=2,
 )
-
-__all__ = [
-  'MerchantApiClient',
-  'MerchantApiReportFetcher',
-]
-
-__version__ = '0.0.1'

libs/community/google/merchant/garf_merchant_api/api_clients.py

@@ -1,4 +1,4 @@
-# Copyright 2025 Google LLC
+# 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.
@@ -11,42 +11,14 @@
 # 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.
-"""Creates API client for Merchant API."""
 
-from garf_core import api_clients, query_editor
-from google.shopping import merchant_reports_v1beta
-from typing_extensions import override
+import warnings
 
-from garf_merchant_api import exceptions
+from garf.community.google.merchant.api_clients import *
 
-
-class MerchantApiError(exceptions.GarfMerchantApiError):
-  """API specific error."""
-
-
-class MerchantApiClient(api_clients.BaseClient):
-  def __init__(
-    self,
-    **kwargs: str,
-  ) -> None:
-    """Initializes MerchantClient."""
-    self.query_args = kwargs
-
-  @override
-  def get_response(
-    self, request: query_editor.BaseQueryElements, **kwargs: str
-  ) -> api_clients.GarfApiResponse:
-    if not (account := kwargs.get('account')):
-      raise MerchantApiError('Missing account parameter')
-    client = merchant_reports_v1beta.ReportServiceClient()
-    merchant_request = merchant_reports_v1beta.SearchRequest(
-      parent=f'accounts/{account}',
-      query=request.text,
-    )
-    response = client.search(request=merchant_request)
-    results = []
-    for page in response:
-      for rows in page.get('results'):
-        for _, row in rows.items():
-          results.append(row)
-    return api_clients.GarfApiResponse(results=results)
+warnings.warn(
+  "The 'garf_merchant_api' namespace is deprecated. "
+  "Please use 'garf.community.google.merchant' instead.",
+  DeprecationWarning,
+  stacklevel=2,
+)

libs/community/google/merchant/garf_merchant_api/exceptions.py

@@ -1,4 +1,4 @@
-# Copyright 2025 Google LLC
+# 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.
@@ -12,8 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from garf_core import exceptions
+import warnings
 
+from garf.community.google.merchant.exceptions import *
 
-class GarfMerchantApiError(exceptions.GarfError):
-  """Base class for all library exceptions."""
+warnings.warn(
+  "The 'garf_merchant_api' namespace is deprecated. "
+  "Please use 'garf.community.google.merchant' instead.",
+  DeprecationWarning,
+  stacklevel=2,
+)

libs/community/google/merchant/garf_merchant_api/fake_api_response.json

@@ -0,0 +1,56 @@
+{
+  "results": [
+    {
+      "productView": {
+        "id": "online~en~US~id0"
+        "offerId": "id0",
+        "feedLabel": "US",
+        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
+        "itemIssues": [
+          {
+            "type": {
+              "code": "invalid_string_value",
+              "canonicalAttribute": "n:product_code"
+            },
+            "severity": {
+              "severityPerReportingContext": [
+                {
+                  "reportingContext": "SHOPPING_ADS",
+                  "disapprovedCountries": [
+                    "US"
+                  ]
+                },
+                {
+                  "reportingContext": "FREE_LISTINGS",
+                  "disapprovedCountries": [
+                    "US"
+                  ]
+                }
+              ],
+              "aggregatedSeverity": "DISAPPROVED"
+            },
+            "resolution": "MERCHANT_ACTION"
+          },
+          {
+            "type": {
+              "code": "apparel_missing_brand",
+              "canonicalAttribute": "n:brand"
+            },
+            "severity": {
+              "severityPerReportingContext": [
+                {
+                  "reportingContext": "SHOPPING_ADS",
+                  "disapprovedCountries": [
+                    "US"
+                  ]
+                }
+              ],
+              "aggregatedSeverity": "DEMOTED"
+            },
+            "resolution": "MERCHANT_ACTION"
+          }
+        ]
+      }
+    }
+  ]
+}