Package google.analytics.admin.v1beta

색인

AnalyticsAdminService

Analytics Admin API (GA4)의 서비스 인터페이스입니다.

AcknowledgeUserDataCollection

rpc AcknowledgeUserDataCollection(AcknowledgeUserDataCollectionRequest) returns (AcknowledgeUserDataCollectionResponse)

지정된 속성에 대한 사용자 데이터 수집 약관을 확인합니다.

MeasurementProtocolSecret 리소스를 만들려면 Google 애널리틱스 UI에서 또는 이 API를 통해 확인을 완료해야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
ArchiveCustomDimension

rpc ArchiveCustomDimension(ArchiveCustomDimensionRequest) returns (Empty)

속성의 CustomDimension을 보관처리합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
ArchiveCustomMetric

rpc ArchiveCustomMetric(ArchiveCustomMetricRequest) returns (Empty)

속성의 CustomMetric을 보관처리합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateConversionEvent

rpc CreateConversionEvent(CreateConversionEventRequest) returns (ConversionEvent)

지정된 속성으로 전환 이벤트를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateCustomDimension

rpc CreateCustomDimension(CreateCustomDimensionRequest) returns (CustomDimension)

맞춤 측정기준을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateCustomMetric

rpc CreateCustomMetric(CreateCustomMetricRequest) returns (CustomMetric)

CustomMetric을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateDataStream

rpc CreateDataStream(CreateDataStreamRequest) returns (DataStream)

DataStream을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateKeyEvent

rpc CreateKeyEvent(CreateKeyEventRequest) returns (KeyEvent)

키 이벤트를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateMeasurementProtocolSecret

rpc CreateMeasurementProtocolSecret(CreateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

측정 프로토콜 보안 비밀을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
CreateProperty

rpc CreateProperty(CreatePropertyRequest) returns (Property)

지정된 위치 및 속성으로 'GA4' 속성을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

대상 계정을 소프트 삭제 (예: '휴지통')로 표시하고 반환합니다.

이 API에는 소프트 삭제된 계정을 복원하는 방법이 없습니다. 하지만 휴지통 UI를 사용하여 복원할 수 있습니다.

만료 시간 전에 계정을 복원하지 않으면 계정 및 모든 하위 리소스 (예: 속성, GoogleAdsLinks, 스트림, AccessBinding)가 영구적으로 삭제됩니다. https://support.google.com/analytics/answer/6154772

타겟을 찾을 수 없으면 오류를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteConversionEvent

rpc DeleteConversionEvent(DeleteConversionEventRequest) returns (Empty)

속성에서 전환 이벤트를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteDataStream

rpc DeleteDataStream(DeleteDataStreamRequest) returns (Empty)

속성에서 DataStream을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteKeyEvent

rpc DeleteKeyEvent(DeleteKeyEventRequest) returns (Empty)

주요 이벤트를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteMeasurementProtocolSecret

rpc DeleteMeasurementProtocolSecret(DeleteMeasurementProtocolSecretRequest) returns (Empty)

타겟 MeasurementProtocolSecret을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
DeleteProperty

rpc DeleteProperty(DeletePropertyRequest) returns (Property)

대상 속성을 소프트 삭제 (예: 'trashed')된 것으로 표시하고 반환합니다.

이 API에는 소프트 삭제된 속성을 복원하는 메서드가 없습니다. 하지만 휴지통 UI를 사용하여 복원할 수 있습니다.

만료 시간 전에 속성을 복원하지 않으면 속성과 모든 하위 리소스 (예: GoogleAdsLinks, Streams, AccessBindings)가 영구적으로 삭제됩니다. https://support.google.com/analytics/answer/6154772

타겟을 찾을 수 없거나 GA4 속성이 아닌 경우 오류를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

단일 계정을 조회합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetConversionEvent

rpc GetConversionEvent(GetConversionEventRequest) returns (ConversionEvent)

단일 전환 이벤트를 검색합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetCustomDimension

rpc GetCustomDimension(GetCustomDimensionRequest) returns (CustomDimension)

단일 CustomDimension을 조회합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetCustomMetric

rpc GetCustomMetric(GetCustomMetricRequest) returns (CustomMetric)

단일 CustomMetric 조회

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetDataRetentionSettings

rpc GetDataRetentionSettings(GetDataRetentionSettingsRequest) returns (DataRetentionSettings)

이 속성의 싱글톤 데이터 보관 설정을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetDataSharingSettings

rpc GetDataSharingSettings(GetDataSharingSettingsRequest) returns (DataSharingSettings)

계정의 데이터 공유 설정을 가져옵니다. 데이터 공유 설정은 싱글톤입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetDataStream

rpc GetDataStream(GetDataStreamRequest) returns (DataStream)

단일 DataStream을 조회합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetKeyEvent

rpc GetKeyEvent(GetKeyEventRequest) returns (KeyEvent)

단일 주요 이벤트를 검색합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetMeasurementProtocolSecret

rpc GetMeasurementProtocolSecret(GetMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

단일 'GA4' MeasurementProtocolSecret을 조회합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
GetProperty

rpc GetProperty(GetPropertyRequest) returns (Property)

단일 'GA4' 속성을 조회합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListAccountSummaries

rpc ListAccountSummaries(ListAccountSummariesRequest) returns (ListAccountSummariesResponse)

호출자가 액세스할 수 있는 모든 계정의 요약을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

호출자가 액세스할 수 있는 모든 계정을 반환합니다.

이러한 계정에는 현재 GA4 속성이 없을 수 있습니다. 소프트 삭제된 계정 (즉, '휴지통')은 기본적으로 제외됩니다. 관련 계정을 찾을 수 없는 경우 빈 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListConversionEvents

rpc ListConversionEvents(ListConversionEventsRequest) returns (ListConversionEventsResponse)

지정된 상위 속성의 전환 이벤트 목록을 반환합니다.

전환 이벤트가 없으면 빈 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListCustomDimensions

rpc ListCustomDimensions(ListCustomDimensionsRequest) returns (ListCustomDimensionsResponse)

속성의 CustomDimension을 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListCustomMetrics

rpc ListCustomMetrics(ListCustomMetricsRequest) returns (ListCustomMetricsResponse)

속성의 CustomMetrics를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListDataStreams

rpc ListDataStreams(ListDataStreamsRequest) returns (ListDataStreamsResponse)

속성의 DataStreams를 나열합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListKeyEvents

rpc ListKeyEvents(ListKeyEventsRequest) returns (ListKeyEventsResponse)

지정된 상위 속성의 키 이벤트 목록을 반환합니다. 키 이벤트가 없으면 빈 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListMeasurementProtocolSecrets

rpc ListMeasurementProtocolSecrets(ListMeasurementProtocolSecretsRequest) returns (ListMeasurementProtocolSecretsResponse)

지정된 상위 속성 아래의 하위 MeasurementProtocolSecrets를 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ListProperties

rpc ListProperties(ListPropertiesRequest) returns (ListPropertiesResponse)

지정된 상위 계정 아래의 하위 속성을 반환합니다.

'GA4' 속성만 반환됩니다. 호출자에게 액세스 권한이 없으면 속성이 제외됩니다. 소프트 삭제된 속성 (즉, '휴지통')은 기본적으로 제외됩니다. 관련 속성이 없으면 빈 목록을 반환합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
ProvisionAccountTicket

rpc ProvisionAccountTicket(ProvisionAccountTicketRequest) returns (ProvisionAccountTicketResponse)

계정 생성을 위한 티켓을 요청합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
RunAccessReport

rpc RunAccessReport(RunAccessReportRequest) returns (RunAccessReportResponse)

데이터 액세스 레코드의 맞춤설정된 보고서를 반환합니다. 이 보고서는 사용자가 Google 애널리틱스 보고 데이터를 읽을 때마다 기록을 제공합니다. 액세스 기록은 최대 2년 동안 보관됩니다.

속성에 대한 데이터 액세스 보고서를 요청할 수 있습니다. 모든 속성에 대해 보고서를 요청할 수 있지만 할당량과 관련 없는 측정기준은 Google 애널리틱스 360 속성에서만 요청할 수 있습니다. 이 방법은 관리자만 사용할 수 있습니다.

이러한 데이터 액세스 레코드에는 GA4 UI 보고서, GA4 UI 탐색 분석, GA4 Data API, 연결을 통해 Google 애널리틱스에서 데이터를 가져올 수 있는 기타 제품(예: Firebase 및 AdMob)이 포함됩니다. 이러한 레코드에는 스트림 추가나 속성의 시간대 변경과 같은 속성 구성 변경사항은 포함되지 않습니다. 구성 변경 내역은 searchChangeHistoryEvents를 참조하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit
SearchChangeHistoryEvents

rpc SearchChangeHistoryEvents(SearchChangeHistoryEventsRequest) returns (SearchChangeHistoryEventsResponse)

지정된 필터 조합을 기준으로 계정 또는 하위 계정에 대한 모든 변경사항을 검색합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

계정을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateConversionEvent

rpc UpdateConversionEvent(UpdateConversionEventRequest) returns (ConversionEvent)

지정된 속성으로 전환 이벤트를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateCustomDimension

rpc UpdateCustomDimension(UpdateCustomDimensionRequest) returns (CustomDimension)

속성의 CustomDimension을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateCustomMetric

rpc UpdateCustomMetric(UpdateCustomMetricRequest) returns (CustomMetric)

속성의 CustomMetric을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateDataRetentionSettings

rpc UpdateDataRetentionSettings(UpdateDataRetentionSettingsRequest) returns (DataRetentionSettings)

이 속성의 싱글톤 데이터 보관 설정을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateDataStream

rpc UpdateDataStream(UpdateDataStreamRequest) returns (DataStream)

속성의 DataStream을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateKeyEvent

rpc UpdateKeyEvent(UpdateKeyEventRequest) returns (KeyEvent)

주요 이벤트를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateMeasurementProtocolSecret

rpc UpdateMeasurementProtocolSecret(UpdateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

측정 프로토콜 보안 비밀을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit
UpdateProperty

rpc UpdateProperty(UpdatePropertyRequest) returns (Property)

속성을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit

AccessBetweenFilter

결과가 두 숫자 (포함) 사이여야 합니다.

입력란
from_value

NumericValue

이 숫자로 시작합니다.
to_value

NumericValue

이 번호로 끝납니다.

AccessDateRange

연속 날짜 범위: startDate, startDate + 1, ..., endDate입니다.

입력란
start_date

string

YYYY-MM-DD 형식의 쿼리의 시작일(포함)입니다. endDate 이후일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며, 이 경우 요청 시간대의 현재 시간을 기반으로 날짜가 추론됩니다.
end_date

string

YYYY-MM-DD 형식으로 된 쿼리의 종료일입니다(해당 날짜 포함). startDate 이전일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며, 이 경우 요청 시간대의 현재 시간을 기반으로 날짜가 추론됩니다.

AccessDimension

측정기준은 데이터의 속성입니다. 예를 들어 userEmail 측정기준은 보고 데이터에 액세스한 사용자의 이메일을 나타냅니다. 보고서 응답의 측정기준 값은 문자열입니다.

입력란
dimension_name

string

측정기준의 API 이름입니다. 이 API에서 지원되는 측정기준 목록은 데이터 액세스 스키마를 참고하세요.

크기는 dimensionFilter 및 orderBys에서 이름으로 참조됩니다.

AccessDimensionHeader

보고서의 측정기준 열을 설명합니다. 보고서에서 요청된 측정기준은 행과 DimensionHeaders 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정기준은 보고서에서 열을 생성하지 않습니다. 따라서 이러한 측정기준은 헤더를 생성하지 않습니다.

입력란
dimension_name

string

측정기준의 이름입니다(예: 'userEmail').

AccessDimensionValue

측정기준의 값입니다.

입력란
value

string

측정기준 값입니다. 예를 들어 '국가' 측정기준의 경우 이 값이 '프랑스'일 수 있습니다.

AccessFilter

측정기준 또는 측정항목 값을 필터링하는 표현식입니다.

입력란
field_name

string

측정기준 이름 또는 측정항목 이름입니다.
통합 필드 one_filter. Filter에 대해 한 가지 유형의 필터를 지정하세요. one_filter은 다음 중 하나여야 합니다.
string_filter

AccessStringFilter

문자열 관련 필터입니다.
in_list_filter

AccessInListFilter

목록 값의 필터입니다.
numeric_filter

AccessNumericFilter

숫자 또는 날짜 값을 위한 필터입니다.
between_filter

AccessBetweenFilter

두 개의 값에 대한 필터.

AccessFilterExpression

측정기준 또는 측정항목 필터를 나타냅니다. 동일한 표현식의 필드는 모든 측정기준 또는 모든 측정항목이어야 합니다.

입력란
통합 필드 one_expression. FilterExpression에 대해 한 가지 유형의 필터 표현식을 지정합니다. one_expression은 다음 중 하나여야 합니다.
and_group

AccessFilterExpressionList

and_group의 각 FilterExpressions에는 AND 관계가 있습니다.
or_group

AccessFilterExpressionList

or_group의 각 FilterExpressions에는 OR 관계가 있습니다.
not_expression

AccessFilterExpression

FilterExpression이 not_expression이 아닙니다.
access_filter

AccessFilter

기본 필터 동일한 FilterExpression에서는 필터의 모든 필드 이름이 모든 측정기준 또는 측정항목이어야 합니다.

AccessFilterExpressionList

필터 표현식의 목록입니다.

입력란
expressions[]

AccessFilterExpression

필터 표현식의 목록입니다.

AccessInListFilter

결과는 문자열 값 목록에 있어야 합니다.

입력란
values[]

string

문자열 값 목록입니다. 비어 있으면 안 됩니다.
case_sensitive

bool

true인 경우 문자열 값은 대소문자를 구분합니다.

AccessMetric

보고서의 정량적 측정값입니다. 예를 들어 accessCount 측정항목은 데이터 액세스 레코드의 총 개수입니다.

입력란
metric_name

string

측정항목의 API 이름입니다. 이 API에서 지원되는 측정항목 목록은 데이터 액세스 스키마를 참조하세요.

측정항목은 metricFilter 및 orderBys에서 이름으로 참조됩니다.

AccessMetricHeader

보고서의 측정항목 열을 설명합니다. 보고서에 요청된 표시 측정항목은 행과 MetricHeaders 내에 열 항목을 생성합니다. 하지만 필터 또는 표현식 내에서만 사용되는 측정항목은 보고서에 열을 생성하지 않습니다. 따라서 이러한 측정항목은 헤더를 생성하지 않습니다.

입력란
metric_name

string

측정항목의 이름입니다(예: 'accessCount').

AccessMetricValue

측정항목의 값입니다.

입력란
value

string

측정값입니다. 예를 들어 이 값은 '13'일 수 있습니다.

AccessNumericFilter

숫자 또는 날짜 값을 위한 필터입니다.

입력란
operation

Operation

이 필터의 작업 유형입니다.
value

NumericValue

숫자 값 또는 날짜 값입니다.

작업

숫자 필터에 적용되는 연산입니다.

열거형
OPERATION_UNSPECIFIED 지정되지 않았습니다.
EQUAL 같음
LESS_THAN 미만
LESS_THAN_OR_EQUAL 작거나 같음
GREATER_THAN 초과
GREATER_THAN_OR_EQUAL 이상

AccessOrderBy

정렬 기준은 응답에서 행이 정렬되는 방식을 정의합니다. 예를 들어 액세스 수를 기준으로 행을 정렬하는 것은 하나의 순서이고, 국가 문자열을 기준으로 행을 정렬하는 것은 다른 순서입니다.

입력란
desc

bool

true인 경우 내림차순으로 정렬합니다. false이거나 지정되지 않은 경우 오름차순으로 정렬합니다.
통합 필드 one_order_by. OrderBy에 기준으로 한 가지 주문 유형을 지정합니다. one_order_by은 다음 중 하나여야 합니다.
metric

MetricOrderBy

측정항목 값을 기준으로 결과를 정렬합니다.
dimension

DimensionOrderBy

측정기준의 값을 기준으로 결과를 정렬합니다.

DimensionOrderBy

측정기준 값을 기준으로 정렬합니다.

입력란
dimension_name

string

정렬 기준으로 사용할 요청의 측정기준 이름입니다.
order_type

OrderType

측정기준 값 정렬에 대한 규칙을 관리합니다.

OrderType

문자열 측정기준 값을 정렬하는 규칙입니다.

열거형
ORDER_TYPE_UNSPECIFIED 지정되지 않았습니다.
ALPHANUMERIC 유니코드 코드 포인트별로 영숫자 정렬 예: '2' < 'A' < 'X' < 'b' < 'z'
CASE_INSENSITIVE_ALPHANUMERIC 대소문자를 구분하지 않는 영숫자를 사용하여 소문자 유니코드 코드 포인트를 기준으로 정렬합니다. 예: '2' < 'A' < 'b' < 'X' < 'z'
NUMERIC 측정기준 값은 정렬 전에 숫자로 변환됩니다. 예를 들어 NUMERIC 정렬에서는 '25' < '100'이고 ALPHANUMERIC 정렬에서는 '100' < '25'입니다. 숫자가 아닌 측정기준 값은 모든 숫자 값보다 낮은 순서 값을 갖습니다.

MetricOrderBy

측정항목 값을 기준으로 정렬합니다.

입력란
metric_name

string

정렬 기준으로 사용할 요청의 측정항목 이름입니다.

AccessQuota

이 애널리틱스 속성에 대한 모든 할당량의 현재 상태입니다. 속성의 할당량이 소진되면 해당 속성에 대한 모든 요청에서 리소스 소진 오류가 반환됩니다.

입력란
tokens_per_day

AccessQuotaStatus

속성에서 하루에 250,000개의 토큰을 사용할 수 있습니다. 대부분의 요청에서는 10개 미만의 토큰을 사용합니다.
tokens_per_hour

AccessQuotaStatus

속성에서 시간당 50,000개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰 수를 사용하며 이 숫자는 모든 시간별, 일별 및 프로젝트별 시간별 할당량에서 차감됩니다.
concurrent_requests

AccessQuotaStatus

속성은 최대 50개의 동시 요청을 사용할 수 있습니다.
server_errors_per_project_per_hour

AccessQuotaStatus

속성 및 클라우드 프로젝트 쌍에는 시간당 최대 50개의 서버 오류가 발생할 수 있습니다.
tokens_per_project_per_hour

AccessQuotaStatus

속성은 프로젝트별로 시간당 최대 25% 의 토큰을 사용할 수 있습니다. 따라서 애널리틱스 360 속성에서 프로젝트별로 시간당 12,500개의 토큰을 사용할 수 있습니다. API 요청은 단일 토큰 수를 사용하며 이 숫자는 모든 시간별, 일별 및 프로젝트별 시간별 할당량에서 차감됩니다.

AccessQuotaStatus

특정 할당량 그룹의 현재 상태입니다.

입력란
consumed

int32

이 요청에서 사용한 할당량입니다.
remaining

int32

이 요청 후 남은 할당량입니다.

AccessRow

각 행의 보고서 데이터에 액세스합니다.

입력란
dimension_values[]

AccessDimensionValue

측정기준 값 목록입니다. 이러한 값의 순서는 요청에 지정된 순서와 같습니다.
metric_values[]

AccessMetricValue

측정항목 값의 목록입니다. 이러한 값의 순서는 요청에 지정된 순서와 같습니다.

AccessStringFilter

문자열용 필터입니다.

입력란
match_type

MatchType

이 필터에 대한 검색 유형입니다.
value

string

일치에 사용되는 문자열 값입니다.
case_sensitive

bool

true인 경우 문자열 값은 대소문자를 구분합니다.

MatchType

문자열 필터의 일치 유형입니다.

열거형
MATCH_TYPE_UNSPECIFIED 미지정
EXACT 문자열 값의 정확한 일치입니다.
BEGINS_WITH 문자열 값으로 시작합니다.
ENDS_WITH 문자열 값으로 끝납니다.
CONTAINS 문자열 값을 포함합니다.
FULL_REGEXP 문자열 값이 있는 정규 표현식과 완전히 일치합니다.
PARTIAL_REGEXP 문자열 값이 있는 정규 표현식의 부분 일치

계정

Google 애널리틱스 계정을 나타내는 리소스 메시지입니다.

입력란
name

string

출력 전용입니다. 이 계정의 리소스 이름입니다. 형식: accounts/{account} 예: 'accounts/100'
create_time

Timestamp

출력 전용입니다. 이 계정이 처음 생성된 시간입니다.
update_time

Timestamp

출력 전용입니다. 계정 페이로드 필드가 마지막으로 업데이트된 시간입니다.
display_name

string

필수 항목입니다. 사람이 읽을 수 있는 계정의 표시 이름입니다.
region_code

string

업체 소재 국가입니다. 유니코드 CLDR 지역 코드여야 합니다.
deleted

bool

출력 전용입니다. 이 계정이 소프트 삭제되었는지 여부를 나타냅니다. 삭제된 계정은 별도로 요청하지 않는 한 목록 결과에서 제외됩니다.
gmp_organization

string

출력 전용입니다. Google Marketing Platform 조직 리소스의 URI입니다. 이 계정이 GMP 조직에 연결된 경우에만 설정됩니다. 형식: Marketingplatformadmin.googleapis.com/organizations/{org_id}

AccountSummary

계정 및 모든 하위 GA4 속성의 개요를 나타내는 가상 리소스입니다.

입력란
name

string

이 계정 요약의 리소스 이름입니다. 형식: accountSummaries/{account_id} 예: 'accountSummaries/1000'
account

string

이 계정 요약에서 참조하는 계정의 리소스 이름입니다. 형식: accounts/{account_id} 예: 'accounts/1000'
display_name

string

이 계정 요약에서 참조되는 계정의 표시 이름입니다.
property_summaries[]

PropertySummary

이 계정의 하위 계정에 대한 요약 목록입니다.

AcknowledgeUserDataCollectionRequest

AcknowledgeUserDataCollection RPC 요청 메시지입니다.

입력란
property

string

필수 항목입니다. 사용자 데이터 수집을 확인할 속성입니다.
acknowledgement

string

필수 항목입니다. 이 메서드의 호출자가 사용자 데이터 수집 약관을 이해했음을 알리는 확인입니다.

이 필드에는 정확한 값이 포함되어야 합니다. '개인 정보 보호에 필요한 사항을 공개하고 Google 애널리틱스에서 내 사이트 및 앱 속성으로부터 수집하는 방문 정보를 최종 사용자의 데이터와 연결하는 것을 포함하여 이러한 데이터의 수집과 처리를 위한 권한을 최종 사용자로부터 확보했음을 확인합니다.'

AcknowledgeUserDataCollectionResponse

이 유형에는 필드가 없습니다.

AcknowledgeUserDataCollection RPC의 응답 메시지입니다.

ActionType

리소스를 변경할 수 있는 작업 유형입니다.

열거형
ACTION_TYPE_UNSPECIFIED 작업 유형을 알 수 없거나 지정되지 않았습니다.
CREATED 이 변경사항에서 리소스가 생성되었습니다.
UPDATED 이 변경사항에서 리소스가 업데이트되었습니다.
DELETED 이 변경사항에서 리소스가 삭제되었습니다.

ActorType

Google 애널리틱스 리소스를 변경할 수 있는 다양한 유형의 행위자

열거형
ACTOR_TYPE_UNSPECIFIED 알 수 없거나 지정되지 않은 액터 유형입니다.
USER actor_email에 지정된 사용자가 변경한 사항
SYSTEM Google 애널리틱스 시스템에 의한 변경사항
SUPPORT Google 애널리틱스 지원팀 직원의 변경사항

ArchiveCustomDimensionRequest

ArchiveCustomDimension RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 보관처리할 맞춤 측정기준의 이름입니다. 예시 형식: properties/1234/customDimension/5678

ArchiveCustomMetricRequest

ArchiveCustomMetric RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 보관처리할 CustomMetric의 이름입니다. 예시 형식: properties/1234/customMetrics/5678

ChangeHistoryChange

단일 Google 애널리틱스 리소스에 대한 변경사항에 대한 설명입니다.

입력란
resource

string

이 항목에서 변경사항을 설명하는 리소스의 리소스 이름입니다.
action

ActionType

이 리소스를 변경한 작업 유형입니다.
resource_before_change

ChangeHistoryResource

변경 전의 리소스 콘텐츠입니다. 이번 변경사항으로 이 리소스를 만들었다면 이 필드가 누락됩니다.
resource_after_change

ChangeHistoryResource

변경 후의 리소스 콘텐츠입니다. 변경사항으로 이 리소스가 삭제된 경우 이 필드가 누락됩니다.

ChangeHistoryResource

변경 내역 변경의 결과 전후의 리소스 스냅샷입니다.

입력란

통합 필드 resource.

resource는 다음 중 하나여야 합니다.
account

Account

변경 내역에 있는 계정 리소스의 개요입니다.
property

Property

변경 내역에 있는 속성 리소스의 스냅샷입니다.
conversion_event

ConversionEvent

변경 내역에 있는 ConversionEvent 리소스의 스냅샷입니다.
measurement_protocol_secret

MeasurementProtocolSecret

변경 내역에 있는 MeasurementProtocolSecret 리소스의 스냅샷입니다.
data_retention_settings

DataRetentionSettings

변경 내역에 있는 데이터 보관 설정 리소스의 스냅샷입니다.
data_stream

DataStream

변경 내역에 있는 DataStream 리소스의 스냅샷입니다.

ChangeHistoryEvent

동일한 원인으로 인해 발생한 Google 애널리틱스 계정 또는 하위 속성 내의 변경사항 모음입니다. 일반적인 원인으로는 Google 애널리틱스 UI를 업데이트하거나 고객 지원팀에서 변경했거나 Google 애널리틱스 시스템이 자동으로 변경되었을 수 있습니다.

입력란
id

string

이 변경 내역 이벤트의 ID입니다. 이 ID는 Google 애널리틱스 전체에서 고유합니다.
change_time

Timestamp

변경이 이루어진 시간입니다.
actor_type

ActorType

이렇게 변경한 작업 수행자의 유형입니다.
user_actor_email

string

변경을 수행한 Google 계정의 이메일 주소입니다. 행위자 필드가 사용자로 설정된 경우 유효한 이메일 주소이며 그렇지 않으면 비어 있습니다. 삭제된 Google 계정은 오류를 일으킵니다.
changes_filtered

bool

true인 경우 반환된 변경사항 목록이 필터링되며, 이 이벤트에서 발생한 모든 변경사항을 나타내지는 않습니다.
changes[]

ChangeHistoryChange

SearchChangeHistoryEventsRequest에 지정된 필터에 맞는 이 변경 내역 이벤트의 변경사항 목록입니다.

ChangeHistoryResourceType

변경 내역에서 변경사항을 반환할 수 있는 리소스 유형입니다.

열거형
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED 리소스 유형을 알 수 없거나 지정되지 않았습니다.
ACCOUNT 계정 리소스
PROPERTY 속성 리소스
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings 리소스
CONVERSION_EVENT ConversionEvent 리소스
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret 리소스
DATA_RETENTION_SETTINGS DataRetainSettings 리소스
DATA_STREAM DataStream 리소스
ATTRIBUTION_SETTINGS AttributionSettings 리소스

ConversionEvent

Google 애널리틱스 속성의 전환 이벤트입니다.

입력란
name

string

출력 전용입니다. 이 전환 이벤트의 리소스 이름입니다. 형식: properties/{property}/conversionEvents/{conversion_event}
event_name

string

변경할 수 없습니다. 전환 이벤트의 이벤트 이름입니다. 예: '클릭', '구매'
create_time

Timestamp

출력 전용입니다. 속성에서 이 전환 이벤트가 생성된 시간입니다.
deletable

bool

출력 전용입니다. 설정된 경우 이 이벤트는 현재 DeleteConversionEvent로 삭제할 수 있습니다.
custom

bool

출력 전용입니다. true로 설정하면 이 전환 이벤트가 맞춤 이벤트를 참조합니다. false로 설정된 경우 이 전환 이벤트는 GA의 기본 이벤트를 참조합니다. 기본 이벤트는 일반적으로 GA에서 특별한 의미를 갖습니다. 기본 이벤트는 일반적으로 GA 시스템에서 자동으로 생성되지만 경우에 따라 속성 관리자가 만들 수도 있습니다. 맞춤 이벤트는 속성당 생성될 수 있는 최대 맞춤 전환 이벤트 수에 포함됩니다.
counting_method

ConversionCountingMethod

선택사항입니다. 세션 1회에서 여러 이벤트에서 전환이 집계되는 방법입니다. 이 값을 제공하지 않으면 ONCE_PER_EVENT로 설정됩니다.
default_conversion_value

DefaultConversionValue

선택사항입니다. 전환 이벤트의 기본값/통화를 정의합니다.

ConversionCountingMethod

세션 1회에서 여러 이벤트에서 전환이 집계되는 방법입니다.

열거형
CONVERSION_COUNTING_METHOD_UNSPECIFIED 계산 방법이 지정되지 않았습니다.
ONCE_PER_EVENT 각 이벤트 인스턴스는 전환으로 간주됩니다.
ONCE_PER_SESSION 이벤트 인스턴스는 사용자당 세션당 최대 한 번 전환으로 간주됩니다.

DefaultConversionValue

전환 이벤트의 기본값/통화를 정의합니다. 값과 통화를 모두 입력해야 합니다.

입력란
value

double

이 값은 이벤트 'value' 매개변수가 설정되지 않은 지정된 event_name의 모든 전환 값을 채우는 데 사용됩니다.
currency_code

string

이 event_name의 전환 이벤트에 설정된 통화가 없는 경우 이 통화가 기본값으로 적용됩니다. ISO 4217 통화 코드 형식이어야 합니다. 자세한 내용은 https://en.wikipedia.org/wiki/ISO_4217을 참조하세요.

CreateConversionEventRequest

CreateConversionEvent RPC 요청 메시지입니다.

입력란
conversion_event

ConversionEvent

필수 항목입니다. 생성할 전환 이벤트입니다.
parent

string

필수 항목입니다. 이 전환 이벤트가 생성될 상위 속성의 리소스 이름입니다. 형식: properties/123

CreateCustomDimensionRequest

CreateCustomDimension RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
custom_dimension

CustomDimension

필수 항목입니다. 만들 CustomDimension입니다.

CreateCustomMetricRequest

CreateCustomMetric RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
custom_metric

CustomMetric

필수 항목입니다. 만들 CustomMetric입니다.

CreateDataStreamRequest

CreateDataStream RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
data_stream

DataStream

필수 항목입니다. 만들 DataStream입니다.

CreateFirebaseLinkRequest

CreateFirebaseLink RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 형식: properties/{property_id} 예: properties/1234

CreateGoogleAdsLinkRequest

CreateGoogleAdsLink RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234

CreateKeyEventRequest

CreateKeyEvent RPC 요청 메시지입니다.

입력란
key_event

KeyEvent

필수 항목입니다. 생성할 주요 이벤트입니다.
parent

string

필수 항목입니다. 이 주요 이벤트가 생성될 상위 속성의 리소스 이름입니다. 형식: properties/123

CreateMeasurementProtocolSecretRequest

CreateMeasurementProtocolSecret RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 보안 비밀이 생성될 상위 리소스입니다. 형식: properties/{property}/dataStreams/{dataStream}
measurement_protocol_secret

MeasurementProtocolSecret

필수 항목입니다. 생성할 측정 프로토콜 보안 비밀입니다.

CreatePropertyRequest

CreateProperty RPC 요청 메시지입니다.

입력란
property

Property

필수 항목입니다. 생성할 속성입니다. 참고: 제공된 속성은 상위 속성을 지정해야 합니다.

CustomDimension

CustomDimension의 정의입니다.

입력란
name

string

출력 전용입니다. 이 CustomDimension 리소스의 리소스 이름입니다. 형식: properties/{property}/customDimension/{customDimension}
parameter_name

string

필수 항목입니다. 변경할 수 없습니다. 이 맞춤 측정기준의 태그 매개변수 이름입니다.

사용자 범위 측정기준인 경우에는 사용자 속성 이름입니다. 이벤트 범위 측정기준인 경우에는 이벤트 매개변수 이름입니다.

상품 범위 측정기준인 경우에는 전자상거래 상품 배열에서 찾을 수 있는 매개변수 이름입니다.

문자로 시작하는 영숫자 및 밑줄 문자만 포함할 수 있습니다. 사용자 범위 측정기준의 경우 최대 길이는 24자(영문 기준), 이벤트 범위 측정기준의 경우 40자(영문 기준)입니다.
display_name

string

필수 항목입니다. 애널리틱스 UI에 표시되는 이 맞춤 측정기준의 표시 이름입니다. 최대 길이는 82자(영문 기준), 영숫자 + 공백, 문자로 시작하는 밑줄입니다. 기존 시스템 생성 표시 이름에는 대괄호가 포함될 수 있지만 이 입력란을 업데이트하면 대괄호가 허용되지 않습니다.
description

string

선택사항입니다. 이 맞춤 측정기준에 대한 설명입니다. 최대 길이는 150자(영문 기준)입니다.
scope

DimensionScope

필수 항목입니다. 변경할 수 없습니다. 이 측정기준의 범위입니다.
disallow_ads_personalization

bool

선택사항입니다. true로 설정하면 이 측정기준을 NPA로 설정하고 광고 개인 최적화에서 제외합니다.

이 기능은 현재 사용자 범위 맞춤 측정기준에서만 지원됩니다.

DimensionScope

이 측정기준의 범위에 대한 유효한 값입니다.

열거형
DIMENSION_SCOPE_UNSPECIFIED 범위를 알 수 없거나 범위가 지정되지 않았습니다.
EVENT 이벤트 범위가 지정된 측정기준입니다.
USER 사용자로 범위가 지정된 측정기준입니다.
ITEM 전자상거래 항목으로 범위가 지정된 측정기준

CustomMetric

맞춤 측정항목의 정의입니다.

입력란
name

string

출력 전용입니다. 이 CustomMetric 리소스의 리소스 이름입니다. 형식: properties/{property}/customMetrics/{customMetric}
parameter_name

string

필수 항목입니다. 변경할 수 없습니다. 이 맞춤 측정항목의 태그 이름입니다.

이벤트 범위 측정항목인 경우에는 이벤트 매개변수 이름입니다.

문자로 시작하는 영숫자 및 밑줄 문자만 포함할 수 있습니다. 이벤트 범위 측정항목의 경우 최대 길이 40자(영문 기준)
display_name

string

필수 항목입니다. 애널리틱스 UI에 표시되는 이 맞춤 측정항목의 표시 이름입니다. 최대 길이는 82자(영문 기준), 영숫자 + 공백, 문자로 시작하는 밑줄입니다. 기존 시스템 생성 표시 이름에는 대괄호가 포함될 수 있지만 이 입력란을 업데이트하면 대괄호가 허용되지 않습니다.
description

string

선택사항입니다. 이 맞춤 측정기준에 대한 설명입니다. 최대 길이는 150자(영문 기준)입니다.
measurement_unit

MeasurementUnit

필수 항목입니다. 맞춤 측정항목 값의 유형입니다.
scope

MetricScope

필수 항목입니다. 변경할 수 없습니다. 이 맞춤 측정항목의 범위입니다.
restricted_metric_type[]

RestrictedMetricType

선택사항입니다. 이 측정항목에 포함될 수 있는 제한된 데이터의 유형입니다. CURRENCY 측정 단위가 있는 측정항목의 경우 필수 항목입니다. 측정 단위가 CURRENCY인 측정항목의 경우 비워 두어야 합니다.

MeasurementUnit

맞춤 측정항목의 값을 나타낼 수 있는 유형입니다.

통화 표현은 향후 변경될 수 있으므로 API에 관한 브레이킹 체인지를 필요로 합니다.

열거형
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit이 지정되지 않았거나 누락되었습니다.
STANDARD 이 측정항목은 기본 단위를 사용합니다.
CURRENCY 이 측정항목은 통화를 측정합니다.
FEET 이 메트릭은 피트를 측정합니다.
METERS 이 측정항목은 미터를 측정합니다.
KILOMETERS 이 측정항목은 킬로미터를 측정합니다.
MILES 이 측정항목은 마일을 측정합니다.
MILLISECONDS 이 측정항목은 밀리초를 측정합니다.
SECONDS 이 측정항목은 초를 측정합니다.
MINUTES 이 측정항목은 분을 측정합니다.
HOURS 이 측정항목은 시간을 측정합니다.

MetricScope

이 측정항목의 범위입니다.

열거형
METRIC_SCOPE_UNSPECIFIED 범위를 알 수 없거나 범위가 지정되지 않았습니다.
EVENT 이벤트로 범위가 지정된 측정항목입니다.

RestrictedMetricType

이 맞춤 측정항목의 데이터를 특정 사용자로 제한해야 하는 데이터로 표시하는 라벨입니다.

열거형
RESTRICTED_METRIC_TYPE_UNSPECIFIED 알 수 없거나 유형이 지정되지 않았습니다.
COST_DATA 측정항목은 비용 데이터를 보고합니다.
REVENUE_DATA 측정항목은 수익 데이터를 보고합니다.

DataRetentionSettings

데이터 보관 설정 값입니다. 싱글톤 리소스입니다.

입력란
name

string

출력 전용입니다. 이 DataRetainSetting 리소스의 리소스 이름입니다. 형식: properties/{property}/dataRetainSettings
event_data_retention

RetentionDuration

이벤트 수준 데이터가 보관되는 기간입니다.
reset_user_data_on_new_activity

bool

true인 경우 해당 사용자의 모든 이벤트와 함께 사용자 식별자의 보관 기간을 재설정합니다.

RetentionDuration

유효한 데이터 보관 기간 값입니다.

열거형
RETENTION_DURATION_UNSPECIFIED 데이터 보관 기간이 지정되지 않았습니다.
TWO_MONTHS 데이터 보관 기간은 2개월입니다.
FOURTEEN_MONTHS 데이터 보관 기간은 14개월입니다.
TWENTY_SIX_MONTHS 데이터 보관 기간은 26개월입니다. 360 속성에서만 사용할 수 있습니다.
THIRTY_EIGHT_MONTHS 데이터 보관 기간은 38개월입니다. 360 속성에서만 사용할 수 있습니다.
FIFTY_MONTHS 데이터 보관 기간은 50개월입니다. 360 속성에서만 사용할 수 있습니다.

DataSharingSettings

Google 애널리틱스 계정의 데이터 공유 설정을 나타내는 리소스 메시지입니다.

입력란
name

string

출력 전용입니다. 리소스 이름입니다. 형식: accounts/{account}/dataSharingSettings 예: "accounts/1000/dataSharingSettings"
sharing_with_google_support_enabled

bool

문제 해결을 위해 Google 지원팀에서 데이터에 액세스하도록 허용합니다.
sharing_with_google_assigned_sales_enabled

bool

고객에게 할당된 Google 영업팀이 데이터에 액세스하여 구성 변경을 제안하고 결과를 개선할 수 있도록 합니다. 사용 설정해도 영업팀 제한사항이 적용됩니다.
sharing_with_google_any_sales_enabled

bool

모든 Google 영업 담당자가 구성 변경을 제안하여 결과를 개선하기 위해 데이터에 액세스할 수 있도록 허용합니다.
sharing_with_google_products_enabled

bool

Google에서 데이터를 사용하여 다른 Google 제품이나 서비스를 개선하도록 허용합니다.
sharing_with_others_enabled

bool

Google에서 데이터를 다른 사용자와 익명으로 누계 형식으로 공유할 수 있습니다.

DataStream

데이터 스트림을 나타내는 리소스 메시지입니다.

입력란
name

string

출력 전용입니다. 이 데이터 스트림의 리소스 이름입니다. 형식: properties/{property_id}/dataStreams/{stream_id} 예: 'properties/1000/dataStreams/2000'
type

DataStreamType

필수 항목입니다. 변경할 수 없습니다. 이 DataStream 리소스의 유형입니다.
display_name

string

데이터 스트림의 사람이 읽을 수 있는 표시 이름입니다.

웹 데이터 스트림에 필요합니다.

허용되는 최대 표시 이름 길이는 255 UTF-16 코드 단위입니다.
create_time

Timestamp

출력 전용입니다. 이 스트림이 처음 생성된 시간입니다.
update_time

Timestamp

출력 전용입니다. 스트림 페이로드 필드가 마지막으로 업데이트된 시간입니다.
통합 필드 stream_data. 특정 데이터 스트림 유형의 데이터입니다. 이 스트림의 유형에 해당하는 메시지가 설정됩니다. stream_data은 다음 중 하나여야 합니다.
web_stream_data

WebStreamData

웹 스트림과 관련된 데이터입니다. 유형이 WEB_DATA_STREAM인 경우 채워야 합니다.
android_app_stream_data

AndroidAppStreamData

Android 앱 스트림과 관련된 데이터입니다. 유형이 ANDROID_APP_DATA_STREAM인 경우 채워야 합니다.
ios_app_stream_data

IosAppStreamData

iOS 앱 스트림과 관련된 데이터입니다. 유형이 IOS_APP_DATA_STREAM인 경우 채워야 합니다.

AndroidAppStreamData

Android 앱 스트림과 관련된 데이터입니다.

입력란
firebase_app_id

string

출력 전용입니다. Firebase의 해당 Android 앱 ID입니다(있는 경우). 이 ID는 Android 앱을 삭제하고 다시 만들면 변경될 수 있습니다.
package_name

string

변경할 수 없습니다. 측정 중인 앱의 패키지 이름입니다. 예: 'com.example.myandroidapp'

DataStreamType

데이터 스트림의 유형입니다.

열거형
DATA_STREAM_TYPE_UNSPECIFIED 알 수 없는 유형이거나 지정되지 않았습니다.
WEB_DATA_STREAM 웹 데이터 스트림
ANDROID_APP_DATA_STREAM Android 앱 데이터 스트림
IOS_APP_DATA_STREAM iOS 앱 데이터 스트림

IosAppStreamData

iOS 앱 스트림과 관련된 데이터입니다.

입력란
firebase_app_id

string

출력 전용입니다. Firebase에서 해당 iOS 앱의 ID입니다(있는 경우). 이 ID는 iOS 앱을 삭제하고 다시 만들면 변경될 수 있습니다.
bundle_id

string

필수 항목입니다. 변경할 수 없습니다. 앱의 Apple App Store 번들 ID 예: 'com.example.myiosapp'

WebStreamData

웹 스트림과 관련된 데이터입니다.

입력란
measurement_id

string

출력 전용입니다. 애널리틱스 측정 ID입니다.

예: "G-1A2BCD345E"
firebase_app_id

string

출력 전용입니다. Firebase의 해당 웹 앱 ID입니다(있는 경우). 이 ID는 웹 앱을 삭제하고 다시 만들면 변경될 수 있습니다.
default_uri

string

측정 중인 웹 앱의 도메인 이름이 있거나 비어 있습니다. 예: 'http://www.google.com', 'https://www.google.com'

DeleteAccountRequest

DeleteAccount RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 소프트 삭제할 계정의 이름입니다. 형식: accounts/{account} 예: 'accounts/100'

DeleteConversionEventRequest

DeleteConversionEvent RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 전환 이벤트의 리소스 이름입니다. 형식: properties/{property}/conversionEvents/{conversion_event} 예: 'properties/123/conversionEvents/456'

DeleteDataStreamRequest

DeleteDataStream RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 DataStream의 이름입니다. 예시 형식: properties/1234/dataStreams/5678

DeleteFirebaseLinkRequest

DeleteFirebaseLink RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 형식: properties/{property_id}/firebaseLinks/{firebase_link_id} 예: properties/1234/firebaseLinks/5678

DeleteGoogleAdsLinkRequest

DeleteGoogleAdsLink RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 예시 형식: properties/1234/googleAdsLinks/5678

DeleteKeyEventRequest

DeleteKeyEvent RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 키 이벤트의 리소스 이름입니다. 형식: properties/{property}/keyEvents/{key_event} 예: 'properties/123/keyEvents/456'

DeleteMeasurementProtocolSecretRequest

DeleteMeasurementProtocolSecret RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 MeasurementProtocolSecret의 이름입니다. 형식: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

DeletePropertyRequest

DeleteProperty RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 소프트 삭제할 속성의 이름입니다. 형식: properties/{property_id} 예: 'properties/1000'

GetAccountRequest

GetAccount RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 조회할 계정의 이름입니다. 형식: accounts/{account} 예: 'accounts/100'

GetConversionEventRequest

GetConversionEvent RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 전환 이벤트의 리소스 이름입니다. 형식: properties/{property}/conversionEvents/{conversion_event} 예: 'properties/123/conversionEvents/456'

GetCustomDimensionRequest

GetCustomDimension RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 가져올 맞춤 측정기준의 이름입니다. 예시 형식: properties/1234/customDimension/5678

GetCustomMetricRequest

GetCustomMetric RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 가져올 CustomMetric의 이름입니다. 예시 형식: properties/1234/customMetrics/5678

GetDataRetentionSettingsRequest

GetDataRetainSettings RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 조회할 설정의 이름입니다. 형식: properties/{property}/dataRetainSettings 예: 'properties/1000/dataRetainSettings'

GetDataSharingSettingsRequest

GetDataSharingSettings RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 조회할 설정의 이름입니다. 형식: accounts/{account}/dataSharingSettings 예: "accounts/1000/dataSharingSettings"

GetDataStreamRequest

GetDataStream RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 가져올 DataStream의 이름입니다. 예시 형식: properties/1234/dataStreams/5678

GetKeyEventRequest

GetKeyEvent RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 키 이벤트의 리소스 이름입니다. 형식: properties/{property}/keyEvents/{key_event} 예: 'properties/123/keyEvents/456'

GetMeasurementProtocolSecretRequest

GetMeasurementProtocolSecret RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 조회할 측정 프로토콜 보안 비밀의 이름입니다. 형식: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

GetPropertyRequest

GetProperty RPC 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 조회할 속성의 이름입니다. 형식: properties/{property_id} 예: 'properties/1000'

IndustryCategory

이 속성에 대해 선택된 카테고리로, 업계 벤치마킹에 사용됩니다.

열거형
INDUSTRY_CATEGORY_UNSPECIFIED 업종 카테고리 미지정
AUTOMOTIVE 자동차
BUSINESS_AND_INDUSTRIAL_MARKETS 비즈니스 및 산업 시장
FINANCE 금융
HEALTHCARE 의료 서비스
TECHNOLOGY 기술
TRAVEL 여행
OTHER 기타
ARTS_AND_ENTERTAINMENT 예술 및 엔터테인먼트
BEAUTY_AND_FITNESS 미용 및 피트니스
BOOKS_AND_LITERATURE 도서 및 문학
FOOD_AND_DRINK 식음료
GAMES 게임
HOBBIES_AND_LEISURE 취미 및 레저
HOME_AND_GARDEN 인테리어 및 원예
INTERNET_AND_TELECOM 인터넷 및 통신
LAW_AND_GOVERNMENT 법률 및 정부기관
NEWS 뉴스
ONLINE_COMMUNITIES 온라인 커뮤니티
PEOPLE_AND_SOCIETY 인물 및 사회
PETS_AND_ANIMALS 애완동물 및 동물
REAL_ESTATE 부동산
REFERENCE 참조
SCIENCE 과학
SPORTS 스포츠
JOBS_AND_EDUCATION 취업정보 및 교육
SHOPPING 쇼핑

KeyEvent

Google 애널리틱스 속성의 주요 이벤트입니다.

입력란
name

string

출력 전용입니다. 이 주요 이벤트의 리소스 이름입니다. 형식: properties/{property}/keyEvents/{key_event}
event_name

string

변경할 수 없습니다. 이 키 이벤트의 이벤트 이름입니다. 예: '클릭', '구매'
create_time

Timestamp

출력 전용입니다. 속성에서 이 주요 이벤트가 생성된 시간입니다.
deletable

bool

출력 전용입니다. true로 설정하면 이 이벤트를 삭제할 수 있습니다.
custom

bool

출력 전용입니다. true로 설정된 경우 이 주요 이벤트는 맞춤 이벤트를 참조합니다. false로 설정된 경우 이 주요 이벤트는 GA의 기본 이벤트를 나타냅니다. 기본 이벤트는 일반적으로 GA에서 특별한 의미를 갖습니다. 기본 이벤트는 일반적으로 GA 시스템에서 자동으로 생성되지만 경우에 따라 속성 관리자가 만들 수 있습니다. 맞춤 이벤트는 속성당 생성될 수 있는 최대 맞춤 주요 이벤트 수에 포함됩니다.
counting_method

CountingMethod

필수 항목입니다. 한 세션 내의 여러 이벤트에서 주요 이벤트가 집계되는 방법입니다.
default_value

DefaultValue

선택사항입니다. 키 이벤트의 기본값/통화를 정의합니다.

CountingMethod

한 세션 내의 여러 이벤트에서 주요 이벤트가 집계되는 방법입니다.

열거형
COUNTING_METHOD_UNSPECIFIED 계산 방법이 지정되지 않았습니다.
ONCE_PER_EVENT 각 이벤트 인스턴스는 주요 이벤트로 간주됩니다.
ONCE_PER_SESSION 이벤트 인스턴스는 사용자당 세션당 최대 한 번 주요 이벤트로 간주됩니다.

DefaultValue

키 이벤트의 기본값/통화를 정의합니다.

입력란
numeric_value

double

필수 항목입니다. 이는 해당 매개변수가 설정되지 않은 이 키 이벤트 (event_name으로 지정됨)의 모든 일치하는 항목에 대해 'value' 매개변수를 채우는 데 사용됩니다.
currency_code

string

필수 항목입니다. 이 주요 이벤트 (event_name에서 지정)에 설정된 통화가 없으면 이 통화가 기본값으로 적용됩니다. ISO 4217 통화 코드 형식이어야 합니다.

자세한 내용은 https://en.wikipedia.org/wiki/ISO_4217을 참조하세요.

ListAccountSummariesRequest

ListAccountSummaries RPC 요청 메시지입니다.

입력란
page_size

int32

반환할 AccountSummary 리소스의 최대 개수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListAccountSummaries 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListAccountSummaries에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListAccountSummariesResponse

ListAccountSummaries RPC의 응답 메시지입니다.

입력란
account_summaries[]

AccountSummary

발신자가 액세스할 수 있는 모든 계정의 계정 요약입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListAccountsRequest

ListAccounts RPC 요청 메시지입니다.

입력란
page_size

int32

반환할 최대 리소스 수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListAccounts 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListAccounts에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
show_deleted

bool

결과에 소프트 삭제된 (예: '휴지통') 계정을 포함할지 여부입니다. 계정을 검사하여 삭제 여부를 판단할 수 있습니다.

ListAccountsResponse

ListAccounts RPC 요청 메시지입니다.

입력란
accounts[]

Account

호출자가 액세스할 수 있었던 결과입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListConversionEventsRequest

ListConversionEvents RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 상위 속성의 리소스 이름입니다. 예: 'properties/123'
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListConversionEvents 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListConversionEvents에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListConversionEventsResponse

ListConversionEvents RPC의 응답 메시지입니다.

입력란
conversion_events[]

ConversionEvent

요청된 전환 이벤트
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListCustomDimensionsRequest

ListCustomDimension RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다).
page_token

string

이전 ListCustomDimensions 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListCustomDimensions에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListCustomDimensionsResponse

ListCustomDimension RPC의 응답 메시지입니다.

입력란
custom_dimensions[]

CustomDimension

CustomDimension의 목록입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListCustomMetricsRequest

ListCustomMetrics RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다).
page_token

string

이전 ListCustomMetrics 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListCustomMetrics에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListCustomMetricsResponse

ListCustomMetrics RPC의 응답 메시지입니다.

입력란
custom_metrics[]

CustomMetric

CustomMetrics의 목록입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListDataStreamsRequest

ListDataStreams RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다).
page_token

string

이전 ListDataStreams 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListDataStreams에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListDataStreamsResponse

ListDataStreams RPC의 응답 메시지입니다.

입력란
data_streams[]

DataStream

DataStreams 목록입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListFirebaseLinksRequest

ListFirebaseLinks RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 형식: properties/{property_id} 예: properties/1234
page_size

int32

반환할 최대 리소스 수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListFirebaseLinks 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListFirebaseLinks에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListFirebaseLinksResponse

ListFirebaseLinks RPC의 응답 메시지입니다.

입력란
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 현재 Google 애널리틱스는 속성당 하나의 FirebaseLink만 지원하므로 이 값은 채워지지 않습니다.

ListGoogleAdsLinksRequest

ListGoogleAdsLinks RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 예시 형식: properties/1234
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다).
page_token

string

이전 ListGoogleAdsLinks 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListGoogleAdsLinks에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListGoogleAdsLinksResponse

ListGoogleAdsLinks RPC의 응답 메시지입니다.

입력란
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListKeyEventsRequest

ListKeyEvents RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 상위 속성의 리소스 이름입니다. 예: 'properties/123'
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListKeyEvents 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListKeyEvents에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListKeyEventsResponse

ListKeyEvents RPC의 응답 메시지입니다.

입력란
key_events[]

KeyEvent

요청된 주요 이벤트
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListMeasurementProtocolSecretsRequest

ListMeasurementProtocolSecret RPC 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 상위 스트림의 리소스 이름입니다. 형식: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets
page_size

int32

반환할 최대 리소스 수입니다. 지정하지 않으면 최대 10개의 리소스가 반환됩니다. 최댓값은 10입니다. 더 높은 값이 최댓값으로 강제 변환됩니다.
page_token

string

이전 ListMeasurementProtocolSecrets 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListMeasurementProtocolSecrets에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListMeasurementProtocolSecretsResponse

ListMeasurementProtocolSecret RPC의 응답 메시지입니다.

입력란
measurement_protocol_secrets[]

MeasurementProtocolSecret

요청에 지정된 상위 스트림의 보안 비밀 목록입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListPropertiesRequest

ListProperties RPC 요청 메시지입니다.

입력란
filter

string

필수 항목입니다. 요청 결과를 필터링하기 위한 표현식입니다. 필터링할 수 있는 필드는 parent:(상위 계정/속성의 리소스 이름) 또는 ancestor:(상위 계정의 리소스 이름) 또는 firebase_project:(연결된 Firebase 프로젝트의 ID 또는 번호)입니다. 필터의 예는 다음과 같습니다.

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.       |
| parent:properties/123       | The property with property id: 123.       |
| ancestor:accounts/123       | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |
page_size

int32

반환할 최대 리소스 수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
page_token

string

이전 ListProperties 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 ListProperties에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
show_deleted

bool

결과에 소프트 삭제된 (예: '휴지통') 속성을 포함할지 여부입니다. 속성을 검사하여 삭제 여부를 판단할 수 있습니다.

ListPropertiesResponse

ListProperties RPC의 응답 메시지입니다.

입력란
properties[]

Property

필터 기준과 일치하고 호출자가 액세스할 수 있는 결과입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

MeasurementProtocolSecret

측정 프로토콜로 조회수를 전송하는 데 사용되는 보안 비밀 값입니다.

입력란
name

string

출력 전용입니다. 이 보안 비밀의 리소스 이름입니다. 이 보안 비밀은 모든 유형의 스트림 하위 요소가 될 수 있습니다. 형식: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}
display_name

string

필수 항목입니다. 이 보안 비밀의 인간이 읽을 수 있는 표시 이름입니다.
secret_value

string

출력 전용입니다. 측정 프로토콜 보안 비밀 값입니다. 이 보안 비밀의 상위 속성으로 조회를 전송할 때 이 값을 측정 프로토콜 API의 api_secret 필드에 전달하세요.

NumericValue

숫자를 나타냅니다.

입력란
통합 필드 one_value. 숫자 값 one_value 중 하나는 다음 중 하나여야 합니다.
int64_value

int64

정수 값
double_value

double

이중 값

속성

Google 애널리틱스 GA4 속성을 나타내는 리소스 메시지입니다.

입력란
name

string

출력 전용입니다. 이 속성의 리소스 이름입니다. 형식: properties/{property_id} 예: 'properties/1000'
property_type

PropertyType

변경할 수 없습니다. 이 속성 리소스의 속성 유형입니다. 속성을 만들 때 유형이 'PROPERTY_TYPE_UNSPECIFIED'인 경우 'ORDINARY_PROPERTY'가 암시적으로 적용됩니다.
create_time

Timestamp

출력 전용입니다. 항목이 처음 생성된 시간입니다.
update_time

Timestamp

출력 전용입니다. 항목 페이로드 필드가 마지막으로 업데이트된 시간입니다.
parent

string

변경할 수 없습니다. 이 속성의 논리적 상위 항목의 리소스 이름입니다.

참고: 속성 이동 UI를 사용하여 상위 요소를 변경할 수 있습니다. 형식: accounts/{account}, properties/{property} 예: 'accounts/100', 'properties/101'
display_name

string

필수 항목입니다. 사람이 읽을 수 있는 이 속성의 표시 이름입니다.

허용되는 최대 표시 이름 길이는 UTF-16 코드 단위 100개입니다.
industry_category

IndustryCategory

이 속성과 관련된 업종(예: AUTOMOTIVE, FOOD_AND_DRINK)
time_zone

string

필수 항목입니다. 데이터가 처음 생성된 위치에 관계없이 보고서의 날짜 구분을 위해 사용되는 보고 시간대입니다. 시간대가 DST에 적용되면 애널리틱스에서 이에 맞춰 자동으로 조정됩니다.

참고: 시간대를 변경하면 이후부터 수집되는 데이터에만 영향이 있으며 이전 데이터에는 반영되지 않습니다.

형식: https://www.iana.org/time-zones 예: 'America/Los_Angeles'
currency_code

string

금전적 가치와 관련된 보고서에 사용되는 통화 유형입니다.

형식: https://en.wikipedia.org/wiki/ISO_4217 예: 'USD', 'EUR', 'JPY'
service_level

ServiceLevel

출력 전용입니다. 이 속성에 적용되는 Google 애널리틱스 서비스 수준입니다.
delete_time

Timestamp

출력 전용입니다. 설정된 경우 이 속성이 휴지통으로 이동된 시간입니다. 설정하지 않으면 이 속성이 현재 휴지통에 없는 것입니다.
expire_time

Timestamp

출력 전용입니다. 설정하면 휴지통으로 이동한 속성이 영구적으로 삭제됩니다. 설정하지 않으면 이 속성이 현재 휴지통에 없는 것이며 삭제할 수 없습니다.
account

string

변경할 수 없습니다. 상위 계정의 리소스 이름입니다. 형식: accounts/{account_id}(예: 'accounts/123')

PropertySummary

GA4 속성의 메타데이터를 나타내는 가상 리소스입니다.

입력란
property

string

이 속성 요약에서 참조하는 속성의 리소스 이름입니다. 형식: properties/{property_id} 예: 'properties/1000'
display_name

string

이 속성 요약에서 참조되는 속성의 표시 이름입니다.
property_type

PropertyType

속성의 속성 유형입니다.
parent

string

이 속성의 논리적 상위 항목의 리소스 이름입니다.

참고: 속성 이동 UI를 사용하여 상위 요소를 변경할 수 있습니다. 형식: accounts/{account}, properties/{property} 예: 'accounts/100', 'properties/200'

PropertyType

속성 리소스의 유형입니다.

열거형
PROPERTY_TYPE_UNSPECIFIED 알 수 없거나 지정되지 않은 속성 유형
PROPERTY_TYPE_ORDINARY 일반 GA4 속성
PROPERTY_TYPE_SUBPROPERTY GA4 하위 속성
PROPERTY_TYPE_ROLLUP GA4 롤업 속성

ProvisionAccountTicketRequest

ProvisioningAccountTicket RPC 요청 메시지입니다.

입력란
account

Account

생성할 계정입니다.
redirect_uri

string

서비스 약관에 동의한 사용자가 이동하게 될 리디렉션 URI입니다. Cloud 콘솔에서 리디렉션 URI로 구성해야 합니다.

ProvisionAccountTicketResponse

ProvisioningAccountTicket RPC의 응답 메시지입니다.

입력란
account_ticket_id

string

서비스 약관 링크에서 전달되는 매개변수입니다.

RunAccessReportRequest

데이터 액세스 레코드 보고서 요청입니다.

입력란
entity

string

데이터 액세스 보고서에서는 속성 수준 또는 계정 수준에서의 요청을 지원합니다. 계정 수준에서 요청된 경우 데이터 액세스 보고서에는 해당 계정의 모든 속성에 대한 모든 액세스 권한이 포함됩니다.

속성 수준에서 요청하려면 예를 들어 '123'이 GA4 속성 ID인 경우 항목은 'properties/123'이어야 합니다. 계정 수준에서 요청하려면 예를 들어 '1234'가 GA4 계정 ID인 경우 항목은 'accounts/1234'여야 합니다.
dimensions[]

AccessDimension

응답에서 요청되고 표시되는 측정기준입니다. 요청은 최대 9개의 측정기준까지 허용됩니다.
metrics[]

AccessMetric

응답에서 요청되고 표시되는 측정항목입니다. 요청에는 최대 10개의 측정항목이 허용됩니다.
date_ranges[]

AccessDateRange

읽을 액세스 레코드의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0 기반 기간 색인이 포함됩니다. 두 기간이 겹치는 경우, 중복된 날짜에 대한 액세스 레코드가 두 기간의 응답 행에 포함됩니다. 요청은 최대 2개의 기간까지 허용됩니다.
dimension_filter

AccessFilterExpression

측정기준 필터를 사용하면 필터와 일치하는 특정 측정기준 값으로 보고서 응답을 제한할 수 있습니다. 예를 들어 단일 사용자의 액세스 레코드를 필터링할 수 있습니다. 자세한 내용은 측정기준 필터의 기본 요소의 예를 참조하세요. 이 필터에 측정항목을 사용할 수 없습니다.
metric_filter

AccessFilterExpression

측정항목 필터를 사용하면 필터와 일치하는 특정 측정항목 값으로 보고서 응답을 제한할 수 있습니다. 측정항목 필터는 SQL have-clause와 마찬가지로 보고서의 행을 집계한 후에 적용됩니다. 이 필터에 측정기준을 사용할 수 없습니다.
offset

int64

시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다. 오프셋을 지정하지 않으면 0으로 처리됩니다. 오프셋이 0이면 이 메서드는 limit 항목이 있는 결과의 첫 페이지를 반환합니다.

이러한 페이지로 나누기 매개변수에 대한 자세한 내용은 페이지로 나누기를 참고하세요.
limit

int64

반환할 행 수입니다. 지정하지 않으면 10,000개의 행이 반환됩니다. API는 요청하는 횟수에 관계없이 요청당 최대 100,000개의 행을 반환합니다. limit은(는) 양수여야 합니다.

남은 행이 limit만큼 많지 않은 경우 API가 요청된 limit보다 적은 행을 반환할 수 있습니다. 예를 들어 country 측정기준에 사용할 수 있는 값이 300개 미만이므로 country만 보고하는 경우 limit을 더 높은 값으로 설정하더라도 300개 이상의 행을 얻을 수 없습니다.

이러한 페이지로 나누기 매개변수에 대한 자세한 내용은 페이지로 나누기를 참고하세요.
time_zone

string

이 요청의 시간대입니다(지정된 경우). 지정하지 않으면 속성의 시간대가 사용됩니다. 요청의 시간대는 보고서의 시작일과 종료일을 해석하는 데 사용됩니다.

IANA 시간대 데이터베이스(https://www.iana.org/time-zones)의 문자열로 형식이 지정됩니다(예: 'America/New_York' 또는 'Asia/Tokyo').
order_bys[]

AccessOrderBy

응답에서 행이 정렬되는 방식을 지정합니다.
return_entity_quota

bool

이 애널리틱스 속성 할당량의 현재 상태를 반환할지 여부를 지정합니다. 할당량은 AccessQuota에 반환됩니다. 계정 수준 요청의 경우 이 필드는 false여야 합니다.
include_all_users

bool

선택사항입니다. API를 호출한 적이 없는 사용자를 응답에 포함할지 여부를 결정합니다. true인 경우 지정된 속성이나 계정에 액세스할 수 있는 모든 사용자가 API 호출 여부에 관계없이 응답에 포함됩니다. false인 경우 API를 호출한 사용자만 포함됩니다.
expand_groups

bool

선택사항입니다. 사용자 그룹 내의 사용자를 반환할지 여부를 결정합니다. 이 필드는 include_all_users가 true로 설정된 경우에만 작동합니다. true인 경우 지정된 속성 또는 계정에 액세스할 수 있는 모든 사용자를 반환합니다. false인 경우 직접 액세스할 수 있는 사용자만 반환됩니다.

RunAccessReportResponse

맞춤설정된 데이터 액세스 레코드 보고서 응답

입력란
dimension_headers[]

AccessDimensionHeader

보고서에서 특정 측정기준에 해당하는 열의 헤더입니다. DimensionHeaders의 수와 DimensionHeader의 순서는 행에 있는 측정기준과 일치합니다.
metric_headers[]

AccessMetricHeader

특정 측정항목에 해당하는 보고서 열의 헤더입니다. MetricHeaders 수와 MetricHeaders 순서는 행에 있는 측정항목과 일치합니다.
rows[]

AccessRow

보고서의 측정기준 값 조합과 측정항목 값의 행입니다.
row_count

int32

쿼리 결과의 총 행 수입니다. rowCount는 응답에 반환된 행 수, limit 요청 매개변수, offset 요청 매개변수와 관계가 없습니다. 예를 들어 쿼리에서 행 175개를 반환하고 API 요청에 limit 50이 포함된 경우 응답에 rowCount 175개가 포함되지만 행은 50개만 포함됩니다.

이러한 페이지로 나누기 매개변수에 대한 자세한 내용은 페이지로 나누기를 참고하세요.
quota

AccessQuota

이 요청이 포함된 애널리틱스 속성의 할당량 상태입니다. 계정 수준의 요청에서는 이 필드를 사용할 수 없습니다.

SearchChangeHistoryEventsRequest

SearchChangeHistoryEvents RPC 요청 메시지입니다.

입력란
account

string

필수 항목입니다. 변경 내역 리소스를 반환할 계정 리소스입니다. 형식: accounts/{account} 예: 'accounts/100'
property

string

선택사항입니다. 하위 속성의 리소스 이름입니다. 설정하면 이 속성 또는 하위 리소스의 변경사항만 반환합니다. 형식: properties/{propertyId} 예: 'properties/100'
resource_type[]

ChangeHistoryResourceType

선택사항입니다. 설정된 경우 이러한 유형 중 하나 이상과 일치하는 리소스에 대한 변경사항만 반환합니다.
action[]

ActionType

선택사항입니다. 설정하면 이러한 작업 유형 중 하나 이상과 일치하는 변경사항만 반환합니다.
actor_email[]

string

선택사항입니다. 설정하면 이 목록에 있는 사용자가 변경한 경우에만 변경사항을 반환합니다.
earliest_change_time

Timestamp

선택사항입니다. 설정된 경우 이 시간 이후 변경된 사항만 반환합니다 (해당 시간 포함).
latest_change_time

Timestamp

선택사항입니다. 설정하면 이 시간 (해당 시간 포함) 이전에 변경된 내용만 반환합니다.
page_size

int32

선택사항입니다. 반환할 ChangeHistoryEvent 항목의 최대 개수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 항목이 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다).
page_token

string

선택사항입니다. 이전 SearchChangeHistoryEvents 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 SearchChangeHistoryEvents에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

SearchChangeHistoryEventsResponse

SearchAccounts RPC의 응답 메시지입니다.

입력란
change_history_events[]

ChangeHistoryEvent

호출자가 액세스할 수 있었던 결과입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ServiceLevel

Google 애널리틱스의 다양한 서비스 수준

열거형
SERVICE_LEVEL_UNSPECIFIED 서비스 수준이 지정되지 않았거나 잘못되었습니다.
GOOGLE_ANALYTICS_STANDARD Google 애널리틱스의 표준 버전입니다.
GOOGLE_ANALYTICS_360 Google 애널리틱스의 유료 프리미엄 버전입니다.

UpdateAccountRequest

UpdateAccount RPC 요청 메시지입니다.

입력란
account

Account

필수 항목입니다. 업데이트할 계정입니다. 계정의 name 필드는 계정을 식별하는 데 사용됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update')이어야 합니다. 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateConversionEventRequest

UpdateConversionEvent RPC 요청 메시지입니다.

입력란
conversion_event

ConversionEvent

필수 항목입니다. 업데이트할 전환 이벤트입니다. name 필드는 업데이트할 설정을 식별하는 데 사용됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update'). 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateCustomDimensionRequest

UpdateCustomDimension RPC 요청 메시지입니다.

입력란
custom_dimension

CustomDimension

업데이트할 맞춤 측정기준입니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateCustomMetricRequest

UpdateCustomMetric RPC 요청 메시지입니다.

입력란
custom_metric

CustomMetric

업데이트할 CustomMetric
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateDataRetentionSettingsRequest

UpdateDataRetainSettings RPC 요청 메시지입니다.

입력란
data_retention_settings

DataRetentionSettings

필수 항목입니다. 업데이트할 설정입니다. name 필드는 업데이트할 설정을 식별하는 데 사용됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update'). 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateDataStreamRequest

UpdateDataStream RPC 요청 메시지입니다.

입력란
data_stream

DataStream

업데이트할 DataStream입니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateGoogleAdsLinkRequest

UpdateGoogleAdsLink RPC 요청 메시지입니다.

입력란
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update'). 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateKeyEventRequest

UpdateKeyEvent RPC 요청 메시지입니다.

입력란
key_event

KeyEvent

필수 항목입니다. 업데이트할 주요 이벤트입니다. name 필드는 업데이트할 설정을 식별하는 데 사용됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update'). 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.

UpdateMeasurementProtocolSecretRequest

UpdateMeasurementProtocolSecret RPC 요청 메시지입니다.

입력란
measurement_protocol_secret

MeasurementProtocolSecret

필수 항목입니다. 업데이트할 측정 프로토콜 보안 비밀입니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 생략된 필드는 업데이트되지 않습니다.

UpdatePropertyRequest

UpdateProperty RPC 요청 메시지입니다.

입력란
property

Property

필수 항목입니다. 업데이트할 속성입니다. 속성의 name 필드는 업데이트할 속성을 식별하는 데 사용됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 필드의 목록입니다. 필드 이름은 스네이크 표기법 (예: 'field_to_update'). 생략된 필드는 업데이트되지 않습니다. 전체 항목을 바꾸려면 문자열 '*'가 포함된 경로 하나를 사용하여 모든 필드와 일치시킵니다.