- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MonthlyRange (Monatlicher Bereich)
- SearchKeywordCount
- InsightsValue
Gibt die Suchbegriffe zurück, mit denen ein Unternehmen in der Google-Suche oder auf Google Maps gefunden wurde. Zu jedem Such-Keyword gehören Impressionen, die monatlich zusammengefasst werden.
Beispielanfrage: GET
https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3
HTTP-Anfrage
GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Der Standort, für den die Zeitreihe abgerufen werden soll. Format: locations/{locationId}, wobei locationId eine nicht verschleierte Eintrags-ID ist. |
Abfrageparameter
Parameter | |
---|---|
monthlyRange |
Erforderlich. Der Bereich in Monaten, in dem die Impressionen der Keywords für Suchanzeigen zusammengefasst werden. |
pageSize |
Optional. Die Anzahl der angeforderten Ergebnisse. Die Standardseitengröße ist 100. Die Seitengröße kann auf maximal 100 festgelegt werden. |
pageToken |
Optional. Ein Token, das das nächste paginierte Ergebnis angibt, das zurückgegeben werden soll. Ein base64-codierter String. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Stellt die Antwort für month.list dar.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"searchKeywordsCounts": [
{
object ( |
Felder | |
---|---|
searchKeywordsCounts[] |
Suchbegriffe, mit denen nach einem Unternehmen gesucht wurde. |
nextPageToken |
Ein Token, das das letzte zurückgegebene paginierte Ergebnis angibt. Dies kann verwendet werden, indem aufeinanderfolgende Anfragen zum Abrufen der nächsten "Seite" mit Keywords ausgeführt werden. Sie ist nur vorhanden, wenn mehr Ergebnisse zurückgegeben werden sollen. Ein base64-codierter String. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/business.manage
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
MonthlyRange
Zeitraum, der einen Monatsbereich angibt (beide eingeschlossen).
JSON-Darstellung |
---|
{ "startMonth": { object ( |
Felder | |
---|---|
startMonth |
Erforderlich. Inklusiv – nur die Felder für Jahr und Monate werden berücksichtigt |
endMonth |
Erforderlich. Inklusiv – nur die Felder für Jahr und Monate werden berücksichtigt |
SearchKeywordCount
Stellt ein einzelnes Such-Keyword und dessen Wert dar.
JSON-Darstellung |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
Felder | |
---|---|
searchKeyword |
Der String in Kleinbuchstaben, den der Nutzer eingegeben hat. |
insightsValue |
Eine der folgenden Möglichkeiten: 1) Die Summe der Anzahl einzelner Nutzer, die das Keyword in einem Monat verwendet haben, zusammengefasst für jeden angeforderten Monat. 2) Ein Grenzwert, der angibt, dass der tatsächliche Wert unter dieser Schwelle liegt. |
InsightsValue
Stellt einen Statistikwert dar.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld InsightsValue . Zeigt an, dass nur eines der folgenden Proto-Felder vorhanden sein muss. Für InsightsValue ist nur einer der folgenden Werte zulässig: |
|
value |
Stellt den tatsächlichen Wert dar. |
threshold |
Der Grenzwert, unter den der tatsächliche Wert fällt. |