Method: accounts.locations.reportInsights

Trả về báo cáo chứa thông tin chi tiết về một hoặc nhiều chỉ số theo vị trí.

Yêu cầu HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
name

string

Tên tài nguyên của tài khoản.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
Các trường
locationNames[]

string

Tập hợp các địa điểm để tìm nạp thông tin chi tiết, được xác định theo tên của các địa điểm đó.
basicRequest

object (BasicMetricsRequest)

Yêu cầu đưa thông tin chi tiết về chỉ số cơ bản vào báo cáo.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Yêu cầu thêm thông tin chi tiết về yêu cầu chỉ đường lái xe vào báo cáo.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Tin nhắn trả lời cho Insights.ReportLocationInsights.

Biểu diễn dưới dạng JSON 
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Các trường
locationMetrics[]

object (LocationMetrics)

Tập hợp các giá trị chỉ số theo vị trí.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Một tập hợp các giá trị cho chỉ số liên quan đến chỉ đường lái xe.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

DrivingDirectionMetricsRequest

Yêu cầu cung cấp thông tin chi tiết về hướng lái xe.

Biểu diễn dưới dạng JSON 
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Các trường
numDays

enum (NumDays)

Số ngày để tổng hợp dữ liệu. Kết quả được trả về sẽ có sẵn dữ liệu trong số ngày yêu cầu gần nhất. Các giá trị hợp lệ là 7, 30 và 90.
languageCode

string

Mã BCP 47 cho ngôn ngữ. Nếu bạn không cung cấp mã ngôn ngữ thì mã mặc định sẽ là tiếng Anh.

NumDays

Số ngày mà yêu cầu này có thể hỗ trợ.

Enum
SEVEN 7 ngày qua. Đây là giá trị mặc định.
THIRTY 30 ngày.
NINETY 90 ngày qua.

LocationMetrics

Một loạt các Chỉ số và BreakdownMetrics được liên kết với một Vị trí trong một khoảng thời gian nhất định.

Biểu diễn dưới dạng JSON 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Các trường
locationName

string

Tên tài nguyên vị trí chứa những giá trị này.
timeZone

string

Múi giờ IANA cho vị trí.
metricValues[]

object (MetricValue)

Danh sách giá trị của các chỉ số được yêu cầu.

LocationDrivingDirectionMetrics

Một vị trí được lập chỉ mục dựa trên khu vực của mọi người. Dữ liệu này được ghi lại bằng cách đếm số lượng yêu cầu chỉ đường đến vị trí này ở mỗi khu vực.

Biểu diễn dưới dạng JSON 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Các trường
locationName

string

Tên tài nguyên vị trí chứa giá trị chỉ số này.
topDirectionSources[]

object (TopDirectionSources)

Yêu cầu chỉ đường lái xe theo khu vực nguồn. Theo quy ước, các kết quả này được sắp xếp theo số lượng, với tối đa 10 kết quả.
timeZone

string

Múi giờ (Mã múi giờ IANA, ví dụ: 'Châu Âu/London') của vị trí.

TopDirectionSources

Các khu vực hàng đầu nơi bắt nguồn của yêu cầu xem hướng lái xe.

Biểu diễn dưới dạng JSON 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Các trường
dayCount

integer

Dữ liệu số ngày được tổng hợp.
regionCounts[]

object (RegionCount)

Các khu vực được sắp xếp theo số lượng giảm dần.

RegionCount

Một khu vực có số lượng yêu cầu liên quan.

Biểu diễn dưới dạng JSON 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Các trường
latlng

object (LatLng)

Trung tâm khu vực.
label

string

Nhãn khu vực mà con người có thể đọc được.
count

string (int64 format)

Số yêu cầu chỉ đường từ khu vực này.