Method: locations.searchkeywords.impressions.monthly.list

Aramada veya haritalarda bir işletmeyi bulmak için kullanılan arama ağı anahtar kelimelerini döndürür. Her arama ağı anahtar kelimesi, aylık olarak toplanan gösterimlerle birlikte gösterilir.

Ö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}; locationId, kod karartılmamış giriş kimliğidir.

Sorgu parametreleri

Parametreler
monthlyRange

object (MonthlyRange)

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

integer

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

string (bytes format)

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

base64 kodlu bir dize.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

monthly.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)

Döndürülen sayfalara ayrılmış son sonucu gösteren jeton. Bu, bir sonraki "sayfayı" almak için başarılı isteklerde kullanılabilir sayısı. Yalnızca döndürülecek daha fazla sonuç olduğunda görünür.

base64 kodlu 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

MonthlyRange

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 ağı anahtar kelimesini ve değerini gösterir.

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

string

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

object (InsightsValue)

Aşağıdakilerden biri: 1) İstenen her ay için toplanır, bir ay içinde anahtar kelimeyi kullanan benzersiz kullanıcıların sayısı toplamı. 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
Birleştirme alanı InsightsValue. Aşağıdaki proto alanlarından yalnızca birinin mevcut olması gerektiğini gösterir. InsightsValue şunlardan yalnızca biri olabilir:
value

string (int64 format)

Gerçek değeri gösterir.
threshold

string (int64 format)

Gerçek değerin altına düştüğü eşiği gösterir.