Method: locations.searchkeywords.impressions.monthly.list

Aramada veya haritalarda bir işletmeyi bulmak için kullanılan arama anahtar kelimelerini döndürür. Her bir arama ağı anahtar kelimesine, aylık olarak toplanan gösterimler eşlik eder.

Örnek istek: 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 isteği

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Zaman serisinin getirilmesi gereken konum. Biçim: locations/{locationId}. Burada locationId, karartılmamış giriş kimliğidir.

Sorgu parametreleri

Parametreler
monthlyRange

object (MonthlyRange)

Zorunlu. Arama ağı anahtar kelimesi gösterimlerinin toplanacağı ay aralığı.
pageSize

integer

İsteğe bağlı. İstenen sonuçların sayısı. Varsayılan sayfa boyutu 100'dür. Sayfa boyutu en fazla 100 tane olacak şekilde ayarlanabilir.
pageToken

string (bytes format)

İsteğe bağlı. Döndürülecek sonraki sayfalara ayrılmış sonucu belirten jeton.

Base64 olarak kodlanmış bir dize.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

aylık.list için yanıtı temsil eder.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Alanlar
searchKeywordsCounts[]

object (SearchKeywordCount)

Bir işletmeyi bulmak için kullanılan arama terimleri.
nextPageToken

string (bytes format)

Sayfalara ayrılmış son sonucu belirten bir jeton. Bu anahtar kelime, sonraki anahtar kelime "sayfasını" almak için yapılan başarılı istekler tarafından kullanılabilir. Yalnızca döndürülecek daha fazla sonuç olduğunda mevcuttur.

Base64 olarak kodlanmış bir dize.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

MonthlyRange

Bir ay aralığını (her ikisi de dahil) gösteren zaman aralığı.

JSON gösterimi 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Alanlar
startMonth

object (Date)

Zorunlu. Kapsayıcı - Yalnızca yıl ve ay alanları dikkate alınır
endMonth

object (Date)

Zorunlu. Kapsayıcı - Yalnızca yıl ve ay alanları dikkate alınır

SearchKeywordCount

Tek bir arama anahtar kelimesini ve bu anahtar kelimenin değerini temsil eder.

JSON gösterimi 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Alanlar
searchKeyword

string

Kullanıcının girdiği, küçük harfli dize.
insightsValue

object (InsightsValue)

Şunlardan biri: 1) Anahtar kelimeyi bir ay içinde kullanan benzersiz kullanıcıların sayısının toplamı, istenen her ay için toplanır. 2) Gerçek değerin bu eşiğin altında olduğunu gösteren bir eşik.

InsightsValue

Bir analiz değerini temsil eder.

JSON gösterimi 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
Alanlar
InsightsValue alanı. Aşağıdaki proto alanlarından yalnızca birinin olması gerektiğini gösterir. InsightsValue şunlardan yalnızca biri olabilir:
value

string (int64 format)

Gerçek değeri temsil eder.
threshold

string (int64 format)

Gerçek değerin altına düştüğü eşiği temsil eder.