- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- MonthlyRange
- SearchKeywordCount
- InsightsValue
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 |
Zorunlu. Zaman serisinin getirilmesi gereken konum. Biçim: locations/{locationId}. Burada locationId, karartılmamış giriş kimliğidir. |
Sorgu parametreleri
Parametreler | |
---|---|
monthlyRange |
Zorunlu. Arama ağı anahtar kelimesi gösterimlerinin toplanacağı ay aralığı. |
pageSize |
İ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 |
İ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 ( |
Alanlar | |
---|---|
searchKeywordsCounts[] |
Bir işletmeyi bulmak için kullanılan arama terimleri. |
nextPageToken |
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 ( |
Alanlar | |
---|---|
startMonth |
Zorunlu. Kapsayıcı - Yalnızca yıl ve ay alanları dikkate alınır |
endMonth |
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 ( |
Alanlar | |
---|---|
searchKeyword |
Kullanıcının girdiği, küçük harfli dize. |
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 |
Alanlar | |
---|---|
InsightsValue alanı. Aşağıdaki proto alanlarından yalnızca birinin olması gerektiğini gösterir. InsightsValue şunlardan yalnızca biri olabilir: |
|
value |
Gerçek değeri temsil eder. |
threshold |
Gerçek değerin altına düştüğü eşiği temsil eder. |