Package google.mybusiness.performance.v1

Index

PerformanceService

Mit diesem Dienst können Händler Leistungsberichte zu ihrem Unternehmensprofil bei Google abrufen.

Die API versucht, die Richtlinien auf aip.dev einzuhalten.

FetchMultiDailyMetricsTimeSeries

rpc FetchMultiDailyMetricsTimeSeries(FetchMultiDailyMetricsTimeSeriesRequest) returns (FetchMultiDailyMetricsTimeSeriesResponse)

Gibt die Werte für jedes Datum aus einem bestimmten Zeitraum und optional den untergeordneten Entitätstyp zurück, sofern zutreffend, die den jeweiligen täglichen Messwerten zugeordnet sind.

Beispielanfrage: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.
GetDailyMetricsTimeSeries

rpc GetDailyMetricsTimeSeries(GetDailyMetricsTimeSeriesRequest) returns (GetDailyMetricsTimeSeriesResponse)

Gibt die Werte für jedes Datum aus einem bestimmten Zeitraum zurück, die dem jeweiligen täglichen Messwert zugeordnet sind.

Beispielanfrage: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.
ListSearchKeywordImpressionsMonthly

rpc ListSearchKeywordImpressionsMonthly(ListSearchKeywordImpressionsMonthlyRequest) returns (ListSearchKeywordImpressionsMonthlyResponse)

Gibt die Suchbegriffe zurück, die verwendet wurden, um ein Unternehmen in der Suche oder in Maps zu finden. Jedem Keyword für Suchanzeigen sind Impressionen zugeordnet, die monatlich aggregiert werden.

Beispielanfrage: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.

DailyMetric

Stellt alle verfügbaren täglichen Messwerte für ein Unternehmen dar.

Enums
DAILY_METRIC_UNKNOWN Stellt den Standardwert für „Unbekannt“ dar.
BUSINESS_IMPRESSIONS_DESKTOP_MAPS Anzahl der Impressionen Ihres Unternehmens auf Google Maps auf Desktop-Geräten. Mehrere Impressionen durch einen einzelnen Nutzer an einem Tag werden als eine Impression gezählt.
BUSINESS_IMPRESSIONS_MOBILE_MAPS Impressionen von Unternehmen auf Google Maps auf Mobilgeräten. Mehrere Impressionen durch einen einzelnen Nutzer an einem Tag werden als eine Impression gezählt.
BUSINESS_CONVERSATIONS

Die Anzahl der Nachrichtenunterhaltungen, die im Unternehmensprofil eingegangen sind.
BUSINESS_DIRECTION_REQUESTS Wie oft ein Abruf der Wegbeschreibung zum Unternehmensstandort angefordert wurde.
CALL_CLICKS Gibt an, wie oft auf die Anrufschaltfläche im Unternehmensprofil geklickt wurde.
WEBSITE_CLICKS Gibt an, wie oft auf die Website im Unternehmensprofil geklickt wurde.
BUSINESS_BOOKINGS Die Anzahl der Buchungen, die über das Unternehmensprofil über „Mit Google reservieren“ vorgenommen wurden.
BUSINESS_FOOD_ORDERS

Die Anzahl der Essensbestellungen, die über das Unternehmensprofil eingegangen sind.
BUSINESS_FOOD_MENU_CLICKS Die Anzahl der Klicks, die erforderlich sind, um die Inhalte der Speisekarte im Unternehmensprofil aufzurufen oder damit zu interagieren. Mehrere Klicks durch einen einzelnen Nutzer an einem Tag werden als 1 gezählt.

DailyMetricTimeSeries

Stellt einen einzelnen Datenpunkt dar, wobei jeder Datenpunkt ein Tupel aus „DailyMetric“, „DailySubEntityType“ und „TimeSeries“ ist.

Felder
daily_metric

DailyMetric

Der DailyMetric, den die TimeSeries darstellt.
daily_sub_entity_type

DailySubEntityType

Der DailySubEntityType, den die Zeitreihe darstellt. Ist nicht vorhanden, wenn keine Aufschlüsselung existiert.
time_series

TimeSeries

Liste von Datenpunkten, wobei jeder Datenpunkt ein Datums-Wert-Paar ist.

DailyRange

Zeitraum, der einen Zeitraum angibt (beide inklusive).

Felder
start_date

Date

Erforderlich. Inklusiv
end_date

Date

Erforderlich. Inklusiv

DailySubEntityType

Stellt alle möglichen Unterobjekttypen dar, die mit DailyMetrics verknüpft sind.

Felder
Union-Feld Type. Gibt an, dass nur eines der folgenden Proto-Felder vorhanden sein muss. Der DailySubEntityType ist nicht für alle Messwerte verfügbar. Für Type ist nur einer der folgenden Werte zulässig:
day_of_week

DayOfWeek

Stellt den Wochentag dar. Beispiel: MONDAY. Derzeit unterstützte DailyMetrics = KEINE.
time_of_day

TimeOfDay

Stellt die Tageszeit im 24‑Stunden-Format dar. Beispiel: 13:34:20 Currently supported DailyMetrics = NONE.

DatedValue

Stellt einen einzelnen Datenpunkt in der Zeitreihe dar. Jeder Datenpunkt ist ein Datum-Wert-Paar.

Felder
date

Date

Das Datum, dem der Datenpunkt entspricht. Dies ist ein Monatswert, wenn das Feld „Tag“ nicht festgelegt ist.
value

int64

Der Wert des Datenpunkts. Dieser ist nicht vorhanden, wenn der Wert null ist.

FetchMultiDailyMetricsTimeSeriesRequest

Stellt die Anfrage für „FetchMultiDailyMetricsTimeSeries“ dar.

Felder
location

string

Erforderlich. Der Standort, für den die Zeitreihe abgerufen werden soll. Format: „locations/{location_id}“, wobei „location_id“ eine nicht verschleierte Eintrags-ID ist.
daily_metrics[]

DailyMetric

Erforderlich. Die Messwerte, für die Zeitreihen abgerufen werden sollen.
daily_range

DailyRange

Erforderlich. Der Zeitraum, für den die Zeitreihe abgerufen wird.

FetchMultiDailyMetricsTimeSeriesResponse

Stellt die Antwort für „FetchMultiDailyMetricsTimeSeries“ dar.

Felder
multi_daily_metric_time_series[]

MultiDailyMetricTimeSeries

DailyMetrics und die entsprechenden Zeitreihen.

GetDailyMetricsTimeSeriesRequest

Stellt die Anfrage für „GetDailyMetricsTimeSeries“ dar.

Felder
name

string

Erforderlich. Der Standort, für den die Zeitreihe abgerufen werden soll. Format: „locations/{location_id}“, wobei „location_id“ eine nicht verschleierte Eintrags-ID ist.
daily_metric

DailyMetric

Erforderlich. Der Messwert, für den Zeitreihen abgerufen werden sollen.
daily_range

DailyRange

Erforderlich. Der Zeitraum, für den die Zeitreihe abgerufen wird.
daily_sub_entity_type

DailySubEntityType

Optional. Der Unterentitätstyp und die ID, auf die sich die Zeitreihe bezieht. Derzeit unterstützte DailyMetrics = KEINE.

GetDailyMetricsTimeSeriesResponse

Stellt die Antwort für GetDailyMetricsTimeSeries dar.

Felder
time_series

TimeSeries

Die tägliche Zeitreihe.

InsightsValue

Stellt einen Insights-Wert dar.

Felder
Union-Feld InsightsValue. Gibt an, dass nur eines der folgenden Proto-Felder vorhanden sein muss. Für InsightsValue ist nur einer der folgenden Werte zulässig:
value

int64

Stellt den tatsächlichen Wert dar.
threshold

int64

Stellt den Grenzwert dar, unter den der tatsächliche Wert fällt.

ListSearchKeywordImpressionsMonthlyRequest

Stellt die Anfrage für „ListSearchKeywordImpressionsMonthly“ dar.

Felder
parent

string

Erforderlich. Der Standort, für den die Zeitreihe abgerufen werden soll. Format: „locations/{location_id}“, wobei „location_id“ eine nicht verschleierte Eintrags-ID ist.
monthly_range

MonthlyRange

Erforderlich. Der Zeitraum in Monaten, über den die Impressionen der Keywords für Suchanzeigen aggregiert werden sollen.
page_size

int32

Optional. Die Anzahl der angeforderten Ergebnisse. Die Standardseitengröße ist 100. Die Seitengröße kann auf maximal 100 festgelegt werden.
page_token

bytes

Optional. Ein Token, das das nächste paginierte Ergebnis angibt, das zurückgegeben werden soll.

ListSearchKeywordImpressionsMonthlyResponse

Stellt die Antwort für „ListSearchKeywordImpressionsMonthly“ dar.

Felder
search_keywords_counts[]

SearchKeywordCount

Suchbegriffe, mit denen nach einem Unternehmen gesucht wurde.
next_page_token

bytes

Ein Token, das das letzte zurückgegebene paginierte Ergebnis angibt. Dieses kann von nachfolgenden Anfragen verwendet werden, um die nächste „Seite“ mit Keywords abzurufen. Sie wird nur angezeigt, wenn weitere Ergebnisse zurückgegeben werden können.

MonthlyRange

Zeitraum, der einen Monatsbereich angibt (beide inklusive).

Felder
start_month

Date

Erforderlich. Inklusiv: Es werden nur die Felder „Jahr“ und „Monate“ berücksichtigt.
end_month

Date

Erforderlich. Inklusiv: Es werden nur die Felder „Jahr“ und „Monate“ berücksichtigt.

MultiDailyMetricTimeSeries

Stellt eine Liste von Tupeln aus DailyMetric, DailySubEntityType und TimeSeries dar.

Felder
daily_metric_time_series[]

DailyMetricTimeSeries

Liste der DailyMetric-TimeSeries-Paare.

SearchKeywordCount

Stellt ein einzelnes Such-Keyword und seinen Wert dar.

Felder
search_keyword

string

Die vom Nutzer eingegebene Zeichenfolge in Kleinbuchstaben.
insights_value

InsightsValue

Eines der folgenden: 1) Die Summe der Anzahl der einzelnen Nutzer, die das Keyword in einem Monat verwendet haben, zusammengefasst für jeden angeforderten Monat. 2. Ein Schwellenwert, der angibt, dass der tatsächliche Wert unter diesem Schwellenwert liegt.

TimeSeries

Stellt eine Zeitreihe dar.

Felder
dated_values[]

DatedValue

Liste der Datenpunkte in der Zeitreihe, wobei jeder Datenpunkt ein Datums-Wert-Paar ist.