관리 API
Management API 버전 3.0에 대한 참조 가이드입니다. Google 애널리틱스 구성 데이터의 쿼리 및 응답에 대한 전체 세부정보를 제공합니다. 구성 데이터의 개념 및 구조 가이드는 버전 3.0 개요를 참고하세요.
이 가이드의 각 섹션에서는 인증된 사용자의 구성 데이터에 한 종류의 항목에 대한 요청 방법과 응답을 정의합니다. 요청은 모두 REST 형식으로 표시됩니다. 각 메소드의 페이지 끝에 있는 API 탐색기에서 'Try it!' 링크를 사용하여 요청을 양방향으로 시도해 볼 수 있습니다.
리소스 유형
- 계정 요약
- 계정 사용자 링크
- 계정
- 애드워즈 링크
- 커스텀 데이터 소스
- 맞춤 측정기준
- 커스텀 측정항목
- 실험
- 필터
- 목표
- 클라이언트 ID
- 프로필 필터 링크
- 프로필 사용자 링크
- 리마케팅 잠재고객
- 세그먼트
- 샘플링되지 않은 보고서
- 업로드
- 뷰 (프로필)
- 웹 서비스
- 웹 속성 사용자 링크
계정 요약
계정 요약 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| list |
GET /management/accountSummaries
|
사용자가 액세스할 수 있는 계정 요약 (계정/속성/프로필로 구성된 간단한 트리)을 나열합니다. |
계정 사용자 링크
계정 사용자 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/entityUserLinks/linkId
|
지정된 계정에서 사용자를 삭제합니다. |
| 삽입 |
POST /management/accounts/accountId/entityUserLinks
|
사용자 계정이 100개 미만인 경우 새 계정에 사용자를 추가합니다. |
| list |
GET /management/accounts/accountId/entityUserLinks
|
지정된 계정의 계정-사용자 목록을 나열합니다. |
| 업데이트 |
PUT /management/accounts/accountId/entityUserLinks/linkId
|
지정된 계정의 기존 사용자에 대한 권한을 업데이트합니다. |
계정
계정 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| list |
GET /management/accounts
|
사용자가 액세스할 수 있는 모든 계정을 나열합니다. |
Google Ads 링크
애드워즈 링크 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
웹 서비스-애드워즈 연결을 삭제합니다. |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
사용자가 액세스할 수 있는 웹 서비스-애드워즈 링크를 반환합니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
webProperty-AdWords 링크를 생성합니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
지정된 웹 속성에 대한 webProperty-AdWords 연결을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
기존 webProperty-애드워즈 연결을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
기존 webProperty-애드워즈 연결을 업데이트합니다. |
맞춤 데이터 소스
맞춤 데이터 소스 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customDataSources
|
사용자가 액세스할 수 있는 맞춤 데이터 소스를 나열합니다. |
맞춤 측정기준
맞춤 측정기준 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
사용자가 액세스할 수 있는 맞춤 측정기준을 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/customDimensions
|
새 맞춤 측정기준을 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customDimensions
|
사용자가 액세스할 수 있는 맞춤 측정기준을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
기존 맞춤 측정기준을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
기존 맞춤 측정기준을 업데이트합니다. |
커스텀 측정항목
커스텀 측정항목 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
사용자가 액세스할 수 있는 맞춤 측정항목을 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/customMetrics
|
새 맞춤 측정항목을 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customMetrics
|
사용자가 액세스할 수 있는 맞춤 측정항목을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
기존 맞춤 측정항목을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
기존 맞춤 측정항목을 업데이트합니다. |
실험
실험 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
실험을 삭제합니다. |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
사용자가 액세스 권한이 있는 실험을 반환합니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
|
새 실험을 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
|
사용자가 액세스할 수 있는 실험을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
기존 실험을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
기존 실험을 업데이트합니다. |
필터
필터 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/filters/filterId
|
필터를 삭제합니다. |
| get |
GET /management/accounts/accountId/filters/filterId
|
사용자가 액세스할 수 있는 필터를 반환합니다. |
| 삽입 |
POST /management/accounts/accountId/filters
|
새 필터를 만듭니다. |
| list |
GET /management/accounts/accountId/filters
|
계정의 모든 필터를 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/filters/filterId
|
기존 필터를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/filters/filterId
|
기존 필터를 업데이트합니다. |
목표
목표 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
사용자가 액세스할 수 있는 목표를 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals
|
새 목표를 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals
|
사용자가 액세스할 수 있는 목표를 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
기존 목표를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
기존 목표를 업데이트합니다. |
클라이언트 ID
Management.clientId 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| hashClientId |
POST /management/clientId:hashClientId
|
지정된 클라이언트 ID를 해싱합니다. |
프로필 필터 링크
프로필 필터 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
프로필 필터 링크를 삭제합니다. |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
단일 프로필 필터 링크를 반환합니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks
|
새 프로필 필터 링크를 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks
|
프로필의 모든 프로필 필터 링크를 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
기존 프로필 필터 링크를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
기존 프로필 필터 링크를 업데이트합니다. |
프로필 사용자 링크
프로필 사용자 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId
|
지정된 뷰 (프로필)에서 사용자를 삭제합니다. |
| 삽입 |
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 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
리마케팅 잠재고객 삭제 |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
사용자가 액세스할 수 있는 리마케팅 잠재고객을 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences
|
새 리마케팅 잠재고객을 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences
|
사용자가 액세스할 수 있는 리마케팅 잠재고객을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
기존 리마케팅 잠재고객을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
기존 리마케팅 잠재고객을 업데이트합니다. |
세그먼트
세그먼트 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| list |
GET /management/segments
|
사용자가 액세스할 수 있는 세그먼트를 나열합니다. |
샘플링되지 않은 보고서
샘플링되지 않은 보고서 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId
|
샘플링되지 않은 보고서를 삭제합니다. |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId
|
샘플링되지 않은 단일 보고서를 반환합니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports
|
새로운 샘플링되지 않은 보고서 만들기 |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports
|
사용자가 액세스할 수 있는 샘플링되지 않은 보고서가 나열됩니다. |
업로드
업로드 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| 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
|
사용자가 액세스할 수 있는 업로드 목록 |
| 업로드 데이터 |
POST
|
맞춤 데이터 소스의 데이터를 업로드합니다. |
보기(프로필)
보기 (프로필) 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
보기 (프로필)를 삭제합니다. |
| get |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
사용자가 액세스할 수 있는 뷰 (프로필)를 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles
|
새 보기 (프로필)를 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles
|
사용자가 액세스할 수 있는 보기 (프로필)를 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
기존 보기 (프로필)를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
기존 보기 (프로필)를 업데이트합니다. |
웹 속성
웹 서비스 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| get |
GET /management/accounts/accountId/webproperties/webPropertyId
|
사용자가 액세스할 수 있는 속성을 가져옵니다. |
| 삽입 |
POST /management/accounts/accountId/webproperties
|
새 속성을 만듭니다. |
| list |
GET /management/accounts/accountId/webproperties
|
사용자가 액세스할 수 있는 속성을 나열합니다. |
| 패치 |
PATCH /management/accounts/accountId/webproperties/webPropertyId
|
기존 속성을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. |
| 업데이트 |
PUT /management/accounts/accountId/webproperties/webPropertyId
|
기존 속성을 업데이트합니다. |
웹 속성 사용자 링크
웹 속성 사용자 링크 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.
| 메서드 | HTTP 요청 | 설명 |
|---|---|---|
| 달리 명시되지 않는 한 URI는 https://www.googleapis.com/analytics/v3를 기준으로 합니다. | ||
| delete |
DELETE /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId
|
지정된 웹 속성에서 사용자를 삭제합니다. |
| 삽입 |
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
|
지정된 웹 서비스에서 기존 사용자의 권한을 업데이트합니다. |