- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- MonthlyRange
- SearchKeywordCount
- InsightsValue
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 |
Wajib. Lokasi pengambilan deret waktu yang akan diambil. Format: locations/{locationId} dengan locationId adalah ID listingan yang tidak di-obfuscate. |
Parameter kueri
Parameter | |
---|---|
monthlyRange |
Wajib. Rentang dalam bulan untuk menggabungkan tayangan kata kunci penelusuran. |
pageSize |
Opsional. Jumlah hasil yang diminta. Ukuran halaman default adalah 100. Ukuran halaman dapat ditetapkan hingga maksimum 100. |
pageToken |
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 ( |
Kolom | |
---|---|
searchKeywordsCounts[] |
Istilah penelusuran yang telah digunakan untuk menemukan bisnis. |
nextPageToken |
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 ( |
Kolom | |
---|---|
startMonth |
Wajib. Inklusif - Hanya kolom tahun dan bulan yang akan dipertimbangkan |
endMonth |
Wajib. Inklusif - Hanya kolom tahun dan bulan yang akan dipertimbangkan |
SearchKeywordCount
Mewakili satu kata kunci penelusuran dan nilainya.
Representasi JSON |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
Kolom | |
---|---|
searchKeyword |
String huruf kecil yang dimasukkan pengguna. |
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 |
Kolom | |
---|---|
Kolom union InsightsValue . Menunjukkan bahwa hanya salah satu kolom proto berikut yang harus ada. InsightsValue hanya ada berupa salah satu diantara berikut: |
|
value |
Mewakili nilai sebenarnya. |
threshold |
Mewakili nilai minimum yang menjadi titik bawah nilai aktual. |