Bir konumun Google analiz verilerini alın

Parametreler

Yol

Ad	Tür	Zorunlu	Açıklama
locationId	string	zorunlu	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
fromDate	string	isteğe bağlı	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	isteğe bağlı	End of the range (YYYY-MM-DD).	—

Yanıtlar

200Daily Google interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the profile is not connected.

Response

{  "data": {    "googleInsights": {      "total": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 412 },        { "startTime": "2025-06-02T00:00:00+00:00", "value": 388 }      ],      "search": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 300 }      ],      "maps": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 112 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 24 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 8 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 41 }      ],      "businessBookings": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodOrders": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodMenuClicks": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Bir konum için günlük Google Business Profile etkileşim verilerini döndürür. Her metrik, her bir noktası bir startTime (sayımın gruplandırıldığı gün) ve bir value içeren bir zaman serisi noktaları dizisidir.

Kullanılabilir metrikler:

total: toplam profil gösterimi, search ile maps toplamı. Aşağıdaki işlem metriklerini içermez, dolayısıyla yukarıdaki örnekte 412 = 300 arama + 112 haritalar.
search: Google Search sonuçlarındaki gösterimler (masaüstü ve mobil toplamı)
maps: Google Maps sonuçlarındaki gösterimler (masaüstü ve mobil toplamı)
directionsAction: konuma yol tarifi istekleri
phoneAction: arama düğmesine yapılan tıklamalar
websiteAction: web sitesine yönlendiren tıklamalar
businessBookings: profilden başlatılan rezervasyonlar
businessFoodOrders: profilden verilen yemek siparişleri
businessFoodMenuClicks: yemek menüsü bağlantısına yapılan tıklamalar

Yolda her iki id biçimi de kullanılabilir

Hem 1800289 hem de TG9jYXRpb246MTgwMDI4OQ== aynı konuma çözümlenir. Base64 Relay id biçimini tercih edin: tüm okuma uç noktaları bu biçimi döndürür ve API'nin geri kalanı da bu biçimi kabul eder. Ne sayı ne de çözümlenebilir bir Relay id olan bir değer, gövdesi {"data":{"googleInsights":null},"errors":[...]} olan bir 200 döndürür; bu durum kolayca bir sunucu arızasıyla karıştırılabilir.

Shell

curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2025-06-01&toDate=2025-06-30' \  -H "Authorization: API $LISTINGSAPI_KEY"

Bir veri güncellemesinin etkisini raporlama

Yaygın bir kullanım, değişiklik öncesi ve sonrası görünürlük raporudur: bir konuma çalışma saatleri veya kategori değişikliklerini gönderdikten sonra, değişiklikten önceki ve sonraki haftalar için google-analytics üzerinden düzenli aralıklarla sorgulama yapın ve artışı göstermek için search + maps toplamını grafik üzerinde gösterin. Konumun istenen zaman aralığında Google verisi yoksa veya Google profili bağlı değilse, metrikler boş bir dizi yerine null olarak döner; toplulaştırma işleminizde null ve [] değerlerini aynı şekilde ele alın. Yayın platformları arası bir görünüm için Facebook ve Bing analiz verileriyle birleştirin.