- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
- DrivingDirectionMetricsRequest
- NumDays
- LocationMetrics
- LocationDrivingDirectionMetrics
- TopDirectionSources
- RegionCount (Số vùng)
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 |
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 ( |
Các trường | |
---|---|
locationNames[] |
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 |
Yêu cầu đưa thông tin chi tiết về chỉ số cơ bản vào báo cáo. |
drivingDirectionsRequest |
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 ( |
Các trường | |
---|---|
locationMetrics[] |
Tập hợp các giá trị chỉ số theo vị trí. |
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 ( |
Các trường | |
---|---|
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 |
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 ( |
Các trường | |
---|---|
locationName |
Tên tài nguyên vị trí chứa những giá trị này. |
timeZone |
Múi giờ IANA cho vị trí. |
metricValues[] |
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 ( |
Các trường | |
---|---|
locationName |
Tên tài nguyên vị trí chứa giá trị chỉ số này. |
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 |
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 ( |
Các trường | |
---|---|
dayCount |
Dữ liệu số ngày được tổng hợp. |
regionCounts[] |
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 ( |
Các trường | |
---|---|
latlng |
Trung tâm khu vực. |
label |
Nhãn khu vực mà con người có thể đọc được. |
count |
Số yêu cầu chỉ đường từ khu vực này. |