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

Tham 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 vị trí).
basicRequest

object (BasicMetricsRequest)

Yêu cầu cung cấp thông tin chi tiết cơ bản về chỉ số trong báo cáo.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Yêu cầu thêm 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:

Tin nhắn 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ị của chỉ số theo vị trí.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Tập hợp 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 cung cấp thông tin chi tiết về chỉ đường 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ả được trả về sẽ có sẵn dữ liệu trong số ngày 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ã sẽ là tiếng Anh theo mặc định.

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 các Chỉ số và MetricsMetrics liên quan đến Vị trí trong một phạm vi thời gian nào đó.

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 cho vị trí này.
metricValues[]

object (MetricValue)

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

LocationDrivingDirectionMetrics

Một vị trí được lập chỉ mục cùng với những khu vực nơi mọi người thường đến. Con số này được thu thập bằng cách đếm số yêu cầu chỉ đường lái xe đế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í chứa giá trị chỉ số này.
topDirectionSources[]

object (TopDirectionSources)

Các yêu cầu về hướ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 các yêu cầu về hướ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 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 lái xe từ khu vực này.