이 페이지에서는 명령줄을 사용하여 Google Analytics Data API v1을 시작하는 방법을 설명합니다.
1단계: API 사용 설정
이 버튼을 클릭하여 새 Cloud Platform 프로젝트를 만들고, Google Analytics Data API v1을 자동으로 사용 설정하고, 이 튜토리얼에 필요한 OAuth2 사용자 인증 정보를 만듭니다.
Google Analytics Data API v1 사용 설정OAuth2 사용자 인증 정보 구성 대화상자로 자동 리디렉션됩니다. '전화를 거는 국가는 어디인가요?'라는 메시지가 표시되면 '데스크톱'을 선택합니다.
표시되는 대화상자에서 클라이언트 구성 다운로드를 클릭하고 credentials.json 파일을 작업 디렉터리에 저장합니다.
또는 이 단계에 따라 기존 프로젝트에서 수동으로 OAuth2 사용자 인증 정보를 만들 수도 있습니다.
2단계: Cloud SDK 설치 및 초기화
개발 머신에 gcloud 명령줄 도구를 설치해야 합니다.
3단계: API 호출
이제 Google 애널리틱스 Data API를 사용하여 Google 애널리틱스 4 속성을 쿼리할 수 있습니다.
보고 항목 선택
이 튜토리얼에서는 GA4_PROPERTY_ID 환경 변수를 사용하여 API 요청에 사용할 속성 ID를 저장합니다.
명령줄에 다음을 입력하여 GA4_PROPERTY_ID 변수를 설정합니다.
export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]
[YOUR-GA4-PROPERTY-ID] 를 Google 애널리틱스 4 속성 식별자로 바꿉니다. 예를 들면 다음과 같습니다.
export GA4_PROPERTY_ID=1234567890
요청 JSON 만들기
다음 request.json 파일은 간단한 보고서를 작성하는 방법을 보여줍니다.
다음 텍스트로 JSON 요청 파일을 만들고 작업 디렉터리에 request.json 일반 텍스트 파일로 저장합니다.
request.json
{
"dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
"dimensions": [{ "name": "country" }],
"metrics": [{ "name": "activeUsers" }]
}
인증
이 예시에서 사용자 인증 정보를 가져오려면 다음 명령어를 실행하고 1단계에서 다운로드한 사용자 인증 정보 JSON 파일의 경로를 사용합니다.
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/analytics.readonly \
--client-id-file=[PATH/TO/credentials.json]
OAuth 사용자 동의 대화상자가 새 브라우저 창에서 열립니다.
요청 전송
curl와 request.json의 본문 콘텐츠를 사용하여 Google Analytics Data API에 요청을 전송합니다. 명령줄에 다음을 입력합니다.
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json
curl 명령어는 gcloud auth application-default print-access-token 명령어를 사용하여 인증 토큰을 가져옵니다.
curl에 파일 이름을 전달하려면 -d 옵션('데이터'용)을 사용하고 파일 이름 앞에 @ 기호를 붙입니다. 이 파일은 curl 명령어를 실행하는
디렉터리에 있어야 합니다
축하합니다. 첫 번째 요청을 Google Analytics Data API에 보냈습니다.