Method: locations.businesscallsinsights.list

Gibt Statistiken zu Anrufen eines Unternehmens zurück, die zu einem Standort geführt haben.

HTTP-Anfrage

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der übergeordnete Standort, für den Anrufstatistiken abgerufen werden sollen. Format: locations/{locationId}

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von BusinessCallsInsights, die zurückgegeben werden sollen. Wenn keine Angabe gemacht wird, werden höchstens 20 zurückgegeben. Einige Messwerttypen(z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten wird der Parameter „pageSize“ ignoriert.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen businesscallsinsights.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für businesscallsinsights.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Einige Messwerttypen (z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten wird das pake_token ignoriert.
filter

string

Optional. Ein Filter, der die zurückzugebenden Statistiken zu Aufrufen einschränkt. Die Antwort enthält nur Einträge, die dem Filter entsprechen.

Wenn MetricType nicht angegeben ist, wird AGGREGATE_COUNT zurückgegeben. Wenn kein endDate angegeben wird, wird das letzte Datum verwendet, für das Daten verfügbar sind. Wenn kein „startDate“ angegeben ist, wird standardmäßig das erste Datum verwendet, für das Daten verfügbar sind, derzeit also 6 Monate. Wenn „startDate“ vor dem Datum liegt, an dem Daten verfügbar sind, werden die Daten ab dem Datum zurückgegeben, an dem sie verfügbar sind.

Derzeit werden folgende Filter unterstützt. 1. startDate="DATE" wobei das Datum das Format JJJJ-MM-TT hat. 2. endDate="DATE" wobei das Datum das Format JJJJ-MM-TT hat. 3. metricType=XYZ, wobei XYZ ein gültiger MetricType ist 4. Konjunktionen(AND) der oben genannten Optionen. z.B. „startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT“ Der AGGREGATE_COUNT metricType ignoriert den DD-Teil des Datums.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für businesscallsinsights.list.

JSON-Darstellung 
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
Felder
businessCallsInsights[]

object (BusinessCallsInsights)

Eine Sammlung von Anrufstatistiken für den Standort.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten. Einige Messwerttypen (z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten ist das nextPageToken leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BusinessCallsInsights

Statistiken zu Anrufen an einem Standort.

JSON-Darstellung 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
Felder
name

string

Erforderlich. Der Ressourcenname der Anrufstatistiken. Format: locations/{location}/businesscallsinsights
metricType

enum (MetricType)

Der Messwert, für den der Wert gilt.
aggregateMetrics

object (AggregateMetrics)

Messwert für den auf „startDate“ und „endDate“ basierenden Zeitraum.

MetricType

Der Messwerttyp.

Enums
METRIC_TYPE_UNSPECIFIED Der Messwerttyp ist nicht angegeben.
AGGREGATE_COUNT Bei den angegebenen Messwerten handelt es sich um Zählwerte, die über den Eingabezeitraum aggregiert wurden.

AggregateMetrics

Über den Eingabezeitraum aggregierte Messwerte.

JSON-Darstellung 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Felder
missedCallsCount

integer

Gesamtzahl der verpassten Anrufe.
answeredCallsCount

integer

Gesamtzahl der angenommenen Anrufe.
hourlyMetrics[]

object (HourlyMetrics)

Eine Liste der Messwerte nach Tageszeit.
weekdayMetrics[]

object (WeekDayMetrics)

Eine Liste der Messwerte nach Wochentag.
startDate

object (Date)

Datum für diesen Messwert. Wenn der Messwert monatlich ist, werden nur Jahr und Monat verwendet.
endDate

object (Date)

Enddatum für diesen Messwert.

HourlyMetrics

Messwerte für eine Stunde.

JSON-Darstellung 
{
  "hour": integer,
  "missedCallsCount": integer
}
Felder
hour

integer

Tageszeit. Zulässige Werte sind 0–23.
missedCallsCount

integer

Gesamtzahl der verpassten Anrufe für diese Stunde.

WeekDayMetrics

Messwerte für einen Wochentag.

JSON-Darstellung 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
Felder
day

enum (DayOfWeek)

Wochentag Zulässige Werte sind Sonntag bis Samstag.
missedCallsCount

integer

Gesamtzahl der verpassten Anrufe für diese Stunde.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null
  • Ein Monat und ein Tag mit einem Jahr ohne Jahr (z.B. ein Jahrestag)
  • Ein Jahr für sich alleine, mit einem Monat von null und einem Tag ohne Tage
  • Ein Jahr und ein Monat mit 0 Tag (z.B. ein Ablaufdatum einer Kreditkarte)

Ähnliche Typen: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben.
month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.
day

integer

Tag im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn der Tag nicht von Bedeutung ist.