Add List Annotations Tools

[ryota-yamada-jp]

Overview

This pull request introduces the list_property_annotations tool, designed to retrieve a list of annotations set on a Google Analytics 4 (GA4) property. It utilizes theproperties.reportingDataAnnotations method from the Google Analytics Data API v1alpha.

Use Cases

This tool is intended for users who actively use GA4's annotation feature to log chronological events related to their website or business. For instance, it is ideal for scenarios where clients record information such as:

• Marketing campaign periods.
• Events that significantly impacted web traffic (e.g., press releases, major outages).
• Launch dates for new features or services.

By using this tool as a supplement to reporting workflows, analysts can easily correlate GA4 report data with real-world events. This enables a deeper and more accurate understanding of what drives fluctuations in metrics, helping to create more insightful and context-aware reports.

[jradcliff]

Thanks for the PR!

The lint check failed due to formatting not adhering to the code style. See:

https://github.com/googleanalytics/google-analytics-mcp/blob/main/CONTRIBUTING.md#code-style

2 files would be reformatted, 12 files would be left unchanged.
nox > Command black --check -l 80 --exclude '/(v[0-9]+|\.eggs|\.git|_cache|\.nox|\.tox|\.venv|env|venv|\.svn|_build|buck-out|build|dist)/' . failed with exit code 1
nox > Session lint failed.
Error: Process completed with exit code 1.

Could you run nox -s format and upload another commit to the PR?

[ryota-yamada-jp]

@jradcliff Thank you! I did format.