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 报告，请使用 GoogleSearchAdsSearchOperator。

tests/system/google/marketing_platform/example_search_ads.py

query_report = GoogleSearchAdsSearchOperator(
    task_id="query_report",
    customer_id=CUSTOMER_ID,
    query=QUERY,
)

您可以对 api_version、 gcp_conn_id、 page_token、 page_size 参数使用 Jinja 模板，这允许您动态确定值。

检索字段元数据¶

要检索字段的元数据，请使用 GoogleSearchAdsGetFieldOperator。

tests/system/google/marketing_platform/example_search_ads.py

get_field = GoogleSearchAdsGetFieldOperator(
    task_id="get_field",
    field_name=FIELD_NAME,
)

您可以对 api_version、 gcp_conn_id 参数使用 Jinja 模板，这允许您动态确定值。

检索多个字段的元数据¶

要检索多个字段的元数据，请使用 GoogleSearchAdsSearchFieldsOperator。

tests/system/google/marketing_platform/example_search_ads.py

search_fields = GoogleSearchAdsSearchFieldsOperator(
    task_id="search_fields",
    query=SEARCH_FIELDS_QUERY,
)

您可以对 api_version、 gcp_conn_id、 page_token、 page_size 参数使用 Jinja 模板，这允许您动态确定值。

检索自定义列详情¶

要检索自定义列的详情，请使用 GoogleSearchAdsGetCustomColumnOperator。

tests/system/google/marketing_platform/example_search_ads.py

get_custom_column = GoogleSearchAdsGetCustomColumnOperator(
    task_id="get_custom_column",
    customer_id=CUSTOMER_ID,
    custom_column_id=CUSTOM_COLUMN_ID,
)

您可以对 api_version、 gcp_conn_id 参数使用 Jinja 模板，这允许您动态确定值。

检索自定义列详情¶

要检索所有自定义列的列表，请使用

GoogleSearchAdsListCustomColumnsOperator.

tests/system/google/marketing_platform/example_search_ads.py

list_custom_columns = GoogleSearchAdsListCustomColumnsOperator(
    task_id="list_custom_columns",
    customer_id=CUSTOMER_ID,
)

您可以对 api_version、 gcp_conn_id 参数使用 Jinja 模板，这允许您动态确定值。