Aktualisieren Sie die Integration der Google Business Profile API, bevor wichtige Endpunkte deaktiviert werden. Im Zeitplan für die Einstellung finden Sie weitere Informationen und eine Anleitung, wie Sie Unterbrechungen ab April 2022 vermeiden können.

Method: locations.searchkeywords.impressions.monthly.list

Gibt die Suchbegriffe zurück, mit denen ein Unternehmen in der Suche oder auf Maps gefunden wurde. Zu jedem Keyword für Suchanzeigen werden monatlich Impressionen erfasst.

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 Zeitachsen abgerufen werden sollen. Format: locations/{locationId}, wobei locationId eine nicht verschleierte Eintrags-ID ist.

Abfrageparameter

Parameter
monthlyRange

object (MonthlyRange)

Erforderlich. Zeitraum in Monaten, für den die Impressionen für Keywords für Suchanzeigen aggregiert 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 angibt, dass das nächste paginierte Ergebnis zurückgegeben werden soll.

Ein base64-codierter String.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Die Antwort für „month.list“

JSON-Darstellung
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Felder
searchKeywordsCounts[]

object (SearchKeywordCount)

Suchbegriffe, die verwendet wurden, um ein Unternehmen zu finden.

nextPageToken

string (bytes format)

Ein Token, das das zuletzt zurückgegebene Ergebnis für die Paginierung angibt. Dies kann für erfolgreiche Anfragen verwendet werden, um die nächste Seite zu ermitteln. Er ist nur vorhanden, wenn mehr Ergebnisse zurückgegeben werden können.

Ein base64-codierter String.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0.

Monatlicher Bereich

Zeitraum, der einen Monatsbereich angibt (beide eingeschlossen).

JSON-Darstellung
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Felder
startMonth

object (Date)

Erforderlich. Inklusiv – Es werden nur die Felder für Jahr und Monat berücksichtigt.

endMonth

object (Date)

Erforderlich. Inklusiv – Es werden nur die Felder für Jahr und Monat berücksichtigt.

Anzahl der Keywords für Suchanzeigen

Ein einzelnes Keyword für die Suche und sein Wert

JSON-Darstellung
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Felder
searchKeyword

string

Der kleingeschriebene String, den der Nutzer eingegeben hat.

insightsValue

object (InsightsValue)

Eine der folgenden Möglichkeiten: 1) Die Summe der einzelnen Nutzer, die das Keyword in einem Monat verwendet haben, aggregiert für jeden angeforderten Monat. 2) Ein Grenzwert, der angibt, dass der tatsächliche Wert unter diesem Grenzwert liegt.

Statistikwert

Ein Statistikwert

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)

Der tatsächliche Wert.

threshold

string (int64 format)

Der Schwellenwert, unter dem der tatsächliche Wert liegt.