Method: locations.searchkeywords.impressions.monthly.list

Gibt die Suchbegriffe zurück, mit denen ein Unternehmen in der Suche oder auf Google Maps gefunden wurde. Für jedes Keyword für Suchanzeigen werden Impressionen monatlich zusammengefasst.

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 Ort, 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 eingestellt 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 „monthly.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 ein Unternehmen gefunden wurde.
nextPageToken

string (bytes format)

Ein Token, das das letzte zurückgegebene paginierte Ergebnis angibt. Dies kann für erfolgreiche Anfragen zum Abrufen der nächsten „Seite“ verwendet werden von Keywords. Er ist nur vorhanden, wenn mehr Ergebnisse zurückgegeben werden.

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 (beides eingeschlossen).

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

object (Date)

Erforderlich. Einschließen – Es werden nur die Felder „Jahr“ und „Monat“ berücksichtigt.
endMonth

object (Date)

Erforderlich. Einschließen – Es werden nur die Felder „Jahr“ und „Monat“ berücksichtigt.

SearchKeywordCount

Stellt ein einzelnes Keyword für Suchanzeigen und dessen Wert dar.

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

string

Der kleingeschriebene String, den der Nutzer eingegeben hat.
insightsValue

object (InsightsValue)

Entweder: 1) Die Summe der Anzahl einzelner 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.

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. Stellt dar, 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.