本頁面由 Cloud Translation API 翻譯而成。

在地生活服務廣告活動

在地生活服務廣告活動可讓您在 Google 上宣傳商家，並直接從潛在顧客接收待開發客戶。本指南將歸納目前 Google Ads API 版本支援的作業和限制。

支援作業

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

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

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，並設為傳送至 Google Ads API 的 CampaignCriterion 的 ad_schedule，請使用 CampaignCriterionService.MutateCampaignCriteria。

設定指定地區

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

指定特定服務類型

如要啟用特定服務類型的指定目標功能，請新增 LocalServiceIdInfo，並將其設為服務類型。

您使用的服務 ID 應與您廣告活動的指定目標位置和類別相符。

不支援的操作

下表列出的限制在日後的 Google Ads API 版本中可能會改變。

不支援的操作
建立及移除廣告活動	Google Ads API 禁止建立新的在地生活服務廣告活動。
廣告活動中的子實體作業	Google Ads API 不支援在「在地生活服務」廣告活動中建立、修改、移除或擷取廣告群組、廣告或條件。

「在地生活服務」資源

從 Google Ads API 第 15 版開始，Google Ads API 會透過下列唯讀報表資源，直接顯示在地生活服務廣告的部分資料：

為了要讓這些資源傳回資料，提出要求的客戶帳戶中必須設有在地生活服務廣告活動。由於每個客戶帳戶只能有一個在地生活服務廣告活動，因此這些資源不會指定廣告活動。如要找出與這些資源相關聯的廣告活動，請使用以下查詢：

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
FROM local_services_lead

限制

如果 lead_status 等於 WIPED_OUT，contact_details 欄位就會為空值。
資料來自無法使用 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
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

限制

如要存取電話錄音網址，您必須使用至少與待開發客戶相關聯的 Google Ads 客戶帳戶所屬 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.id = 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 資源使用名為 LocalServicesSetting 的新欄位。

這個欄位可依地點和類別，提供執照和保險驗證要求的概略狀態摘要。以下查詢範例會擷取這類資料：

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

在地服務員工

LocalServicesEmployee 會揭露廣告主將廣告設定檔上傳至 Google 系統的在地生活服務員工相關資料。

以下查詢範例會擷取特定客戶帳戶中所有本機服務員工的資料：

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