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

Thông số
name

string

Tên tài nguyên 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)
  }
}
Trường
locationNames[]

string

Một tập hợp các vị trí để tìm nạp thông tin chi tiết, được chỉ định theo tên của các vị trí đó.
basicRequest

object (BasicMetricsRequest)

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

object (DrivingDirectionMetricsRequest)

Yêu cầu đưa thông tin chi tiết về các 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:

Thông báo phản hồi cho Insights.ReportLocationInsights.

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

object (LocationMetrics)

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

object (LocationDrivingDirectionMetrics)

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

Phạm vi cấp phép

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 bài viết Tổng quan về OAuth 2.0.

DrivingDirectionMetricsRequest

Yêu cầu thông tin chi tiết về đường đi lái xe.

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

enum (NumDays)

Số ngày để tổng hợp dữ liệu. Kết quả trả về sẽ là dữ liệu có sẵn trong số ngày được yêu cầu gần đây 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. Đây là giá trị mặc định.
THIRTY 30 ngày.
NINETY 90 ngày.

LocationMetrics

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

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

string

Tên của tài nguyên vị trí chứa các giá trị này.
timeZone

string

Múi giờ IANA của vị trí.
metricValues[]

object (MetricValue)

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

LocationDrivingDirectionMetrics

Một vị trí được lập chỉ mục theo các khu vực mà mọi người thường đến. Thông tin này được thu thập bằng cách đếm số lượng yêu cầu chỉ đường đến vị trí này từ mỗi khu vực.

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

string

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

object (TopDirectionSources)

Số 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à có 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 yêu cầu chỉ đường lái xe.

Biểu diễn dưới dạng JSON 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
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 thứ tự giảm dần theo số lượng.

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
}
Trường
latlng

object (LatLng)

Trung tâm của vùng.
label

string

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

string (int64 format)

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