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 diisi. Lokasi tempat deret waktu harus diambil. Format: locations/{locationId} dengan locationId berupa ID listingan yang tidak di-obfuscate.

Parameter kueri

Parameter
monthlyRange

object (MonthlyRange)

Wajib diisi. 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 ke maksimum 100.
pageToken

string (bytes format)

Opsional. Token yang menunjukkan hasil yang diberi nomor 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 terakhir yang diberi nomor halaman ditampilkan. Ini dapat digunakan untuk menyelesaikan permintaan untuk mendapatkan "halaman" berikutnya kata kunci. Ini hanya akan ada jika ada lebih banyak hasil yang akan ditampilkan.

String berenkode base64.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 diisi. Inklusif - Hanya kolom tahun dan bulan yang akan dipertimbangkan
endMonth

object (Date)

Wajib diisi. 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 berhuruf kecil yang dimasukkan pengguna.
insightsValue

object (InsightsValue)

Salah satu dari: 1) Jumlah pengguna unik yang menggunakan kata kunci dalam sebulan, digabungkan untuk setiap bulan yang diminta. 2) Nilai minimum yang menunjukkan bahwa nilai sebenarnya di bawah nilai minimum 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 dapat berupa salah satu dari berikut:
value

string (int64 format)

Menampilkan nilai sebenarnya.
threshold

string (int64 format)

Menyatakan nilai minimum tempat nilai sebenarnya jatuh.