報表

您可以使用報表功能，擷取已連結帳戶的廣告成效和待開發客戶資訊。

帳戶報表

帳戶報表會顯示與管理員帳戶連結的在地服務帳戶相關聯的成效和指標。您可以查看特定時間範圍內的資料。資料最多可能會有 30 分鐘的延遲。

如要取得報表，請將 HTTP GET 要求傳送至 https://localservices.googleapis.com/v1/accountReports:search，並提供下列可設定的網址參數：

網址參數
query	必要 包含一或多個 ID 值，其中一個必須是查詢的管理員帳戶 ID。query 可接受多個以半形分號分隔的值： 必要條件： manager_customer_id:<manager_cid> 自由參加：customer_id:<linked_cid> 示例： query=manager_customer_id:123;customer_id:456
startDate.day	選用 報表統計期的開始日期 (以當月第幾天表示)。可接受介於 1 和 31 之間的值 (含)。預設值為 1。
startDate.month	選用 報表統計期的開始月份。可接受介於 1 和 12 之間的值 (含這兩個值)。預設為當月。
startDate.year	選用 報表統計期的開始年份，格式為 YYYY。預設為今年。
endDate.day	選用 報表統計期結束的日期 (以當月天數為準)。可接受介於 1 和 31 之間的值 (含)。預設為當天。
endDate.month	選用 這是指報表統計期的結束月份。可接受介於 1 和 12 之間的值 (含這兩個值)。預設為當月。
endDate.year	選用 報告期結束的年份，格式為 YYYY。 預設為今年。
pageSize	選用 正整數，表示要傳回的項目數。 預設值為 1000，上限為 10000。
pageToken	選用 字串。在這個欄位中輸入先前回應的 next_page_token。

上表中的欄位用於建構 SearchAccountReportsRequest。要求中的每個客戶 ID，都會在 SearchAccountReportsResponse 中包含對應的 AccountReports。 每個帳戶報表都會一對一對應至顯示區域服務廣告的已連結客戶帳戶。

注意： 要求、回應和資料結構的 Proto 會在發布後提供並連結。

下表顯示 AccountReports 中的欄位：

欄位
accountId	已連結至在地生活服務帳戶的客戶 ID。
businessName	客戶的商家名稱。
averageWeeklyBudget	顧客目前的平均每週預算。
averageFiveStarRating	平均五星評分，這是根據所有可用的消費者評論計算得出。
totalReview	可供消費者查看的評論總數。
impressionsLastTwoDays	帳戶在過去兩天內的曝光總數。
phoneLeadResponsiveness	帳戶在過去 90 天內對電話待開發客戶的回應速度。 計算方式為：將付費電話開發客戶帶來的通話總數，除以接聽的通話總數。
currentPeriodChargedLeads	指定日期範圍內可計費的待開發客戶數量。
previousPeriodChargedLeads	上個週期的付費待開發客戶數量。舉例來說，如果日期範圍設為 1 月 21 日至 1 月 30 日，則上一個期間為 1 月 11 日至 1 月 20 日。
currentPeriodTotalCost	指定日期範圍內，已收費待開發客戶的費用總和。
previousPeriodTotalCost	上個週期中，已收費待開發客戶的費用總和。舉例來說，如果日期範圍設為 1 月 21 日至 1 月 30 日，則上一個期間為 1 月 11 日至 1 月 20 日。
currencyCode	客戶帳戶的貨幣代碼。
currentPeriodPhoneCalls	指定日期範圍內的電話通話次數，包括已接通和未接通的電話。
previousPeriodPhoneCalls	上個週期的電話通話次數，包括已接通和未接通的通話。
currentPeriodConnectedPhoneCalls	指定日期範圍內通話時間超過 30 秒的通話次數。
previousPeriodConnectedPhoneCalls	上個期間內，通話時間超過 30 秒的已接聽電話通話次數。

範例

HTTP 要求網址

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

完整的 HTTP 要求範例

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

詳細待開發客戶報表

重要事項： 詳細待開發客戶報表已淘汰。使用 Google Ads API 擷取與在地生活服務帳戶相關聯的待開發客戶和對話。

詳細的待開發客戶報表會深入顯示與管理員帳戶已連結在地生活服務帳戶相關聯的待開發客戶。您可以查看特定時間範圍內的資料。在指定時間範圍內，這份報表會列出已建立的待開發客戶，或是爭議狀態已更新的待開發客戶。資料最多可能延遲 30 分鐘。

注意： API 用戶只能要求最多 31 天的詳細待開發客戶報表。這是因為報表可能會傳回大量待開發客戶。

如要取得報表，請將 HTTP GET 要求傳送至 https://localservices.googleapis.com/v1/detailedLeadReports:search，並提供下列可設定的網址參數：

網址參數
query	必要 包含一或多個 ID 值，其中一個必須是查詢的管理員帳戶 ID。query 可接受多個以半形分號分隔的值： 必要條件： manager_customer_id:<manager_cid> 自由參加：customer_id:<linked_cid> 示例： query=manager_customer_id:123;customer_id:456
startDate.day	選用 報表統計期的開始日期 (以當月第幾天表示)。可接受介於 1 和 31 之間的值 (含)。預設值為 1。
startDate.month	選用 報表統計期的開始月份。可接受介於 1 和 12 之間的值 (含這兩個值)。預設為當月。
startDate.year	選用 報表統計期的開始年份，格式為 YYYY。預設為今年。
endDate.day	選用 報表統計期結束的日期 (以當月天數為準)。可接受介於 1 和 31 之間的值 (含)。預設為當天。
endDate.month	選用 這是指報表統計期的結束月份。可接受介於 1 和 12 之間的值 (含這兩個值)。預設為當月。
endDate.year	選用 報告期結束的年份，格式為 YYYY。 預設為今年。
pageSize	選用 正整數，表示要傳回的項目數。 預設值為 1000，上限為 10000。
pageToken	選用 字串。在這個欄位中輸入先前回應的 next_page_token。

先前的欄位是用來建構 SearchDetailedLeadReportsRequest。要求中的每個客戶 ID，SearchDetailedLeadReportsResponse 都會包含對應的 DetailedLeadReports。每份詳細待開發客戶報表都會與特定待開發客戶一一對應，這些待開發客戶與顯示在地生活服務廣告的已連結客戶帳戶相關聯。

下表顯示 DetailedLeadReports 中的欄位：

欄位
leadId	待開發客戶的專屬 ID。
accountId	識別收到待開發客戶的帳戶。
businessName	與帳戶相關聯的商家名稱。
leadCreationTimestamp	建立待開發客戶的時間戳記。包含 M/D/YYYY 格式的日期和 HH:MM:SS 格式的時間。 範例：11/1/2019 12:13:20
leadType	待開發客戶類型：MESSAGE 或 PHONE_CALL。
leadCategory	與待開發客戶相關聯的服務類別。 範例：housecleaner
geo	相關帳戶住家所在城市的位置。 範例：San Francisco, California, United States
messageLead	僅與訊息待開發客戶相關聯的資訊： customerName、jobType、 postalCode 和 consumerPhoneNumber。
phoneLead	僅與電話開發客戶相關聯的資訊：chargedCallTimestamp、chargedConnectedCallDurationSeconds 和 consumerPhoneNumber。
bookingLead	僅與預訂待開發客戶相關聯的資訊： customerName、 consumerPhoneNumber、 jobType、 consumerEmail 和 bookingAppointmentTimestamp。
chargeStatus	系統是否已收取待開發客戶費用。可以是 true 或 false。
currencyCode	建立待開發客戶的帳戶貨幣代碼。
disputeStatus	待開發客戶的爭議狀態。
aggregatorInfo	第三方匯總合作夥伴專屬資訊。這個欄位只會填入與第三方匯總合作夥伴相關聯的 API 用戶端。 注意：這不適用於標準我的客戶中心 (MCC) 客戶。
timezone	與待開發客戶相關聯的帳戶時區。採用 IANA 時區資料庫格式。

範例

HTTP 要求網址

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

完整的 HTTP 要求範例

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]