- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MonatlicherBereich
- SearchKeywordCount
- InsightsValue
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 |
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 |
Erforderlich. Zeitraum in Monaten, für den die Impressionen für Keywords für Suchanzeigen aggregiert 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 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 ( |
Felder | |
---|---|
searchKeywordsCounts[] |
Suchbegriffe, die verwendet wurden, um ein Unternehmen zu finden. |
nextPageToken |
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 ( |
Felder | |
---|---|
startMonth |
Erforderlich. Inklusiv – Es werden nur die Felder für Jahr und Monat berücksichtigt. |
endMonth |
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 ( |
Felder | |
---|---|
searchKeyword |
Der kleingeschriebene String, den der Nutzer eingegeben hat. |
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 |
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 |
Der tatsächliche Wert. |
threshold |
Der Schwellenwert, unter dem der tatsächliche Wert liegt. |