이 페이지는 Cloud Translation API를 통해 번역되었습니다.

API 빠른 시작: 명령줄 사용

이 페이지에서는 다음 명령어를 사용하여 Google 애널리틱스 Data API v1을 시작하는 방법을 보여줍니다. 행입니다.

1단계: API 사용 설정

다음 버튼을 클릭하면 새 Google Cloud 프로젝트가 자동으로 생성됩니다. Google 애널리틱스 Data API v1을 사용 설정하고 여기에 필요한 튜토리얼:

Google Analytics Data API v1 사용 설정

OAuth2 사용자 인증 정보 구성으로 자동 리디렉션됩니다. 대화상자 어디에서 전화를 걸까요?라고 묻는 대화상자가 표시되면 다음을 선택합니다. 데스크톱.

표시되는 대화상자에서 다운로드 클라이언트 구성을 클릭하고 파일을 저장합니다. credentials.json를 작업 디렉터리로 복사하세요.

또는 다음 단계에 따라 OAuth2를 만들 수도 있습니다. 사용자 인증 정보를 수동으로 프로젝트를 수행할 수도 있습니다

2단계. Cloud SDK 설치 및 초기화

gcloud 명령줄 필요 설치해야 합니다

3단계: API 호출하기

이제 Google 애널리틱스 Data API를 사용하여 Google 애널리틱스 데이터를 쿼리할 수 있습니다. 속성

보고 항목 선택

이 튜토리얼에서는 GA_PROPERTY_ID 환경 변수를 사용하여 API 요청에 사용될 속성 ID입니다.

명령줄에 다음을 입력하여 GA_PROPERTY_ID 변수를 설정합니다.

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

[YOUR_GA_PROPERTY_ID]를 Google 애널리틱스 속성으로 교체합니다. 식별자. 예를 들면 다음과 같습니다.

export GA_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 애널리틱스 데이터 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/$GA_PROPERTY_ID:runReport -d @request.json

curl 명령어는 gcloud auth application-default print-access-token를 사용합니다. 명령어를 사용하여 인증 토큰을 가져옵니다.

파일 이름을 curl에 전달하려면 -d 옵션('데이터'용)을 사용하고 파일 이름 앞에 @ 기호를 붙입니다. 이 파일은 동일한 디렉터리에 있어야 합니다. curl 명령어를 실행합니다