Actions6
Overview
The node connects to the Google Search Console API to retrieve and manage sitemap details for verified websites. Specifically, the Get Sitemap Details operation fetches detailed information about a particular sitemap URL associated with a verified site.
This node is useful for website administrators, SEO specialists, and digital marketers who want to programmatically access sitemap metadata such as last submission date, status, and coverage directly from Google Search Console. It helps automate monitoring and management of sitemaps to ensure proper indexing by Google.
Practical example:
You have multiple verified sites in your Google Search Console account and want to check the status and details of a specific sitemap file (e.g., https://example.com/sitemap.xml) to verify if it was successfully processed or if there are any errors reported by Google.
Properties
| Name | Meaning |
|---|---|
| Site URL Mode | Choose how to specify the site URL: either pick from your verified sites or enter manually. |
| Site URL | The verified site URL selected from your list of verified sites (shown if "Pick from My Verified Sites" is chosen). |
| Site URL (Manual) | Manually enter the verified site URL or domain in the format like https://example.com/ or sc-domain:example.com. |
| Sitemap URL | The full URL of the sitemap file you want to get details for, e.g., https://example.com/sitemap.xml. This is required. |
Output
The output JSON object contains detailed information about the specified sitemap, including but not limited to:
siteUrl: The verified site URL associated with the sitemap.sitemapUrl: The URL of the sitemap file queried.- Various metadata fields returned by the Google Search Console API about the sitemap, such as:
- Last downloaded time
- Sitemap type
- Number of submitted URLs
- Number of indexed URLs
- Errors or warnings related to the sitemap
The exact structure mirrors the response from the Google Search Console API's sitemap detail endpoint.
No binary data is output by this operation.
Dependencies
Requires valid authentication credentials for Google Search Console API. The node supports two types of authentication:
- OAuth2 API key credential
- Service Account credential with appropriate permissions
The node makes HTTP requests to Google Search Console endpoints and requires network access.
No additional environment variables are explicitly required beyond configuring the credentials in n8n.
Troubleshooting
Common issues:
- No site selected: If the site URL is missing or invalid, the node throws an error indicating no site was selected.
- Sitemap URL missing: The sitemap URL property is mandatory; omitting it causes an error.
- Authentication failed: If credentials are not configured properly or expired, the node will fail to authenticate with Google APIs.
- API quota limits: Excessive requests may hit Google API quotas, resulting in errors.
Error messages and resolutions:
"No site selected."ā Ensure you select or enter a valid verified site URL."Sitemap URL is required."ā Provide a valid sitemap URL."Authentication failed: ..."ā Check your Google API credentials and refresh tokens or service account keys.- Network or HTTP errors ā Verify internet connectivity and Google API availability.