GA4 realtime active users by page, source, country
google-analytics.realtimeSee who is on your site right now (active users by page, source and country)
- 가격
- free정가 기준
- 성공률
- 100%최근 30일 · 1,086회
- 지연 시간 p50
- 368 msp95 572 ms
- 마지막 검증
- 2026. 7. 28.동작 확인됨
POSThttps://toolswitch.dev/v1/tools/google-analytics.realtimeBeta- 플랫폼 할당량 사용
- 동기 응답
- 공개 데이터 읽기
파라미터
covers the last 30 minutes only, and takes NO dateRanges — passing one is an error. Reusing a standard-report dimension name here is the usual failure
| 파라미터 | 유형 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 경로 파라미터 | ||||
property_id | 문자열 | 필수 | 123456789 | |
| 요청 본문(JSON) | ||||
limit | 정수 | 선택 | 20 | |
metrics | 배열 | 필수 | activeUsers, screenPageViews, conversions | [{"name":"activeUsers"}] |
dimensions | 배열 | 선택 | realtime has its OWN smaller dimension set — unifiedScreenName, country, deviceCategory, audienceName; pagePath is not among them | [{"name":"unifiedScreenName"}] |
minuteRanges | 배열 | 선택 | windows within the last 30 minutes, e.g. [{"startMinutesAgo":29,"endMinutesAgo":0}] | |
- 경로 파라미터
property_id문자열필수예시:
123456789- 요청 본문(JSON)
limit정수선택예시:
20metrics배열필수activeUsers, screenPageViews, conversions
예시:
[{"name":"activeUsers"}]dimensions배열선택realtime has its OWN smaller dimension set — unifiedScreenName, country, deviceCategory, audienceName; pagePath is not among them
예시:
[{"name":"unifiedScreenName"}]minuteRanges배열선택windows within the last 30 minutes, e.g. [{"startMinutesAgo":29,"endMinutesAgo":0}]
코드 예제
$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.
Beta
curl -X POST 'https://toolswitch.dev/v1/tools/google-analytics.realtime' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"limit":3,"metrics":[{"name":"activeUsers"}],"dimensions":[{"name":"country"}]}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/google-analytics.realtime",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"limit\":3,\"metrics\":[{\"name\":\"activeUsers\"}],\"dimensions\":[{\"name\":\"country\"}]}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/google-analytics.realtime", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"limit\":3,\"metrics\":[{\"name\":\"activeUsers\"}],\"dimensions\":[{\"name\":\"country\"}]}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());게이트웨이 API는 Beta이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 free이며 서비스 수수료가 포함되어 있습니다.