Method: accounts.locations.reportInsights

1 つ以上の指標に関するビジネスごとの分析情報を含むレポートを返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

アカウントのリソース名。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
フィールド
locationNames[]

string

インサイトを取得するビジネスのコレクションで、名前で指定します。

basicRequest

object (BasicMetricsRequest)

基本的な指標の分析情報をレポートに含めるためのリクエスト。

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

運転ルート リクエストに関する分析情報をレポートに含めるためのリクエスト。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

Insights.ReportLocationInsights に対するレスポンス メッセージです。

JSON 表現
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
フィールド
locationMetrics[]

object (LocationMetrics)

ロケーション別の指標値のコレクション。

locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

運転ルート関連の指標の値のコレクション。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。

DrivingDirectionMetricsRequest

運転ルートの分析情報のリクエストです。

JSON 表現
{
  "numDays": enum (NumDays),
  "languageCode": string
}
フィールド
numDays

enum (NumDays)

データを集計する日数。返された結果は、直近にリクエストした日数分のデータです。有効な値は 7、30、90 です。

languageCode

string

言語の BCP 47 コード。言語コードが指定されていない場合、デフォルトで英語に設定されます。

NumDays

このリクエストに対応できる日数。

列挙型
SEVEN 7 日間。これがデフォルト値です。
THIRTY 30 日間
NINETY 90 日間。

LocationMetrics

一定期間にビジネスに関連付けられた一連の Metrics と BreakdownMetrics。

JSON 表現
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
フィールド
locationName

string

これらの値が属するビジネスのリソース名。

timeZone

string

ビジネスの IANA タイムゾーン。

metricValues[]

object (MetricValue)

リクエストされた指標の値のリスト。

LocationDrivingDirectionMetrics

ユーザーが普段訪れる地域ごとにインデックスに登録されたビジネスです。これは、各地域からこのビジネスへの運転ルートのリクエスト数をカウントすることで取得されます。

JSON 表現
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
フィールド
locationName

string

この指標値が属するビジネス リソース名。

topDirectionSources[]

object (TopDirectionSources)

ソース地域ごとの運転ルート リクエスト。慣例により、これらは件数で並べ替えられ、最大 10 件の結果が表示されます。

timeZone

string

ビジネスのタイムゾーン(「Europe/London」などの IANA タイムゾーン ID)です。

TopDirectionSources

運転ルートのリクエスト元となった上位の地域。

JSON 表現
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
フィールド
dayCount

integer

データを集計する日数。

regionCounts[]

object (RegionCount)

件数の降順で並べ替えられた地域。

RegionCount

リクエスト数が関連付けられているリージョン。

JSON 表現
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
フィールド
latlng

object (LatLng)

地域の中心。

label

string

人が読める形式のリージョンのラベル。

count

string (int64 format)

この地域からの運転ルート リクエストの数。