API Reference

Management API

Management API 버전 3.0의 참조 가이드입니다. 여기에서는 Google 애널리틱스 구성 데이터의 쿼리 및 응답에 대한 전체 세부정보를 제공합니다. 구성 데이터의 개념과 구조에 대한 가이드는 버전 3.0 개요.

이 가이드의 각 섹션에서는 인증된 사용자의 구성 데이터에 있는 한 가지 유형의 항목에 대한 요청 메서드와 응답을 정의합니다. 요청은 모두 REST 형식으로 표시됩니다. 각 메서드의 페이지 끝에서 '사용해 보기' 링크를 사용하여 API 탐색기에서 대화형으로 요청을 사용해 볼 수 있습니다.

리소스 유형

  1. 계정 요약
  2. 계정 사용자 링크
  3. 계정
  4. 애드워즈 링크
  5. 커스텀 데이터 소스
  6. 맞춤 측정기준
  7. 커스텀 측정항목
  8. 실험
  9. 필터
  10. 목표
  11. 클라이언트 ID
  12. 프로필 필터 링크
  13. 프로필 사용자 링크
  14. 리마케팅 잠재고객
  15. 세그먼트
  16. 샘플링되지 않은 보고서
  17. 업로드
  18. 조회수 (프로필)
  19. 웹 속성
  20. 웹 속성 사용자 링크

계정 요약

Account Summaries 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
list GET  /management/accountSummaries 사용자가 액세스 권한이 있는 계정 요약 (계정/속성/프로필로 구성된 간단한 트리)을 나열합니다.

계정 사용자 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/entityUserLinks/linkId 지정된 계정에서 사용자를 삭제합니다.
insert POST  /management/accounts/accountId/entityUserLinks 사용자의 계정이 100개 미만인 경우 지정된 계정에 신규 사용자를 추가합니다.
list GET  /management/accounts/accountId/entityUserLinks 지정된 계정의 계정-사용자 링크를 나열합니다.
업데이트 PUT  /management/accounts/accountId/entityUserLinks/linkId 지정된 계정의 기존 사용자에 대한 권한을 업데이트합니다.

계정

Accounts 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
list GET  /management/accounts 사용자가 액세스할 수 있는 모든 계정을 나열합니다.

애드워즈 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId 웹 속성-애드워즈 연결을 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId 사용자가 액세스할 수 있는 웹 속성-애드워즈 링크를 반환합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks 웹 속성-애드워즈 연결을 생성합니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks 지정된 웹 속성의 webProperty-애드워즈 링크를 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId 기존의 웹 속성-애드워즈 연결을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId 기존의 웹 속성-애드워즈 연결을 업데이트합니다.

맞춤 데이터 소스

맞춤 데이터 소스 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources 사용자에게 액세스 권한이 있는 맞춤 데이터 소스를 나열합니다.

맞춤 측정기준

맞춤 측정기준 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId 사용자가 액세스할 수 있는 맞춤 측정기준을 가져옵니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions 새 맞춤 측정기준을 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions 사용자가 액세스할 수 있는 맞춤 측정기준을 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId 기존 맞춤 측정기준을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId 기존 맞춤 측정기준을 업데이트합니다.

커스텀 측정항목

커스텀 측정항목 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId 사용자가 액세스할 수 있는 맞춤 측정항목을 가져옵니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics 새 맞춤 측정항목을 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics 사용자가 액세스할 수 있는 커스텀 측정항목을 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId 기존 맞춤 측정항목을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId 기존 맞춤 측정항목을 업데이트합니다.

실험

실험 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId 실험을 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId 사용자에게 액세스 권한이 있는 실험을 반환합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments 새 실험을 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments 사용자가 액세스할 수 있는 실험을 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId 기존 실험을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId 기존 실험을 업데이트합니다.

필터

필터 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/filters/filterId 필터를 삭제합니다.
get GET  /management/accounts/accountId/filters/filterId 사용자가 액세스 권한이 있는 필터를 반환합니다.
insert POST  /management/accounts/accountId/filters 새 필터를 만듭니다.
list GET  /management/accounts/accountId/filters 계정의 모든 필터를 나열합니다.
patch PATCH  /management/accounts/accountId/filters/filterId 기존 필터를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/filters/filterId 기존 필터를 업데이트합니다.

목표

목표 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId 사용자가 액세스할 수 있는 목표를 가져옵니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals 새 목표를 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals 사용자가 액세스할 수 있는 목표를 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId 기존 목표를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId 기존 목표를 업데이트합니다.

클라이언트 ID

Management.clientId 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
hashClientId POST  /management/clientId:hashClientId 지정된 클라이언트 ID를 해시합니다.

프로필 필터 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId 프로필 필터 링크를 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId 단일 프로필 필터 링크를 반환합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks 새 프로필 필터 링크를 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks 프로필의 모든 프로필 필터 링크를 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId 기존 프로필 필터 링크를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId 기존 프로필 필터 링크를 업데이트합니다.

Profile User Links 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId 지정된 보기 (프로필)에서 사용자를 삭제합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks 지정된 보기 (프로필)에 새 사용자를 추가합니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks 지정된 보기 (프로필)에 대한 프로필-사용자 링크를 나열합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId 지정된 보기 (프로필)에서 기존 사용자에 대한 권한을 업데이트합니다.

리마케팅 잠재고객

리마케팅 잠재고객 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId 리마케팅 잠재고객을 삭제하세요.
get GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId 사용자가 액세스할 수 있는 리마케팅 잠재고객을 가져옵니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences 새 리마케팅 잠재고객을 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences 사용자가 액세스할 수 있는 리마케팅 잠재고객을 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId 기존 리마케팅 잠재고객을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId 기존 리마케팅 잠재고객을 업데이트합니다.

세그먼트

세그먼트 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
list GET  /management/segments 사용자가 액세스할 수 있는 세그먼트를 나열합니다.

샘플링되지 않은 보고서

샘플링되지 않은 보고서 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId 샘플링되지 않은 보고서를 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId 샘플링되지 않은 단일 보고서를 반환합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports 샘플링되지 않은 새 보고서를 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports 사용자가 액세스할 수 있는 샘플링되지 않은 보고서를 나열합니다.

업로드

업로드 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData 이전 업로드와 관련된 데이터를 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId 사용자가 액세스할 수 있는 업로드를 나열합니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads 사용자가 액세스할 수 있는 업로드를 나열합니다.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
맞춤 데이터 소스의 데이터를 업로드합니다.

보기(프로필)

뷰 (프로필) 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId 보기 (프로필)를 삭제합니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId 사용자가 액세스할 수 있는 보기 (프로필)를 가져옵니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles 새 보기 (프로필)를 만듭니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles 사용자가 액세스할 수 있는 보기 (프로필)를 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId 기존 보기 (프로필)를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId 기존 보기 (프로필)를 업데이트합니다.

웹 속성

Web Properties 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
get GET  /management/accounts/accountId/webproperties/webPropertyId 사용자가 액세스할 수 있는 속성을 가져옵니다.
insert POST  /management/accounts/accountId/webproperties 새 속성을 만듭니다.
list GET  /management/accounts/accountId/webproperties 사용자가 액세스할 수 있는 속성을 나열합니다.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId 기존 속성을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId 기존 속성을 업데이트합니다.

웹 속성 사용자 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/analytics/v3의 상대 URI입니다.
삭제 DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId 지정된 웹 속성에서 사용자를 삭제합니다.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks 지정된 웹 속성에 신규 사용자를 추가합니다.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks 지정된 웹 속성의 webProperty-user 링크를 나열합니다.
업데이트 PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId 지정된 웹 속성에 대한 기존 사용자의 권한을 업데이트합니다.