Google 搜尋廣告運算子¶

使用單一集中化工具，跨多個搜尋引擎建立、管理和追蹤高效益的廣告活動。如需更多資訊，請查看 Google 搜尋廣告。

先決條件任務¶

若要使用這些運算子，您必須完成幾件事

使用 Cloud Console 選擇或建立 Cloud Platform 專案。

為您的專案啟用計費功能，如 Google Cloud 文件所述。

啟用 API，如 Cloud Console 文件所述。
透過 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,
)

您可以搭配 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 模板，讓您動態決定數值。