Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

在地生活服務廣告活動

在地生活服務廣告活動可讓您在 Google 上宣傳商家，並直接從潛在顧客獲得待開發客戶。本指南概述 Google Ads API 支援的操作和限制。

支援作業

Google Ads API 支援下列在地生活服務廣告活動作業。

擷取在地生活服務廣告活動和預算

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法，查詢 advertising_channel_type = 'LOCAL_SERVICES' 的 Campaign 資源，擷取在地生活服務廣告活動和預算。範例如下：

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

編輯在地生活服務廣告活動

您可以更新廣告活動的 status 和相關廣告活動預算的 amount_micros 欄位。

設定出價策略

您可以將下列出價策略設為在地生活服務廣告活動的標準出價策略：

ManualCpa：設定 manual_cpa 欄位

您可以透過 LocalServicesCampaignSettings.category_bids 設定 ManualCpa 的出價。您可以透過 Campaign.local_services_campaign_settings 擷取及設定在地生活服務廣告活動的 LocalServicesCampaignSettings。
MaximizeConversions：設定 maximize_conversions 欄位

將廣告時段設為廣告活動條件

您可以將在地生活服務廣告活動的廣告時段設為廣告活動條件。

建立 AdScheduleInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 CampaignCriterion 的 ad_schedule。

設定指定地區

如要為在地生活服務廣告活動啟用指定地區，請新增 LocationInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 CampaignCriterion 的 location 欄位。詳情請參閱「指定地區」。

指定特定服務類型

如要啟用特定服務類型的指定目標，請使用其中一個在地生活服務類別 ID 建立 LocalServiceIdInfo，在 CampaignCriterion 的 local_service_id 欄位中設定，然後使用 CampaignCriterionService.MutateCampaignCriteria 提交。

請務必使用與廣告活動指定地區和類別相符的服務 ID。

提交待開發客戶意見

使用 LocalServicesLeadService 的 ProvideLeadFeedback 方法，提交待開發客戶的評分和意見回饋。您也可以檢查 LocalServicesLead 的 lead_feedback_submitted 欄位，判斷是否已評估待開發客戶並提交意見回饋。

不支援的操作

下表列出獨立在地生活服務廣告活動 (advertising_channel_type = 'LOCAL_SERVICES') 不支援的操作。

不支援的操作
建立及移除廣告活動	Google Ads API 會禁止建立及移除獨立在地生活服務廣告活動 (`advertising_channel_type = 'LOCAL_SERVICES'`)。自 `v26`起，您可以設定 `pmax_campaign_settings.local_services_enabled = true` 來建立新的在地生活服務最高成效廣告活動 (`advertising_channel_type = 'PERFORMANCE_MAX'`)；請參閱「建立在地生活服務最高成效廣告活動」。
廣告活動中子實體的操作	如果是獨立在地生活服務廣告活動 (`advertising_channel_type = 'LOCAL_SERVICES'`)，Google Ads API 不支援建立、修改、移除或擷取廣告群組、廣告或條件，但「支援的操作」中列出的廣告活動條件除外。如果是在地生活服務最高成效廣告活動，請使用素材資源群組和廣告活動條件。

在地生活服務資源

在地生活服務廣告的部分資料會透過下列唯讀報表資源，直接在 Google Ads API 中公開：

如要讓這些資源傳回資料，提出要求的客戶帳戶中必須有在地生活服務廣告活動，或在地生活服務最高成效廣告活動。local_services_lead.campaign 欄位會將待開發客戶記錄連結回相關聯的廣告活動 (包括campaign.advertising_channel_type = 'PERFORMANCE_MAX' 和 campaign.pmax_campaign_settings.local_services_enabled = true 的最高成效廣告活動，用於每位待開發客戶付費目標)。如要找出這些資源所屬的廣告活動，請使用下列查詢：

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

在地生活服務待開發客戶

LocalServicesLead 會揭露消費者致電、傳送訊息、預訂服務或使用廣告主優待券時產生的待開發客戶詳細資料。

前置字元類型由 LocalServicesLeadType 定義。v26起，COUPON 支援在地生活服務和在地生活服務最高成效廣告活動，可啟用優待券待開發客戶類型。

campaign 欄位會將待開發客戶記錄連結回相關聯的廣告活動。除了選取歸因 campaign 欄位 (例如 campaign.id 和 campaign.name) 之外，您也可以依廣告活動資源名稱 (WHERE local_services_lead.campaign = ...) 或廣告管道類型 (WHERE campaign.advertising_channel_type = ...) 篩選待開發客戶查詢，依廣告活動類型區隔待開發客戶。

您可以從 local_services_lead 資源擷取在地生活服務待開發客戶資料。以下是查詢範例：

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time,
  local_services_lead.campaign
FROM local_services_lead

限制

如果 lead_status 等於 WIPED_OUT，contact_details 欄位會是空值。
自 v25起，ContactDetails.email 已移除，ContactDetails.phone_number_extension 則可在 local_services_lead.contact_details 傳回的 ContactDetails 訊息中使用。
如果category_id屬於醫療照護類別，則無法取得該待開發客戶的資料。

在地生活服務待開發客戶對話

LocalServicesLeadConversation 會公開 LocalServicesLead 期間發生的對話詳細資料。與 LocalServicesLead 是一對多關係，一個待開發客戶可以有多個對話。相關待開發客戶的資源名稱可在 lead 欄位中找到。

您可以從 local_services_lead_conversation 資源擷取對話資料。以下範例查詢會篩選出通話結果：

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

您可以使用 LocalServicesLeadService.AppendLeadConversation 方法，將 LocalServicesLeadConversation 資源附加至 LocalServicesLead。

限制

如要存取通話錄音網址，您必須使用具備 Google Ads 客戶帳戶唯讀存取權的電子郵件地址登入，且該帳戶必須擁有與待開發客戶相關聯的廣告活動。

一次要求所有對話可能需要較長時間，因此建議您依待開發客戶篩選對話，例如：

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

驗證構件

LocalServicesVerificationArtifact 會公開廣告主商家的驗證資料。請注意，這些驗證僅限於商家層級，不包括員工驗證。包括：

執照驗證
保險驗證
背景調查驗證
商家登記驗證

每當向在地生活服務廣告提交驗證要求時，Google Ads API 都會為該要求建立新的驗證構件例項，每個驗證構件代表一項驗證要求。每個驗證構件可能包含下列部分資訊，具體取決於其代表的驗證要求類型：

各項驗證成果的狀態
用於背景調查驗證的背景調查網址
背景調查裁決時間 (如適用)
保險文件網址，用於查看已提交的保險資訊
保險拒絕原因 (如適用)
執照詳細資料 (類型、號碼、名字、姓氏)
授權拒絕原因 (如適用)
授權文件網址，用於查看已提交的授權圖片 (如適用)
商業登記詳細資料 (檢查 ID、登記號碼)
商家登記遭拒原因 (如適用)
商業登記文件網址，用於查看已提交的登記圖片 (如適用)

您可以從 local_services_verification_artifact 資源擷取驗證構件資料。以下範例查詢會擷取特定客戶帳戶中，所有與授權相關的驗證構件資料：

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_override_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

地理和類別驗證資料

如要以程式輔助方式，依地理位置 (具體來說是指定地理區域代碼) 和在地生活服務類別 ID 判斷驗證要求的狀態，您可以使用 customer 資源上的 local_services_settings 欄位，其類型為 LocalServicesSettings。

這個欄位會依地點和類別，顯示執照和保險驗證要求的狀態摘要。以下是擷取所有這類資料的查詢範例：

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

在地生活服務員工

LocalServicesEmployee 會公開廣告主上傳到我們系統的廣告資料，其中包含當地服務員工的資料。

以下範例查詢會擷取特定客戶帳戶中，所有在地生活服務員工的資料：

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee

在地生活服務最高成效廣告活動

最高成效廣告活動自 v24起支援在地生活服務相關設定。您可以使用這些設定，設定及識別放送在地生活服務廣告的最高成效廣告活動 (GLS PMax)。

建立在地生活服務最高成效廣告活動

自 v26起，Google Ads API 支援建立和更新在地生活服務最高成效廣告活動。如要透過 API 建立新的在地生活服務最高成效廣告活動，請建立最高成效廣告活動 (advertising_channel_type = 'PERFORMANCE_MAX')，並在 pmax_campaign_settings 上設定 local_services_enabled = true (建立後即無法變更)。建立在地生活服務最高成效廣告活動時，local_services_pmax_campaign_settings 中必須同時包含 country_code 和 listing_id。在 v24 和 v25 中，API 僅支援更新現有的在地生活服務最高成效廣告活動，這些廣告活動是由許可清單中的帳戶在 UI 中建立。如需設定必要條件和自動建立廣告活動的端對端操作說明，請參閱最高成效廣告活動「每位待開發客戶付費」目標指南。

找出在地生活服務最高成效廣告活動

如要確認最高成效廣告活動是否為在地生活服務廣告活動，請查看廣告活動 pmax_campaign_settings 的 local_services_enabled 欄位。這個欄位是不可變更 (CREATE ONLY) 的布林值，在建立廣告活動時設為 true。

調整設定

如果廣告活動的 local_services_enabled 為 true，請在 local_services_pmax_campaign_settings 欄位下方進行設定：

listing_id：與廣告活動連結的 Google 商家檔案商家資訊 ID。自 v26起，建立在地生活服務最高成效廣告活動時，這個欄位為必填且不可變更。商家資訊 ID 必須連結至帳戶，做為已啟用的 LOCATION 素材資源，否則 API 會傳回 CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID 錯誤。由於 listing_id 標示為 IMMUTABLE，因此在廣告活動建立後嘗試更新這個欄位，會失敗並傳回 RequestError.IMMUTABLE_FIELD。開發人員可以查詢 Asset 資源，找出已啟用的 LOCATION 素材資源 (檢查 location_asset.business_profile_locations)，藉此探索或驗證連結的商家資訊 ID。詳情請參閱「地點素材資源」。
navigational_query_leads_enabled：是否要使用導覽查詢篩選器。
founding_year：商家創立年份。
country_code：在地生活服務廣告的國家/地區代碼。自 v26起，這個欄位為必填且不可變更，在建立廣告活動時設定一次。這項屬性是由兩個大寫字母組成的國家/地區代碼 (目前在地生活服務最高成效廣告活動僅支援 US)，用於判斷驗證規定，以及驗證所選地區條件。
phone_numbers：與供應商相關聯的電話號碼清單，以 LocalServicesPhoneNumber 訊息表示。如果省略，來電號碼會預設為連結的 Google 商家檔案資訊中的電話號碼。如果商家檔案資訊沒有電話號碼，則必須提供。

電話號碼

phone_numbers 重複欄位中的每個項目都使用 LocalServicesPhoneNumber 訊息類型，並包含下列欄位：

phone_number：電話號碼。
country_code：大寫的雙字母國家/地區代碼。
phone_number_type：電話號碼類型，由 GlsPhoneNumberTypeEnum.GlsPhoneNumberType 定義。支援的類型包括：
- DESTINATION_PHONE_NUMBER_FOR_ADS：用於在地生活服務廣告單元來電的到達網頁號碼 (預設為來電待開發客戶)。
- DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY：支援簡訊的目的地號碼 (選用，用於訊息待開發客戶簡訊通知)。
- DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY：供應商 WhatsApp 帳戶的目的地號碼。

在地生活服務廣告活動 透過集合功能整理內容 你可以依據偏好儲存及分類內容。