Method: locations.searchkeywords.impressions.monthly.list

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

string

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

object (MonthlyRange)

Erforderlich. Der Bereich in Monaten, in dem die Impressionen der Keywords für Suchanzeigen zusammengefasst werden.
pageSize

integer

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

string (bytes format)

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 (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Felder
searchKeywordsCounts[]

object (SearchKeywordCount)

Suchbegriffe, mit denen nach einem Unternehmen gesucht wurde.
nextPageToken

string (bytes format)

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 (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Felder
startMonth

object (Date)

Erforderlich. Inklusiv – nur die Felder für Jahr und Monate werden berücksichtigt
endMonth

object (Date)

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 (InsightsValue)
  }
}
Felder
searchKeyword

string

Der String in Kleinbuchstaben, den der Nutzer eingegeben hat.
insightsValue

object (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 InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
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

string (int64 format)

Stellt den tatsächlichen Wert dar.
threshold

string (int64 format)

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