Google Search Ads 运算符¶

使用一个集中式工具在多个搜索引擎中创建、管理和跟踪高影响力广告系列。如需了解更多信息，请查看 Google Search Ads。

先决任务¶

要使用这些运算符，您必须执行以下几项操作

使用 Cloud Console 选择或创建一个 Cloud Platform 项目。

为您的项目启用帐单，如 Google Cloud 文档中所述。

启用 API，如 Cloud Console 文档中所述。
通过 pip 安装 API 库。
pip install 'apache-airflow[google]'
有关安装的详细信息，请参阅。
设置 Google Cloud 连接.

插入报告¶

要插入 Search Ads 报告，请使用 GoogleSearchAdsInsertReportOperator。

tests/system/providers/google/marketing_platform/example_search_ads.py[源代码]

generate_report = GoogleSearchAdsInsertReportOperator(report=REPORT, task_id="generate_report")

你可以将 Jinja 模板与 report、impersonation_chain 参数一起使用，这些参数允许你动态确定值。你可以使用 ``.json`` 文件提供报表定义，因为此操作符支持此模板扩展。结果将保存到 XCom 中，这样其他操作符就可以使用它

tests/system/providers/google/marketing_platform/example_search_ads.py[源代码]

report_id = cast(str, XComArg(generate_report, key="report_id"))

等待报表¶

要等待报表准备好下载，请使用 GoogleSearchAdsReportSensor。

tests/system/providers/google/marketing_platform/example_search_ads.py[源代码]

wait_for_report = GoogleSearchAdsReportSensor(report_id=report_id, task_id="wait_for_report")

你可以将 Jinja 模板与 report_id、impersonation_chain 参数一起使用，这些参数允许你动态确定值。

下载报表¶

要将 Search Ads 报表下载到 Google Cloud Storage 存储分区，请使用 GoogleSearchAdsDownloadReportOperator。

tests/system/providers/google/marketing_platform/example_search_ads.py[源代码]

download_report = GoogleSearchAdsDownloadReportOperator(
    report_id=report_id, bucket_name=GCS_BUCKET, task_id="download_report"
)

你可以将 Jinja 模板与 report_name、report_id、bucket_name、impersonation_chain 参数一起使用，这些参数允许你动态确定值。结果将保存到 XCom 中，这样其他操作符就可以使用它。