====== Search Intelligence — Google Search Console Connector User Guide ======

===== Related overview =====

For a shopper-friendly overview of features and setup, see the [[https://toweringmedia.com/magento-2-search-intelligence-gsc-connector-user-guide|Magento 2 Google Search Console Connector User Guide]] on the storefront. This wiki page remains the full technical documentation.

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.

===== Product page =====

  * [[https://toweringmedia.com/search-intelligence-google-search-console-connector|Search Intelligence — Google Search Console Connector]] (SKU ''tm-search-intelligence-gsc'')

===== Overview =====

This connector brings Google Search Console data into Search Intelligence. It authenticates over OAuth, takes scheduled performance snapshots, supports live URL inspection, and can manage sitemap submission and indexing requests from the Magento admin.

===== What this extension does =====

  * OAuth connection to Google Search Console.
  * Scheduled performance snapshots stored in Magento.
  * URL inspection from the admin.
  * Sitemap management and indexing submission.

===== Requirements =====

  * Magento 2.4.x (Open Source or Adobe Commerce).
  * PHP: ^8.1 || ^8.2 || ^8.3 || ^8.4 (as declared by the published package).
  * A current Toweringmedia license and Composer credentials for ''https://composer.toweringmedia.com/''.
  * Requires ''toweringmedia/module-search-intelligence-core'' — Composer installs it automatically.
  * A Google account with Search Console access to the property, and a Google Cloud OAuth client.
  * This module is part of the Search Intelligence suite. Search Intelligence Core must be installed and working first — the connectors and appliers plug into Core's dashboard, advisory queue, and change-set workflow.

===== Installation =====

Install and validate in a staging environment before production rollout.

<code bash>
cd /path/to/magento
composer require toweringmedia/module-search-intelligence-gsc

bin/magento module:enable Toweringmedia_SearchIntelligenceGsc
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
</code>

Currently published versions at the time of writing:

  * ''toweringmedia/module-search-intelligence-gsc'' — 1.3.0

Toweringmedia packages are served from the licensed Composer repository ''https://composer.toweringmedia.com/''. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from **My Account** on toweringmedia.com, or contact [[mailto:support@toweringmedia.com|support@toweringmedia.com]].

General installation notes that apply to every Toweringmedia extension are in the [[https://toweringmedia.com/installation|installation guide]].

===== Configuration =====

  * Stores > Configuration > Towering Media > **Google Search Console Connector Settings** (config section ''search_intelligence_gsc'').
  * Groups: ''connection'', ''scheduled_sync'', ''operational_cache'', ''inspection'', and ''indexing_submit''.
  * Admin screens: Intelligence SEO Suite > Connectors > **Search Console**, **URL Inspection**, **Sitemap management**.

===== Basic usage and what to expect =====

  - Complete the OAuth connection and select the correct Search Console property — a mismatched property is the usual reason no data appears.
  - Enable scheduled sync and wait for the first snapshot to populate.
  - Use URL Inspection to confirm individual pages are indexed as expected.

===== Validation checklist =====

  * ''bin/magento module:status'' shows the module(s) as enabled.
  * Extension configuration saves without errors in Admin.
  * The admin screens listed above are reachable and load without error.
  * Expected storefront/admin behavior is present after a cache flush.
  * No critical PHP/JS errors appear in ''var/log/'' during the primary test flow.

===== Troubleshooting =====

  * **Composer cannot find the package**: confirm the ''https://composer.toweringmedia.com/'' repository and your credentials are present in ''auth.json'', and that your license covers this package.
  * **Feature not visible**: verify module status, flush cache, and redeploy static content.
  * **Admin setting not applying**: clear cache and confirm the config scope (default / website / store view).
  * **Unexpected behavior**: retest with only the required related modules enabled.

===== Support =====

  * [[mailto:support@toweringmedia.com|support@toweringmedia.com]]
  * [[https://toweringmedia.com/magento-maintenance-support|Magento maintenance and support]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[start|Global docs home]]