- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- BusinessCallsInsights
- MetricType
- AggregateMetrics:
- HourlyMetrics (Stündliche Messwerte)
- WeekDayMetrics
- DayOfWeek
- Datum
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 |
Erforderlich. Der übergeordnete Standort, für den Anrufstatistiken abgerufen werden sollen. Format: locations/{locationId} |
Abfrageparameter
Parameter | |
---|---|
pageSize |
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 |
Optional. Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
filter |
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 ( |
Felder | |
---|---|
businessCallsInsights[] |
Eine Sammlung von Statistiken zu Unternehmensanrufen für den Standort |
nextPageToken |
Ein Token, das als |
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 ( |
Felder | |
---|---|
name |
Erforderlich. Der Ressourcenname der Anrufstatistiken. Format: locations/{location}/businesscallsinsights |
metricType |
Der Messwert, für den der Wert gilt. |
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 ( |
Felder | |
---|---|
missedCallsCount |
Gesamtzahl der verpassten Anrufe. |
answeredCallsCount |
Gesamtzahl der angenommenen Anrufe. |
hourlyMetrics[] |
Eine Liste der Messwerte nach Tageszeit. |
weekdayMetrics[] |
Eine Liste der Messwerte nach Wochentag. |
startDate |
Datum für diesen Messwert. Wenn der Messwert monatlich ist, werden nur Jahr und Monat verwendet. |
endDate |
Enddatum für diesen Messwert. |
HourlyMetrics
Messwerte für eine Stunde.
JSON-Darstellung |
---|
{ "hour": integer, "missedCallsCount": integer } |
Felder | |
---|---|
hour |
Tageszeit. Zulässige Werte sind 0–23. |
missedCallsCount |
Gesamtzahl der verpassten Anrufe für diese Stunde. |
WeekDayMetrics
Messwerte für einen Wochentag
JSON-Darstellung |
---|
{
"day": enum ( |
Felder | |
---|---|
day |
Wochentag. Zulässige Werte sind Sonntag bis Samstag. |
missedCallsCount |
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 |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
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. |