Method: locations.searchkeywords.impressions.monthly.list

Menampilkan kata kunci penelusuran yang digunakan untuk menemukan bisnis di penelusuran atau Maps. Setiap kata kunci penelusuran disertai dengan tayangan yang digabungkan setiap bulan.

Contoh permintaan: 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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Lokasi pengambilan deret waktu yang akan diambil. Format: locations/{locationId} dengan locationId adalah ID listingan yang tidak di-obfuscate.

Parameter kueri

Parameter
monthlyRange

object (MonthlyRange)

Wajib. Rentang dalam bulan untuk menggabungkan tayangan kata kunci penelusuran.
pageSize

integer

Opsional. Jumlah hasil yang diminta. Ukuran halaman default adalah 100. Ukuran halaman dapat ditetapkan hingga maksimum 100.
pageToken

string (bytes format)

Opsional. Token yang menunjukkan hasil dengan penomoran halaman berikutnya yang akan ditampilkan.

String berenkode base64.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Merepresentasikan respons untuk monthly.list.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Kolom
searchKeywordsCounts[]

object (SearchKeywordCount)

Istilah penelusuran yang telah digunakan untuk menemukan bisnis.
nextPageToken

string (bytes format)

Token yang menunjukkan hasil yang terakhir diberi nomor halaman yang ditampilkan. Ini dapat digunakan oleh permintaan yang berhasil untuk mendapatkan "halaman" kata kunci berikutnya. Data ini hanya akan muncul jika ada lebih banyak hasil yang akan ditampilkan.

String berenkode base64.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

MonthlyRange

Rentang waktu yang menunjukkan rentang bulan (keduanya inklusif).

Representasi JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Kolom
startMonth

object (Date)

Wajib. Inklusif - Hanya kolom tahun dan bulan yang akan dipertimbangkan
endMonth

object (Date)

Wajib. Inklusif - Hanya kolom tahun dan bulan yang akan dipertimbangkan

SearchKeywordCount

Mewakili satu kata kunci penelusuran dan nilainya.

Representasi JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Kolom
searchKeyword

string

String huruf kecil yang dimasukkan pengguna.
insightsValue

object (InsightsValue)

Salah satu dari: 1) Jumlah jumlah pengguna unik yang menggunakan kata kunci dalam satu bulan, digabungkan untuk setiap bulan yang diminta. 2) Ambang batas yang menunjukkan bahwa nilai sebenarnya di bawah ambang batas ini.

InsightsValue

Mewakili nilai insight.

Representasi JSON 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
Kolom
Kolom union InsightsValue. Menunjukkan bahwa hanya salah satu kolom proto berikut yang harus ada. InsightsValue hanya ada berupa salah satu diantara berikut:
value

string (int64 format)

Mewakili nilai sebenarnya.
threshold

string (int64 format)

Mewakili nilai minimum yang menjadi titik bawah nilai aktual.