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 的 ad_schedule。CampaignCriterion

設定指定地區

如要為在地生活服務廣告活動啟用指定地區，請新增 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 廣告活動。每個客戶帳戶只能有一個在地生活服務廣告活動，因此這些資源不會指定廣告活動。如要找出這些資源所屬的廣告活動，請使用下列查詢：

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

在地生活服務待開發客戶

LocalServicesLead 會公開待開發客戶的詳細資料，這些資料是在消費者致電、傳送訊息給廣告主，或向廣告主預訂服務時產生。

您可以從 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
FROM local_services_lead

限制

如果 lead_status 等於 WIPED_OUT，contact_details 欄位會是空值。
自 v25起，系統會移除 ContactDetails.email，並在 local_services_lead.contact_details 傳回的 ContactDetails 訊息中提供 ContactDetails.phone_number_extension。
如果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_verification_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起支援與在地服務相關的設定。您可以透過這些設定，設定及識別放送 Google 商家檔案廣告的最高成效廣告活動 (Google 商家檔案最高成效廣告)。

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

自 v26起，您可以透過 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 欄位。

調整設定

如果廣告活動的 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。開發人員可以查詢已啟用 LOCATION 資源的 Asset 資源 (檢查 location_asset.business_profile_locations)，找出或驗證已連結的房源 ID。詳情請參閱地點素材資源。
navigational_query_leads_enabled：是否要使用導覽查詢篩選器。
founding_year：商家創立年份。
country_code：在地生活服務廣告的國家/地區代碼。這個欄位無法變更，且只能在建立廣告時設定一次。這是大寫的雙字母國家/地區代碼，用於判斷驗證規定，以及驗證地點條件選取項目。
phone_numbers：與供應商相關聯的電話號碼清單，以 LocalServicesPhoneNumber 訊息表示。

電話號碼

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 帳戶的目的地號碼。