Google 搜索广告运算符¶

使用一个集中的工具，跨多个搜索引擎创建、管理和跟踪高影响力的广告活动。有关更多信息，请查看Google 搜索广告。

先决条件任务¶

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

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

按照Google Cloud 文档中的描述，为您的项目启用结算。

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

查询报告¶

要查询搜索广告报告，请使用 GoogleSearchAdsSearchOperator。

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

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

您可以将Jinja 模板与 api_version、 gcp_conn_id、 page_token、 page_size 参数一起使用，从而动态确定值。

检索字段元数据¶

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

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

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

您可以将Jinja 模板与 api_version、 gcp_conn_id 参数一起使用，从而动态确定值。

检索多个字段的元数据¶

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

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

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

您可以将Jinja 模板与 api_version、 gcp_conn_id、 page_token、 page_size 参数一起使用，从而动态确定值。

检索自定义列的详细信息¶

要检索自定义列的详细信息，请使用 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,
)

您可以将Jinja 模板与 api_version、 gcp_conn_id 参数一起使用，从而动态确定值。

检索自定义列的详细信息¶

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

GoogleSearchAdsListCustomColumnsOperator.

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

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

您可以将Jinja 模板与 api_version、 gcp_conn_id 参数一起使用，从而动态确定值。