Method: locations.businesscallsinsights.list

Gibt Statistiken zu geschäftlichen Anrufen für einen Standort zurück

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 Vorgabe erfolgt, werden höchstens 20 zurückgegeben. Einige „metric_types“ (z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten wird „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 „metric_types“ (z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten wird „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 kein MetricType angegeben ist, wird AGGREGATE_COUNT zurückgegeben. Wenn kein Enddatum angegeben ist, wird das letzte Datum verwendet, für das Daten verfügbar sind. Wird kein startDate angegeben, wird standardmäßig das erste Datum verwendet, für das Daten verfügbar sind. Dies sind derzeit sechs Monate. Wenn das 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 im Format JJJJ-MM-TT angegeben wird. 2. endDate="DATE", wobei das Datum im Format JJJJ-MM-TT angegeben wird. 3. "metricType=XYZ", wobei XYZ für einen gültigen Messwerttyp steht. 4. Konjunktionen(AND) der oben genannten Punkte, z. B. "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" Der Messwert "AGGREGATE_COUNT" ignoriert den TT-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 Statistiken zu Unternehmensanrufen 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 „metric_types“ (z. B. AGGREGATE_COUNT) geben eine einzelne Seite zurück. Bei diesen Messwerten ist das Feld „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 Zeitraum basierend auf „startDate“ und „endDate“.

MetricType

Der Typ des Messwerts.

Enums
METRIC_TYPE_UNSPECIFIED Der Typ des Messwerts ist nicht angegeben.
AGGREGATE_COUNT Die angegebenen Messwerte sind Zählungen, die über den Eingabezeitraum (time_range) 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 bedeuten:

  • Vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null
  • Monat und Tag mit einem Jahr 00 (z.B. ein Jahrestag)
  • Ein Jahr für sich, mit einem Monat 0 und einem Tag 0
  • Ein Jahr und ein Monat mit einem Tag null (z.B. das Ablaufdatum einer Kreditkarte)

Verwandte Typen: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

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

integer

Jahr des Datums. Der Wert 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 eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist.