Package google.analytics.admin.v1alpha

索引

AnalyticsAdminService

Analytics Admin API (GA4) 服務介面。

AcknowledgeUserDataCollection

rpc AcknowledgeUserDataCollection(AcknowledgeUserDataCollectionRequest) returns (AcknowledgeUserDataCollectionResponse)

確認指定資源的使用者資料收集條款。

您必須先在 Google Analytics (分析) UI 中或透過這個 API 完成這項確認程序,才能建立 MeasurementProtocolSecret 資源。

授權範圍

需要下列 OAuth 範圍:

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

rpc ApproveDisplayVideo360AdvertiserLinkProposal(ApproveDisplayVideo360AdvertiserLinkProposalRequest) returns (ApproveDisplayVideo360AdvertiserLinkProposalResponse)

核准 DisplayVideo360AdvertiserLinkProposal。系統將刪除 DisplayVideo360AdvertiserLinkProposal 並建立新的 DisplayVideo360AdvertiserLink。

授權範圍

需要下列 OAuth 範圍:

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

rpc ArchiveAudience(ArchiveAudienceRequest) returns (Empty)

封存資源中的目標對象。

授權範圍

需要下列 OAuth 範圍:

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

rpc ArchiveCustomDimension(ArchiveCustomDimensionRequest) returns (Empty)

封存資源中的自訂維度。

授權範圍

需要下列 OAuth 範圍:

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

rpc ArchiveCustomMetric(ArchiveCustomMetricRequest) returns (Empty)

這個外掛程式能封存資源的自訂指標。

授權範圍

需要下列 OAuth 範圍:

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

rpc BatchCreateAccessBindings(BatchCreateAccessBindingsRequest) returns (BatchCreateAccessBindingsResponse)

建立帳戶或資源多個存取權繫結的相關資訊。

此為交易方法。如果無法建立任何 AccessBinding,系統就不會建立任何 AccessBinding。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
BatchDeleteAccessBindings

rpc BatchDeleteAccessBindings(BatchDeleteAccessBindingsRequest) returns (Empty)

這會刪除多位使用者的帳戶或資源連結資訊。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
BatchGetAccessBindings

rpc BatchGetAccessBindings(BatchGetAccessBindingsRequest) returns (BatchGetAccessBindingsResponse)

取得帳戶或資源多個存取權繫結的相關資訊。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users.readonly
  • https://www.googleapis.com/auth/analytics.manage.users
BatchUpdateAccessBindings

rpc BatchUpdateAccessBindings(BatchUpdateAccessBindingsRequest) returns (BatchUpdateAccessBindingsResponse)

更新帳戶或資源多個存取權繫結的相關資訊。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
CancelDisplayVideo360AdvertiserLinkProposal

rpc CancelDisplayVideo360AdvertiserLinkProposal(CancelDisplayVideo360AdvertiserLinkProposalRequest) returns (DisplayVideo360AdvertiserLinkProposal)

取消 DisplayVideo360AdvertiserLinkProposal。取消的可能包括:- 拒絕透過 Display & Video 360 發起的提案 - 撤銷透過 Google Analytics (分析) 發起的提案。取消提案後,提案最終就會自動刪除。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateAccessBinding(CreateAccessBindingRequest) returns (AccessBinding)

為帳戶或資源建立存取權繫結。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
CreateAudience

rpc CreateAudience(CreateAudienceRequest) returns (Audience)

建立目標對象。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateCalculatedMetric(CreateCalculatedMetricRequest) returns (CalculatedMetric)

建立 CalculatedMetric。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateChannelGroup(CreateChannelGroupRequest) returns (ChannelGroup)

建立 ChannelGroup。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateConnectedSiteTag(CreateConnectedSiteTagRequest) returns (CreateConnectedSiteTagResponse)

為通用 Analytics (分析) 資源建立已連結的網站代碼。每個資源最多可建立 20 個已連結的網站代碼。注意:這個 API 無法用於 GA4 資源。

授權範圍

需要下列 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)

建立自訂指標。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateDataStream(CreateDataStreamRequest) returns (DataStream)

建立 DataStream。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateDisplayVideo360AdvertiserLinkProposal(CreateDisplayVideo360AdvertiserLinkProposalRequest) returns (DisplayVideo360AdvertiserLinkProposal)

建立 DisplayVideo360AdvertiserLink 提案。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateEventCreateRule(CreateEventCreateRuleRequest) returns (EventCreateRule)

建立 EventCreateRule。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateExpandedDataSet(CreateExpandedDataSetRequest) returns (ExpandedDataSet)

建立 ExpandedDataSet。

授權範圍

需要下列 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)

建立 Measurement Protocol 密鑰。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateProperty(CreatePropertyRequest) returns (Property)

建立含有指定地點和屬性的「GA4」資源。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateRollupProperty(CreateRollupPropertyRequest) returns (CreateRollupPropertyResponse)

請建立綜覽資源和所有綜覽資源來源連結。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateSKAdNetworkConversionValueSchema(CreateSKAdNetworkConversionValueSchemaRequest) returns (SKAdNetworkConversionValueSchema)

建立 SKAdNetworkConversionValueSchema。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateSubproperty(CreateSubpropertyRequest) returns (CreateSubpropertyResponse)

建立子資源和子資源事件篩選器,並套用至已建立的子資源。

授權範圍

需要下列 OAuth 範圍:

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

rpc CreateSubpropertyEventFilter(CreateSubpropertyEventFilterRequest) returns (SubpropertyEventFilter)

建立子資源「事件篩選器」。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteAccessBinding(DeleteAccessBindingRequest) returns (Empty)

刪除帳戶或資源的存取繫結。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

將目標帳戶標示為已虛刪除 (例如「已移至垃圾桶」),並傳回該帳戶。

這個 API 無法還原虛刪除的帳戶。不過,如要還原這些郵件,請使用「垃圾桶」使用者介面。

如果在到期前未還原帳戶,帳戶和所有子項資源 (例如:Properties、GoogleAdsLinks、Streams、AccessBindings) 都會遭到永久清除。https://support.google.com/analytics/answer/6154772

如果找不到目標,系統會傳回錯誤。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteCalculatedMetric(DeleteCalculatedMetricRequest) returns (Empty)

刪除屬性上的 CalculatedMetric。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteChannelGroup(DeleteChannelGroupRequest) returns (Empty)

刪除資源的 ChannelGroup。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteConnectedSiteTag(DeleteConnectedSiteTagRequest) returns (Empty)

為通用 Analytics (分析) 資源刪除已連結的網站代碼。注意:這不會影響 GA4 資源。

授權範圍

需要下列 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
DeleteDisplayVideo360AdvertiserLinkProposal

rpc DeleteDisplayVideo360AdvertiserLinkProposal(DeleteDisplayVideo360AdvertiserLinkProposalRequest) returns (Empty)

刪除資源的 DisplayVideo360AdvertiserLinkProposal 的資源。只能用於已取消的提案。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteEventCreateRule(DeleteEventCreateRuleRequest) returns (Empty)

刪除 EventCreateRule。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteExpandedDataSet(DeleteExpandedDataSetRequest) returns (Empty)

刪除屬性上的 ExpandedDataSet。

授權範圍

需要下列 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)

將目標屬性標示為已虛刪除 (例如「已移至垃圾桶」),並傳回該資源。

這個 API 沒有還原虛刪除屬性的方法。不過,如要還原這些郵件,請使用「垃圾桶」使用者介面。

如果在到期前未還原資源,資源和所有子項資源 (例如 GoogleAdsLinks、Streams、AccessBindings) 都會永久遭到清除。https://support.google.com/analytics/answer/6154772

如果找不到指定目標或非 GA4 資源,系統會傳回錯誤。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteSKAdNetworkConversionValueSchema(DeleteSKAdNetworkConversionValueSchemaRequest) returns (Empty)

刪除目標 SKAdNetworkConversionValueSchema。

授權範圍

需要下列 OAuth 範圍:

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

rpc DeleteSubpropertyEventFilter(DeleteSubpropertyEventFilterRequest) returns (Empty)

刪除子資源事件篩選器。

授權範圍

需要下列 OAuth 範圍:

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

rpc FetchAutomatedGa4ConfigurationOptOut(FetchAutomatedGa4ConfigurationOptOutRequest) returns (FetchAutomatedGa4ConfigurationOptOutResponse)

擷取通用 Analytics (分析) 資源的自動 GA4 設定程序停用狀態。注意:這不會對 GA4 資源造成任何影響。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc FetchConnectedGa4Property(FetchConnectedGa4PropertyRequest) returns (FetchConnectedGa4PropertyResponse)

為指定的通用 Analytics (分析) 資源查詢已連結的 GA4 資源。注意:這不適用於 GA4 資源。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetAccessBinding(GetAccessBindingRequest) returns (AccessBinding)

取得存取權繫結的相關資訊。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users.readonly
  • https://www.googleapis.com/auth/analytics.manage.users
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

查詢單一帳戶。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetAttributionSettings(GetAttributionSettingsRequest) returns (AttributionSettings)

查詢 AttributionSettings 單例模式。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetAudience(GetAudienceRequest) returns (Audience)

查詢單一目標對象。系統可能無法支援 2020 年以前建立的目標對象。預設目標對像不會顯示篩選器定義。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetCalculatedMetric(GetCalculatedMetricRequest) returns (CalculatedMetric)

查詢單一 CalculatedMetric。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetChannelGroup(GetChannelGroupRequest) returns (ChannelGroup)

查詢單一 ChannelGroup。

授權範圍

需要下列其中一種 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)

查詢單一自訂維度。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetCustomMetric(GetCustomMetricRequest) returns (CustomMetric)

查詢單一自訂指標。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetDataRedactionSettings(GetDataRedactionSettingsRequest) returns (DataRedactionSettings)

查詢單一 DataRedactionSettings。

授權範圍

需要下列其中一種 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
GetDisplayVideo360AdvertiserLinkProposal

rpc GetDisplayVideo360AdvertiserLinkProposal(GetDisplayVideo360AdvertiserLinkProposalRequest) returns (DisplayVideo360AdvertiserLinkProposal)

查詢單一 DisplayVideo360AdvertiserLinkProposal。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetEnhancedMeasurementSettings(GetEnhancedMeasurementSettingsRequest) returns (EnhancedMeasurementSettings)

傳回這個資料串流的加強型評估設定。請注意,串流必須啟用加強型評估,這些設定才會生效。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetEventCreateRule(GetEventCreateRuleRequest) returns (EventCreateRule)

查詢單一 EventCreateRule。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetExpandedDataSet(GetExpandedDataSetRequest) returns (ExpandedDataSet)

查詢單一 ExpandedDataSet。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetGlobalSiteTag(GetGlobalSiteTagRequest) returns (GlobalSiteTag)

傳回指定網頁串流的網站代碼。網站代碼是不可變更的單例模式。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetGoogleSignalsSettings(GetGoogleSignalsSettingsRequest) returns (GoogleSignalsSettings)

查詢資源的 Google 信號設定。

授權範圍

需要下列其中一種 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
GetSKAdNetworkConversionValueSchema

rpc GetSKAdNetworkConversionValueSchema(GetSKAdNetworkConversionValueSchemaRequest) returns (SKAdNetworkConversionValueSchema)

查詢單一 SKAdNetworkConversionValueSchema。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc GetSubpropertyEventFilter(GetSubpropertyEventFilterRequest) returns (SubpropertyEventFilter)

查詢單一子資源的「事件篩選器」。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListAccessBindings(ListAccessBindingsRequest) returns (ListAccessBindingsResponse)

列出帳戶或資源的所有存取權繫結。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users.readonly
  • https://www.googleapis.com/auth/analytics.manage.users
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
ListAudiences

rpc ListAudiences(ListAudiencesRequest) returns (ListAudiencesResponse)

列出資源上的目標對象。系統可能無法支援 2020 年以前建立的目標對象。預設目標對像不會顯示篩選器定義。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListCalculatedMetrics(ListCalculatedMetricsRequest) returns (ListCalculatedMetricsResponse)

列出屬性的 CalculatedMetrics。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListChannelGroups(ListChannelGroupsRequest) returns (ListChannelGroupsResponse)

列出資源的 ChannelGroup。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListConnectedSiteTags(ListConnectedSiteTagsRequest) returns (ListConnectedSiteTagsResponse)

列出通用 Analytics (分析) 資源的已連結的網站代碼。系統最多會傳回 20 個已連結的網站代碼。注意:這不會對 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)

列出資源上的 CustomDimensions。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListCustomMetrics(ListCustomMetricsRequest) returns (ListCustomMetricsResponse)

可列出資源的自訂指標。

授權範圍

需要下列其中一種 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
ListDisplayVideo360AdvertiserLinkProposals

rpc ListDisplayVideo360AdvertiserLinkProposals(ListDisplayVideo360AdvertiserLinkProposalsRequest) returns (ListDisplayVideo360AdvertiserLinkProposalsResponse)

列出資源上的 DisplayVideo360AdvertiserLinkProposals。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListEventCreateRules(ListEventCreateRulesRequest) returns (ListEventCreateRulesResponse)

可列出網站資料串流的 EventCreateRules。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListExpandedDataSets(ListExpandedDataSetsRequest) returns (ListExpandedDataSetsResponse)

可列出屬性上的 ExpandedDataSet。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListKeyEvents(ListKeyEventsRequest) returns (ListKeyEventsResponse)

傳回指定父項屬性中的 Key Event 清單。如果找不到重要事件,則傳回空白清單。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListMeasurementProtocolSecrets(ListMeasurementProtocolSecretsRequest) returns (ListMeasurementProtocolSecretsResponse)

傳回指定父項屬性下的子 MeasurementProtocolSecret。

授權範圍

需要下列其中一種 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
ListSKAdNetworkConversionValueSchemas

rpc ListSKAdNetworkConversionValueSchemas(ListSKAdNetworkConversionValueSchemasRequest) returns (ListSKAdNetworkConversionValueSchemasResponse)

列出串流的 SKAdNetworkConversionValueSchema。屬性最多只能有一個 SKAdNetworkConversionValueSchema。

授權範圍

需要下列其中一種 OAuth 範圍:

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

rpc ListSubpropertyEventFilters(ListSubpropertyEventFiltersRequest) returns (ListSubpropertyEventFiltersResponse)

列出資源的所有子資源事件篩選器。

授權範圍

需要下列其中一種 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 Analytics (分析) 報表資料時,這份報表都會列出記錄。存取記錄最多會保留 2 年。

可要求資源的資料存取報表。系統可能會要求任何資源的報表,但與配額無關的維度,就只能在 Google Analytics (分析) 360 資源中要求。這個方法僅供「管理員」使用。

這些資料存取記錄包括 GA4 UI 報表、GA4 UI 探索、GA4 Data API,以及可透過連結從 Google Analytics (分析) 擷取資料的其他產品 (如 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
SetAutomatedGa4ConfigurationOptOut

rpc SetAutomatedGa4ConfigurationOptOut(SetAutomatedGa4ConfigurationOptOutRequest) returns (SetAutomatedGa4ConfigurationOptOutResponse)

設定通用 Analytics (分析) 資源的自動 GA4 設定程序停用狀態。注意:這不會對 GA4 資源造成任何影響。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateAccessBinding(UpdateAccessBindingRequest) returns (AccessBinding)

更新帳戶或資源的存取權繫結。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.manage.users
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

更新帳戶。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateAttributionSettings(UpdateAttributionSettingsRequest) returns (AttributionSettings)

更新資源的歸因設定。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateAudience(UpdateAudienceRequest) returns (Audience)

更新資源上的目標對象。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateCalculatedMetric(UpdateCalculatedMetricRequest) returns (CalculatedMetric)

更新屬性的 CalculatedMetric。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateChannelGroup(UpdateChannelGroupRequest) returns (ChannelGroup)

更新 ChannelGroup。

授權範圍

需要下列 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)

更新資源的自訂維度。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateCustomMetric(UpdateCustomMetricRequest) returns (CustomMetric)

更新屬性的自訂指標。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateDataRedactionSettings(UpdateDataRedactionSettingsRequest) returns (DataRedactionSettings)

更新資源的 DataRedactionSettings。

授權範圍

需要下列 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
UpdateEnhancedMeasurementSettings

rpc UpdateEnhancedMeasurementSettings(UpdateEnhancedMeasurementSettingsRequest) returns (EnhancedMeasurementSettings)

更新這個資料串流的加強型評估設定。請注意,串流必須啟用加強型評估,這些設定才會生效。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateEventCreateRule(UpdateEventCreateRuleRequest) returns (EventCreateRule)

更新 EventCreateRule。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateExpandedDataSet(UpdateExpandedDataSetRequest) returns (ExpandedDataSet)

更新屬性的 ExpandedDataSet。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateGoogleSignalsSettings(UpdateGoogleSignalsSettingsRequest) returns (GoogleSignalsSettings)

更新資源的 Google 信號設定。

授權範圍

需要下列 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)

更新 Measurement Protocol 密鑰。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateProperty(UpdatePropertyRequest) returns (Property)

更新屬性。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateSKAdNetworkConversionValueSchema(UpdateSKAdNetworkConversionValueSchemaRequest) returns (SKAdNetworkConversionValueSchema)

更新 SKAdNetworkConversionValueSchema。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateSubpropertyEventFilter(UpdateSubpropertyEventFilterRequest) returns (SubpropertyEventFilter)

更新子資源「事件篩選器」。

授權範圍

需要下列 OAuth 範圍:

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

AccessBetweenFilter

表示結果必須介於兩個數字 (含) 之間。

欄位
from_value

NumericValue

以這個數字開頭。

to_value

NumericValue

結尾是這個號碼。

AccessBinding

將使用者繫結至一組角色。

欄位
name

string

僅供輸出。這個繫結的資源名稱。

格式:accounts/{account}/accessBindings/{access_binding} 或 properties/{property}/accessBindings/{access_binding}

例如:「accounts/100/accessBindings/200」

roles[]

string

指定要授予父項資源的角色清單。

有效值:預先定義角色/viewer 預先定義角色/analyst 預先定義的角色/editor 預先定義的角色/admin 預先定義的 Role/no-cost-data 已預先定義角色/no-revenue-data

如果使用者設定空白的角色清單,系統就會刪除這個 AccessBinding。

聯集欄位 access_target。要為哪個目標設定角色。access_target 只能是下列其中一項:
user

string

如有設定,即可設定角色的使用者電子郵件地址。格式:「someuser@gmail.com」

AccessDateRange

連續的日期範圍:startDate、startDate + 1、...、endDate。

欄位
start_date

string

查詢中包含的開始日期,格式為 YYYY-MM-DD。不得晚於 endDate。系統也接受 NdaysAgoyesterdaytoday 格式,在這種情況下,系統會根據要求所在時區的目前時間推斷日期。

end_date

string

查詢中包含的結束日期,格式為 YYYY-MM-DD。不得早於 startDate。系統也接受 NdaysAgoyesterdaytoday 格式,在這種情況下,系統會根據要求所在時區的目前時間推斷日期。

AccessDimension

維度是資料的屬性。舉例來說,userEmail 維度代表存取報表資料的使用者電子郵件。報表回應中的維度值是字串。

欄位
dimension_name

string

維度的 API 名稱。如需這個 API 支援的維度清單,請參閱資料存取架構

維度會以 dimensionFilterorderBys 中的名稱參照。

AccessDimensionHeader

說明報表中的維度欄。報表中要求的維度會在列和 DimensionsHeaders 中產生欄項目。不過,只在篩選器或運算式內使用的維度不會產生報表中的資料欄;也就是說,這些維度不會產生標題。

欄位
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 支援的指標清單,請參閱資料存取架構

指標會以 metricFilterorderBys 中的名稱參照。

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 按萬國碼 (Unicode) 碼點排序的英數字元排序。例如「2」< "A" < "X" < "b" < "z"。
CASE_INSENSITIVE_ALPHANUMERIC 不區分大小寫的英數字元排序,按照小寫的萬國碼 (Unicode) 碼點排序。例如「2」< "A" < "b" < "X" < "z"。
NUMERIC 維度值會先轉換為數字,再排序。例如,以 NUMERIC 排序時,「25」< "100",而 ALPHANUMERIC 排序時,則傳回「100」< "25"。非數字維度值,排序值一律低於所有數值。

MetricOrderBy

依指標值排序。

欄位
metric_name

string

要排序要求中的指標名稱。

AccessQuota

這項 Analytics (分析) 資源所有配額目前的狀態。如果資源的任何配額已用盡,則該資源的所有要求都會傳回「資源用盡」錯誤。

欄位
tokens_per_day

AccessQuotaStatus

資源每天可使用 25 萬個權杖。大多數要求使用的符記數量不到 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% 的權杖。因此,對 Analytics (分析) 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 Analytics (分析) 帳戶的資源訊息。

欄位
name

string

僅供輸出。此帳戶的資源名稱。格式:accounts/{account} 範例:「accounts/100」

create_time

Timestamp

僅供輸出。這個帳戶的最初建立時間。

update_time

Timestamp

僅供輸出。帳戶酬載欄位的上次更新時間。

display_name

string

必要欄位。這個帳戶的顯示名稱。

region_code

string

商家所在國家/地區。必須是 Unicode 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 Analytics (分析) 從我的網站和/或應用程式資源收集到的造訪資訊所建立的關聯資料。」

AcknowledgeUserDataCollectionResponse

這個類型沒有任何欄位。

AcknowledgeUserDataCollection RPC 的回應訊息。

ActionType

可變更資源的動作類型。

列舉
ACTION_TYPE_UNSPECIFIED 不明或未指定動作類型。
CREATED 已在這項變更中建立資源。
UPDATED 已在這項變更中更新資源。
DELETED 資源已在這項變更中刪除。

ActorType

能對 Google Analytics (分析) 資源進行變更的不同發動者。

列舉
ACTOR_TYPE_UNSPECIFIED 不明或未指定的演員類型。
USER 使用者在 actor_email 中指定的使用者所做的變更。
SYSTEM 由 Google Analytics (分析) 系統所做的變更。
SUPPORT Google Analytics (分析) 支援團隊成員所做的變更。

ApproveDisplayVideo360AdvertiserLinkProposalRequest

ApprovalDisplayVideo360AdvertiserLinkProposal RPC 的請求訊息。

欄位
name

string

必要欄位。待核准的 DisplayVideo360AdvertiserLinkProposal 的名稱。格式範例:property/1234/displayVideo360AdvertiserLinkProposals/5678

ApproveDisplayVideo360AdvertiserLinkProposalResponse

ApprovalDisplayVideo360AdvertiserLinkProposal RPC 的回應訊息。

欄位

ArchiveAudienceRequest

ArchiveAudience RPC 的要求訊息。

欄位
name

string

必要欄位。格式範例:Properties/1234/audiences/5678

ArchiveCustomDimensionRequest

ArchiveCustomDimensions RPC 的要求訊息。

欄位
name

string

必要欄位。要封存的自訂維度名稱。格式範例:properties/1234/customDimensions/5678

ArchiveCustomMetricRequest

ArchiveCustomMetric RPC 的要求訊息。

欄位
name

string

必要欄位。要封存的自訂指標名稱。格式範例:properties/1234/customMetrics/5678

AttributionSettings

特定資源使用的歸因設定。這是單例模式資源。

欄位
name

string

僅供輸出。這項歸因設定資源的資源名稱。格式:property/{property_id}/attributionSettings 範例:「properties/1000/attributionSettings」

acquisition_conversion_event_lookback_window

AcquisitionConversionEventLookbackWindow

必要欄位。獲客轉換事件的回溯期設定。回溯期的預設大小為 30 天。

other_conversion_event_lookback_window

OtherConversionEventLookbackWindow

必要欄位。所有其他非獲客轉換事件的回溯期。回溯期的預設大小為 90 天。

reporting_attribution_model

ReportingAttributionModel

必要欄位。此報表歸因模式用於計算這項資源報表中的轉換功勞。

請注意,變更歸因模式會影響歷來資料和未來資料。這些變更會反映在包含轉換和收益資料的報表中。使用者和工作階段資料,則不受影響。

ads_web_conversion_data_export_scope

AdsWebConversionDataExportScope

必要欄位。資料匯出範圍適用於匯出至已連結 Google Ads 帳戶的資料。

AcquisitionConversionEventLookbackWindow

應將多久前的事件納入轉換路徑,進而促成首次安裝應用程式或首次造訪網站。

列舉
ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED 未指定回溯期大小。
ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_7_DAYS 7 天回溯期。
ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS 30 天回溯期。

AdsWebConversionDataExportScope

資料匯出範圍適用於匯出至已連結 Google Ads 帳戶的資料。

列舉
ADS_WEB_CONVERSION_DATA_EXPORT_SCOPE_UNSPECIFIED 預設值。未使用這個值。
NOT_SELECTED_YET 尚未選取任何資料匯出範圍。匯出範圍永遠無法改回這個值。
PAID_AND_ORGANIC_CHANNELS 付費和自然管道都可獲得轉換功勞,但 Google Ads 帳戶只會顯示分配給 Google Ads 管道的功勞。詳情請參閱「付費和自然管道」一文。
GOOGLE_PAID_CHANNELS 只有 Google Ads 付費管道可獲得轉換功勞。詳情請參閱「Google 付費管道」一文。

OtherConversionEventLookbackWindow

對於首次安裝應用程式/首次造訪以外的所有轉換,而言,系統在轉換路徑中應該納入多久前發生的事件。

列舉
OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED 未指定回溯期大小。
OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS 30 天回溯期。
OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_60_DAYS 60 天回溯期。
OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS 90 天回溯期。

ReportingAttributionModel

此報表歸因模式用於計算這項資源報表中的轉換功勞。

列舉
REPORTING_ATTRIBUTION_MODEL_UNSPECIFIED 未指定報表歸因模式。
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN 以數據為準歸因功能會根據每個轉換事件的資料分配轉換功勞。因此每個廣告客戶和轉換事件的以數據為準模式都不太一樣。先前為 CROSS_CHANNEL_DATA_DRIVEN
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK 忽略直接流量,並將 100% 的轉換價值都歸給消費者在完成轉換前點按的最後一個管道 (YouTube 則為互動瀏覽後轉換)。先前為 CROSS_CHANNEL_LAST_CLICK
GOOGLE_PAID_CHANNELS_LAST_CLICK 將 100% 的轉換價值都歸給消費者在完成轉換前點按的最後一個 Google 付費管道。先前為 ADS_PREFERRED_LAST_CLICK

觀眾

代表 GA4 目標對象的資源訊息。

欄位
name

string

僅供輸出。這項 Audience 資源的資源名稱。格式:properties/{propertyId}/audiences/{audienceId}

display_name

string

必要欄位。目標對象的顯示名稱。

description

string

必要欄位。目標對象的說明。

membership_duration_days

int32

必要欄位。不可變動。使用者留在目標對像中的時間長度。不得設為超過 540 天。

ads_personalization_enabled

bool

僅供輸出。對於非個人化廣告目標對象,Google Analytics (分析) 會自動將其設為 false,且不再用於廣告個人化。

event_trigger

AudienceEventTrigger

選用設定。指定使用者加入目標對象時要記錄的事件。如未設定,當使用者加入目標對象時,系統就不會記錄任何事件。

exclusion_duration_mode

AudienceExclusionDurationMode

不可變動。針對符合排除篩選器的使用者,指定排除項目的效期。會套用至所有 EXCLUDE 篩選器子句,且如果「目標對象」中沒有 EXCLUDE 篩選器子句,系統就會忽略這個值。

filter_clauses[]

AudienceFilterClause

必要欄位。不可變動。未排序的清單。定義「目標對象」的篩選器子句。所有子句都會以 AND 結合在一起。

AudienceExclusionDurationMode

針對符合排除篩選器的使用者,指定排除項目的效期。

列舉
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED 未指定。
EXCLUDE_TEMPORARILY 在特定期間,只要使用者符合篩選器子句,就將他們從目標對像中排除。
EXCLUDE_PERMANENTLY 將曾符合篩選器子句的使用者從目標對像中排除。

AudienceDimensionOrMetricFilter

單一維度或指標的專用篩選器。

欄位
field_name

string

必要欄位。不可變動。要篩選的維度名稱或指標名稱。如果欄位名稱參照自訂維度或指標,系統會在自訂維度或指標名稱的前方加上範圍前置字元。如要進一步瞭解範圍前置字元或自訂維度/指標,請參閱 Google Analytics Data API 說明文件

at_any_point_in_time

bool

選用設定。指出這個篩選器是否需要動態評估。如果設為 True,使用者只要滿足條件就會加入目標對象 (靜態評估)。如未設定或設為 False,目標對象評估功能會動態調整,符合條件的使用者加入後,不再符合使用者時移除。

只有在目標對象範圍為 ACROSS_ALL_SESSIONS 時,才能設定這項設定。

in_any_n_day_period

int32

選用設定。設定後,可指定用於評估資料 (以天數為單位) 的時間範圍。如未設定,系統會根據生命週期資料 (例如無限時間範圍) 評估目標對象資料。

例如,如果設為 1 天,系統只會評估當天的資料。參考點是指在 at_any_point_in_time 未設定或設為 false 的當天。

只有在目標對象範圍為 ACROSS_ALL_SESSIONS 時,才能設定鍵/值,而且不能超過 60 天。

聯集欄位 one_filter。以上其中一個篩選器。one_filter 只能是下列其中一項:
string_filter

StringFilter

篩選符合特定模式的字串類型維度。

in_list_filter

InListFilter

符合特定選項清單的字串維度篩選器。

numeric_filter

NumericFilter

用來篩選維度或指標數值或日期值的篩選器。

between_filter

BetweenFilter

用來篩選維度或指標中特定值之間的數值或日期值。

BetweenFilter

用來篩選維度或指標中特定值之間的數值或日期值。

欄位
from_value

NumericValue

必要欄位。以這個數字開頭 (含首尾)。

to_value

NumericValue

必要欄位。結尾是這個數字 (含)。

InListFilter

符合特定選項清單的字串維度篩選器。

欄位
values[]

string

必要欄位。要比對的可能字串值清單。不得空白。

case_sensitive

bool

選用設定。如果為 true,則比對會區分大小寫。如果設為 False,比對時不區分大小寫。

NumericFilter

用來篩選維度或指標數值或日期值的篩選器。

欄位
operation

Operation

必要欄位。套用至數字篩選器的作業。

value

NumericValue

必要欄位。要比對的數字或日期值。

作業

套用至數字篩選器的作業。

列舉
OPERATION_UNSPECIFIED 未指明
EQUAL 等於。
LESS_THAN 小於。
GREATER_THAN 大於。

NumericValue

表示數字。

欄位
聯集欄位 one_value。其中一個數值。one_value 只能是下列其中一項:
int64_value

int64

整數值。

double_value

double

雙精度浮點值。

StringFilter

篩選符合特定模式的字串類型維度。

欄位
match_type

MatchType

必要欄位。字串篩選器的比對類型。

value

string

必要欄位。要比對的字串值。

case_sensitive

bool

選用設定。如果為 true,則比對會區分大小寫。如果設為 False,比對時不區分大小寫。

MatchType

字串篩選器的比對類型。

列舉
MATCH_TYPE_UNSPECIFIED 未指定
EXACT 完全符合字串值。
BEGINS_WITH 以字串值開頭。
ENDS_WITH 以字串值結尾。
CONTAINS 包含字串值。
FULL_REGEXP 完整的規則運算式與字串值相符。

AudienceEventFilter

比對單一事件名稱事件的篩選器。如果指定事件參數,則只有部分事件同時符合單一事件名稱和參數篩選器運算式,才會符合這個事件篩選器。

欄位
event_name

string

必要欄位。不可變動。要比對的事件名稱。

event_parameter_filter_expression

AudienceFilterExpression

選用設定。如有指定,這個篩選器會比對同時符合單一事件名稱和參數篩選運算式的事件。無法在參數篩選器運算式中設定 AudienceEventFilter (例如,不支援巢狀事件篩選器)。這必須是維度_或_metric_filter 或 not_expression 的單一和群組;不支援 OR 的「且」。此外,如果篩選器包含「eventCount」的篩選器,系統只會考慮這個篩選器,並忽略所有其他篩選器。

AudienceEventTrigger

指定使用者加入目標對象時要記錄的事件。

欄位
event_name

string

必要欄位。要記錄的事件名稱。

log_condition

LogCondition

必要欄位。記錄事件的時機。

LogCondition

決定記錄事件的時機。

列舉
LOG_CONDITION_UNSPECIFIED 未指定記錄條件。
AUDIENCE_JOINED 只有在使用者加入時,才應記錄事件。
AUDIENCE_MEMBERSHIP_RENEWED 每次符合目標對象條件時,就算使用者已是目標對象成員,系統仍應記錄這個事件。

AudienceFilterClause

用於定義簡易篩選器或序列篩選器的子句。篩選器可以包含 (例如將符合篩選器子句的使用者納入目標對象) 或排除 (例如將符合篩選器子句的使用者從目標對像中排除)。

欄位
clause_type

AudienceClauseType

必要欄位。指定這是包含或排除篩選器子句。

聯集欄位 filter

filter 只能採用下列其中一種設定:

simple_filter

AudienceSimpleFilter

使用者只要符合這個簡單的篩選器,就能成為目標對象的成員。

sequence_filter

AudienceSequenceFilter

使用者必須按照特定順序建立篩選器,才能成為目標對象成員。

AudienceClauseType

指定這是包含或排除篩選器子句。

列舉
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED 未指定的子句類型。
INCLUDE 如果符合篩選器子句,系統就會將使用者納入目標對象。
EXCLUDE 如果使用者符合篩選器子句,就會從目標對像中排除。

AudienceFilterExpression

目標對象維度、指標或事件篩選器的邏輯運算式。

欄位
聯集欄位 expr。套用至篩選器的運算式。expr 只能是下列其中一項:
and_group

AudienceFilterExpressionList

要結合 AND 的運算式清單。當中只能包含含有 or_group 的 AudienceFilterExpressions,您必須針對頂層 AudienceFilterExpression 設定這個屬性。

or_group

AudienceFilterExpressionList

要結合 OR 的運算式清單。不得包含含有 and_group 或 or_group 的 AudienceFilterExpressions。

not_expression

AudienceFilterExpression

要「NOT」的篩選運算式 (例如反轉、互補)。只能包含維度或「metric_filter」。無法在頂層 AudienceFilterExpression 上設定此屬性。

dimension_or_metric_filter

AudienceDimensionOrMetricFilter

單一維度或指標的篩選器。無法在頂層 AudienceFilterExpression 上設定此屬性。

event_filter

AudienceEventFilter

建立與特定事件相符的篩選器。無法在頂層 AudienceFilterExpression 上設定此屬性。

AudienceFilterExpressionList

目標對象篩選運算式清單。

欄位
filter_expressions[]

AudienceFilterExpression

目標對象篩選運算式清單。

AudienceFilterScope

指定如何評估加入目標對象的使用者。

列舉
AUDIENCE_FILTER_SCOPE_UNSPECIFIED 未指定範圍。
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT 如果在單一事件內符合篩選條件,使用者就會加入目標對象。
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION 如果在單一工作階段中符合篩選條件,使用者就會加入目標對象。
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS 如果任何工作階段的任何事件符合篩選條件,使用者就會加入目標對象。

AudienceSequenceFilter

定義篩選器,使用者須按照特定順序執行,才能成為目標對象成員。

欄位
scope

AudienceFilterScope

必要欄位。不可變動。指定這個篩選器的範圍。

sequence_maximum_duration

Duration

選用設定。定義整個序列必須發生的時間範圍。

sequence_steps[]

AudienceSequenceStep

必要欄位。按照順序排列的步驟順序。使用者必須完成每個步驟,才能加入序列篩選器。

AudienceSequenceStep

這種條件必須符合使用者指定的步驟順序,才能比對序列。

欄位
scope

AudienceFilterScope

必要欄位。不可變動。指定這個步驟的範圍。

immediately_follows

bool

選用設定。如果為 true,完成這個步驟的事件必須是滿足最後一個步驟事件後的下一個事件。如未設定或設為 False,這個步驟會間接跟著前一個步驟;例如,前一個步驟和步驟之間可能會出現事件。第一個步驟會忽略這個欄位。

constraint_duration

Duration

選用設定。設定之後,這個步驟就必須在上一個步驟的 constraint_duration 內 (例如,t[i] - t[i-1] <= constraint_duration)。如未設定,則沒有時間長度限制 (有效無限制)。第一個步驟會忽略這個欄位。

filter_expression

AudienceFilterExpression

必要欄位。不可變動。每個步驟中目標對象維度、指標或事件篩選器的邏輯運算式。

AudienceSimpleFilter

定義一個簡單的篩選器,使用者必須符合條件才能成為目標對象的成員。

欄位
scope

AudienceFilterScope

必要欄位。不可變動。指定這個篩選器的範圍。

filter_expression

AudienceFilterExpression

必要欄位。不可變動。目標對象維度、指標或事件篩選器的邏輯運算式。

BatchCreateAccessBindingsRequest

BatchCreateAccessBindings RPC 的要求訊息。

欄位
parent

string

必要欄位。擁有存取權繫結的帳戶或資源。CreateAccessBindingRequest 訊息中的父項欄位必須為空白,或是與這個欄位相符。格式:-accounts/{account} - 資源/{property}

requests[]

CreateAccessBindingRequest

必要欄位。指定要建立存取權繫結的要求。批次中最多可以建立 1000 個存取權繫結。

BatchCreateAccessBindingsResponse

BatchCreateAccessBindings RPC 的回應訊息。

欄位
access_bindings[]

AccessBinding

已建立存取權繫結。

BatchDeleteAccessBindingsRequest

BatchDeleteAccessBindings RPC 的要求訊息。

欄位
parent

string

必要欄位。擁有存取權繫結的帳戶或資源。在 DeleteAccessBindingRequest 訊息中,「names」欄位提供的所有值的父項必須與這個欄位相符。格式:-accounts/{account} - 資源/{property}

requests[]

DeleteAccessBindingRequest

必要欄位。指定要刪除的存取繫結的要求。批次最多可刪除 1000 個存取權繫結。

BatchGetAccessBindingsRequest

BatchGetAccessBindings RPC 的要求訊息。

欄位
parent

string

必要欄位。擁有存取權繫結的帳戶或資源。您為「names」欄位提供的所有值的父項必須與這個欄位相符。格式:-accounts/{account} - 資源/{property}

names[]

string

必要欄位。要擷取的存取權繫結名稱。批次最多可擷取 1000 個存取權繫結。格式:- accounts/{account}/accessBindings/{accessBinding} -properties/{property}/accessBindings/{accessBinding}

BatchGetAccessBindingsResponse

BatchGetAccessBindings RPC 的回應訊息。

欄位
access_bindings[]

AccessBinding

要求的存取繫結。

BatchUpdateAccessBindingsRequest

BatchUpdateAccessBindings RPC 的要求訊息。

欄位
parent

string

必要欄位。擁有存取權繫結的帳戶或資源。UpdateAccessBindingRequest 訊息中提供的所有 AccessBinding 訊息父項都必須與此欄位相符。格式:-accounts/{account} - 資源/{property}

requests[]

UpdateAccessBindingRequest

必要欄位。指定要更新存取權繫結的要求。批次最多可以更新 1000 個存取權繫結。

BatchUpdateAccessBindingsResponse

BatchUpdateAccessBindings RPC 的回應訊息。

欄位
access_bindings[]

AccessBinding

已更新存取權繫結。

CalculatedMetric

計算指標的定義。

欄位
name

string

僅供輸出。此 CalculatedMetric 的資源名稱。格式:「properties/{property_id}/calculatedMetrics/{calculated_metric_id}」

description

string

選用設定。這個計算指標的說明。長度上限為 4096 個半形字元。

display_name

string

必要欄位。這項計算指標的顯示名稱,如 Google Analytics (分析) UI 所示。長度上限為 82 個半形字元。

calculated_metric_id

string

僅供輸出。計算指標所使用的 ID。在使用者介面中,這稱為「API 名稱」。

從外部 API 參照這個計算指標時,系統會使用 Calculate_metric_id。例如「calcMetric:{calculated_metric_id}」。

metric_unit

MetricUnit

必要欄位。計算指標值的類型。

restricted_metric_type[]

RestrictedMetricType

僅供輸出。這項指標包含的受限資料類型。

formula

string

必要欄位。計算指標的定義。不重複參照的自訂指標數量上限為 5 個。公式支援下列運算:+ (加法)、- (減號)、- (負數)、* (乘號)、/ (除號)、() (括號)。可接受長為長整數 (64 位元整數) 或雙倍 (64 位元浮點數) 的有效實數。範例公式:「( customEvent:parameter_name + cartPurchaseQuantity) / 2.0」

invalid_metric_reference

bool

僅供輸出。如果為 true,這個計算指標包含無效的指標參照。如果使用計算指標的無效_metric_reference 設為 true,可能會失敗、產生警告或產生非預期的結果。

MetricUnit

代表計算指標值的可能類型。

列舉
METRIC_UNIT_UNSPECIFIED 未指定或缺少 MetricUnit。
STANDARD 這項指標使用預設單位。
CURRENCY 這項指標是用於評估貨幣。
FEET 這項指標會測量英尺。
MILES 這項指標會測量英里數。
METERS 這項指標會測量公尺。
KILOMETERS 這項指標會測量公里數。
MILLISECONDS 這項指標測量的是毫秒。
SECONDS 這個指標代表秒。
MINUTES 這項指標會測量分鐘數。
HOURS 這項指標會測量小時數。

RestrictedMetricType

用於標示計算指標資料的標籤,與限制費用和/或收益指標存取權的使用者角色搭配使用。

列舉
RESTRICTED_METRIC_TYPE_UNSPECIFIED 類型不明或未指定。
COST_DATA 「指標」會回報費用資料。
REVENUE_DATA 「指標」會回報收益資料,

CancelDisplayVideo360AdvertiserLinkProposalRequest

針對 cancelDisplayVideo360AdvertiserLinkProposal RPC 的請求訊息。

欄位
name

string

必要欄位。要取消的 DisplayVideo360AdvertiserLinkProposal 的名稱。格式範例:property/1234/displayVideo360AdvertiserLinkProposals/5678

ChangeHistoryChange

單一 Google Analytics (分析) 資源的變更說明。

欄位
resource

string

此項目說明其變更的資源資源名稱。

action

ActionType

變更這項資源的動作類型。

resource_before_change

ChangeHistoryResource

變更前的資源內容。如果這項資源是在這項變更中建立,這個欄位將不會出現。

resource_after_change

ChangeHistoryResource

變更後的資源內容。如果這項資源在這項變更中遭到刪除,這個欄位就會遺漏。

ChangeHistoryResource

變更記錄異動結果前後的資源快照。

欄位

聯集欄位 resource

resource 只能採用下列其中一種設定:

account

Account

變更記錄中的帳戶資源數據匯報。

property

Property

變更記錄中資源資源的數據匯報。

google_signals_settings

GoogleSignalsSettings

變更記錄中的 GoogleSignalsSettings 資源的數據匯報。

conversion_event

ConversionEvent

變更記錄中的 ConversionEvent 資源數據匯報。

measurement_protocol_secret

MeasurementProtocolSecret

變更記錄中的 MeasurementProtocolSecret 資源快照。

custom_dimension

CustomDimension

變更記錄中的自訂維度資源數據匯報。

custom_metric

CustomMetric

變更記錄中的自訂指標資源數據匯報。

data_retention_settings

DataRetentionSettings

變更記錄中的資料保留設定資源的數據匯報。

data_stream

DataStream

變更記錄中的 DataStream 資源數據匯報。

attribution_settings

AttributionSettings

變更記錄中的 AttributionSettings 資源數據匯報。

expanded_data_set

ExpandedDataSet

變更記錄中 ExpandedDataSet 資源的數據匯報。

channel_group

ChannelGroup

變更記錄中的 ChannelGroup 資源數據匯報。

enhanced_measurement_settings

EnhancedMeasurementSettings

變更記錄中的 EnhancedMeasurementSettings 資源數據匯報。

data_redaction_settings

DataRedactionSettings

變更記錄中的 DataRedactionSettings 資源的數據匯報。

skadnetwork_conversion_value_schema

SKAdNetworkConversionValueSchema

變更記錄中的 SKAdNetworkConversionValueSchema 資源快照。

audience

Audience

變更記錄中的目標對象資源數據匯報。

event_create_rule

EventCreateRule

變更記錄中的 EventCreateRule 資源的數據匯報。

calculated_metric

CalculatedMetric

變更記錄中的 CalculatedMetric 資源快照。

ChangeHistoryEvent

造成相同原因的 Google Analytics (分析) 帳戶或其子資源中的一組變更。常見的原因包括在 Google Analytics (分析) 使用者介面中更新、客戶支援服務異動,或是 Google Analytics (分析) 系統自動變更。

欄位
id

string

此變更記錄事件的 ID。這個 ID 在 Google Analytics (分析) 中不會重複。

change_time

Timestamp

變更時間。

actor_type

ActorType

做出此變更的執行者類型。

user_actor_email

string

進行變更的 Google 帳戶電子郵件地址。如果執行者欄位設為 USER,這個有效的電子郵件地址;如果不是,這會空白。已刪除的 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 資源
CUSTOM_DIMENSION 自訂維度資源
CUSTOM_METRIC 自訂指標資源
DATA_RETENTION_SETTINGS DatareservationSettings 資源
DATA_STREAM DataStream 資源
ATTRIBUTION_SETTINGS AttributionSettings 資源
EXPANDED_DATA_SET ExpandedDataSet 資源
CHANNEL_GROUP ChannelGroup 資源
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings 資源
DATA_REDACTION_SETTINGS DataRedactionSettings 資源
SKADNETWORK_CONVERSION_VALUE_SCHEMA SKAdNetworkConversionValueSchema 資源
AUDIENCE 目標對象資源
EVENT_CREATE_RULE EventCreateRule 資源
CALCULATED_METRIC CalculatedMetric 資源

ChannelGroup

代表管道群組的資源訊息。

欄位
name

string

僅供輸出。此管道群組資源的資源名稱。格式:property/{property}/channelGroups/{channel_group}

display_name

string

必要欄位。管道群組的顯示名稱。長度上限為 80 個半形字元。

description

string

管道群組的說明。長度上限為 256 個半形字元。

grouping_rule[]

GroupingRule

必要欄位。管道的分組規則。規則數量上限為 50 個。

system_defined

bool

僅供輸出。如果為 true,這個管道群組就會是 Google Analytics (分析) 預先定義的預設管道群組。無法更新這個管道群組的顯示名稱和分組規則。

primary

bool

選用設定。如果設為「true」,這個管道群組就會做為報表的預設管道群組使用。一次只能將一個管道群組設為「primary」。如果管道群組已設定 primary 欄位,則前一個主要管道群組會取消設定此欄位。

根據預設,Google Analytics (分析) 預先定義的管道群組是主要管道群組。

ChannelGroupFilter

單一維度的專屬篩選器。

欄位
field_name

string

必要欄位。不可變動。要篩選的維度名稱。

聯集欄位 value_filter。定義這個篩選器行為的 StringFilter 或 InListFilter。value_filter 只能是下列其中一項:
string_filter

StringFilter

篩選符合特定模式的字串類型維度。

in_list_filter

InListFilter

符合特定選項清單的字串維度篩選器。

InListFilter

符合特定選項清單的字串維度篩選器。比對時不區分大小寫。

欄位
values[]

string

必要欄位。要比對的可能字串值清單。不得空白。

StringFilter

篩選欄位值為字串時。比對時不區分大小寫。

欄位
match_type

MatchType

必要欄位。字串篩選器的比對類型。

value

string

必要欄位。要比對的字串值。

MatchType

使用篩選器判斷相符項目的方式。

列舉
MATCH_TYPE_UNSPECIFIED 預設比對類型。
EXACT 完全符合字串值。
BEGINS_WITH 以字串值開頭。
ENDS_WITH 以字串值結尾。
CONTAINS 包含字串值。
FULL_REGEXP 與字串值完全相符的規則運算式。
PARTIAL_REGEXP 部分規則運算式與字串值相符。

ChannelGroupFilterExpression

管道群組維度篩選器的邏輯運算式。

欄位
聯集欄位 expr。套用至篩選器的運算式。expr 只能是下列其中一項:
and_group

ChannelGroupFilterExpressionList

要結合 AND 的運算式清單。只能包含具有 or_group 的 ChannelGroupFilterExpressions。這項設定必須在頂層 ChannelGroupFilterExpression 中設定。

or_group

ChannelGroupFilterExpressionList

要結合 OR 的運算式清單。但不能包含具有 and_group 或 or_group 的 ChannelGroupFilterExpressions。

not_expression

ChannelGroupFilterExpression

要「不」的篩選運算式 (以反轉、互補)。只能包含維度或「metric_filter」。無法在頂層 ChannelGroupFilterExpression 中設定,

filter

ChannelGroupFilter

單一維度的篩選器。無法在頂層 ChannelGroupFilterExpression 中設定,

ChannelGroupFilterExpressionList

管道群組篩選運算式清單。

欄位
filter_expressions[]

ChannelGroupFilterExpression

管道群組篩選運算式清單。

CoarseValue

在滿足 ConversionValues.event_mappings 條件時,在 updatePostbackConversionValue SDK 呼叫中設定的轉換價值。詳情請參閱 SKAdNetwork.CoarseConversionValue

列舉
COARSE_VALUE_UNSPECIFIED 未指定粗略值。
COARSE_VALUE_LOW 低估值。
COARSE_VALUE_MEDIUM 中等值的粗估值。
COARSE_VALUE_HIGH 粗略值。

ConnectedSiteTag

某個已連結的網站代碼設定。

欄位
display_name

string

必要欄位。使用者為已連結的網站代碼提供的顯示名稱。且須少於 256 個字元。

tag_id

string

必要欄位。"將事件轉送至所需的代碼 ID。又稱為評估 ID 或「G-ID」(例如:G-12345)。

ConversionEvent

Google Analytics (分析) 資源中的轉換事件。

欄位
name

string

僅供輸出。這個轉換事件的資源名稱。格式:property/{property}/conversionEvents/{conversion_event}

event_name

string

不可變動。這個轉換事件的事件名稱。例如:「點擊」、「購買」

create_time

Timestamp

僅供輸出。在資源中建立這個轉換事件的時間。

deletable

bool

僅供輸出。設定後,目前只能使用 DeleteConversionEvent 刪除這個事件。

custom

bool

僅供輸出。如果設為 True,這個轉換事件就會參照自訂事件。如果設為 False,這個轉換事件會在 Google Analytics (分析) 中代表預設事件。預設事件在 Google Analytics (分析) 中通常具有特殊意義。預設事件通常是由 Google Analytics (分析) 系統建立,但在某些情況下,資源管理員可以建立預設事件。自訂事件會計入每個資源可建立的自訂轉換事件數量上限。

counting_method

ConversionCountingMethod

選用設定。計算工作階段中多個事件時,計算轉換的方法。如未提供這個值,系統會設為 ONCE_PER_EVENT

default_conversion_value

DefaultConversionValue

選用設定。定義轉換事件的預設價值/貨幣。

ConversionCountingMethod

計算工作階段中多個事件時,計算轉換的方法。

列舉
CONVERSION_COUNTING_METHOD_UNSPECIFIED 未指定計數方法。
ONCE_PER_EVENT 每個事件事件都視為一次轉換。
ONCE_PER_SESSION 在每位使用者的每個工作階段中,事件例項最多只會視為一次轉換。

DefaultConversionValue

定義轉換事件的預設價值/貨幣。您必須提供金額和幣別。

欄位
value

double

系統會使用這個值,為指定的 event_name 填入值 (未設定事件「value」參數)。

currency_code

string

如果這個 event_name 的轉換事件尚未設定貨幣,系統將套用這個幣別做為預設幣別。必須採用 ISO 4217 貨幣代碼格式,詳情請參閱 https://en.wikipedia.org/wiki/ISO_4217

ConversionValues

SKAdNetwork 轉換價值結構定義的回傳期轉換價值設定。

欄位
display_name

string

SKAdNetwork 轉換價值的顯示名稱。顯示名稱的長度上限為 50 個 UTF-16 代碼單位。

coarse_value

CoarseValue

必要欄位。概略的轉換價值。

這個值不保證不會重複。

event_mappings[]

EventMapping

要達成此轉換價值的事件條件。這份清單中的條件會以「AND」結合起來。如果啟用了回傳期,最少必須包含 1 個項目,最多 3 個項目。

lock_enabled

bool

如果為 true,SDK 應在目前的回傳期內鎖定這個轉換價值。

fine_value

int32

精細的轉換價值。這僅適用於第一個回傳期。有效值為 [0,63] (含頭尾)。必須為回傳期 1 設定,不得為回傳期 2 和 3 設定。這個值不保證不會重複。

如果將第一個回傳期的設定重複用於第二或第三個回傳期,則這個欄位不會有任何作用。

CreateAccessBindingRequest

CreateAccessBinding RPC 的要求訊息。

欄位
parent

string

必要欄位。格式:-accounts/{account} - 資源/{property}

access_binding

AccessBinding

必要欄位。要建立的存取權繫結。

CreateAdSenseLinkRequest

要求訊息傳遞至 CreateAdSenseLink 方法。

欄位
parent

string

必要欄位。要建立 AdSense 連結的資源。格式:properties/{propertyId} 範例:properties/1234

CreateAudienceRequest

CreateAudience RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

audience

Audience

必要欄位。要建立的目標對象。

CreateCalculatedMetricRequest

CreateCalculatedMetric RPC 的要求訊息。

欄位
parent

string

必要欄位。格式:properties/{property_id} 範例:properties/1234

calculated_metric_id

string

必要欄位。用於計算指標的 ID,將成為計算指標資源名稱的最後一項元件。

這個值應為 1 至 80 個字元,有效的字元數為 /[a-zA-Z0-9_]/,不得使用空格。Calculate_metric_id 在資源下的所有計算指標中不得重複。計算來自外部 API 的計算指標時,系統會使用 Calculate_metric_id。舉例來說,「calcMetric:{calculated_metric_id}」。

calculated_metric

CalculatedMetric

必要欄位。要建立的 CalculatedMetric。

CreateChannelGroupRequest

CreateChannelGroup 遠端程序呼叫 (RPC) 要求訊息。

欄位
parent

string

必要欄位。要建立 ChannelGroup 的資源。格式範例:properties/1234

channel_group

ChannelGroup

必要欄位。要建立的管道群組。

CreateConnectedSiteTagRequest

CreateConnectedSiteTag RPC 的要求訊息。

欄位
property

string

用來建立已連結的網站代碼的通用 Analytics (分析) 資源。這個 API 不支援 GA4 資源。格式:properties/{universalAnalyticsPropertyId} 範例:properties/1234

connected_site_tag

ConnectedSiteTag

必要欄位。要加進通用 Analytics (分析) 資源的代碼

CreateConnectedSiteTagResponse

這個類型沒有任何欄位。

CreateConnectedSiteTag RPC 的回應訊息。

CreateConversionEventRequest

CreateConversionEvent RPC 的要求訊息

欄位
conversion_event

ConversionEvent

必要欄位。要建立的轉換事件。

parent

string

必要欄位。要建立這個轉換事件的父項資源的資源名稱。格式:properties/123

CreateCustomDimensionRequest

CreateCustomDimensions RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

custom_dimension

CustomDimension

必要欄位。要建立的自訂維度。

CreateCustomMetricRequest

CreateCustomMetric RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

custom_metric

CustomMetric

必要欄位。要建立的自訂指標。

CreateDataStreamRequest

CreateDataStream RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

data_stream

DataStream

必要欄位。要建立的 DataStream。

CreateDisplayVideo360AdvertiserLinkProposalRequest

CreateDisplayVideo360AdvertiserLinkProposal RPC 的請求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

CreateDisplayVideo360AdvertiserLinkRequest

CreateDisplayVideo360AdvertiserLink RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

CreateEventCreateRuleRequest

CreateEventCreateRule RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/123/dataStreams/456

event_create_rule

EventCreateRule

必要欄位。要建立的 EventCreateRule。

CreateExpandedDataSetRequest

CreateExpandedDataSet RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

expanded_data_set

ExpandedDataSet

必要欄位。要建立的展開資料集。

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

必要欄位。要建立的 Measurement Protocol 密鑰。

CreatePropertyRequest

CreateProperty RPC 的要求訊息。

欄位
property

Property

必要欄位。要建立的屬性。注意:提供的屬性必須指定其父項。

CreateRollupPropertyRequest

CreateRollupProperty RPC 的要求訊息。

欄位
rollup_property

Property

必要欄位。要建立的綜覽資源。

source_properties[]

string

選用設定。資源名稱,是已建立的綜覽資源來源的資源。

CreateRollupPropertyResponse

CreateRollupProperty RPC 的回應訊息。

欄位
rollup_property

Property

已建立的綜覽資源。

CreateRollupPropertySourceLinkRequest

CreateRollupPropertySourceLink RPC 的要求訊息。

欄位
parent

string

必要欄位。格式:properties/{property_id} 範例:properties/1234

CreateSKAdNetworkConversionValueSchemaRequest

CreateSKAdNetworkConversionValueSchema RPC 的要求訊息。

欄位
parent

string

必要欄位。要建立這個結構定義的父項資源。格式:properties/{property}/dataStreams/{dataStream}

skadnetwork_conversion_value_schema

SKAdNetworkConversionValueSchema

必要欄位。要建立的 SKAdNetwork 轉換價值結構定義。

CreateSearchAds360LinkRequest

CreateSearchAds360Link RPC 要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

CreateSubpropertyEventFilterRequest

CreateSubpropertyEventFilter RPC 的要求訊息。

欄位
parent

string

必要欄位。要建立子資源事件篩選器的一般資源。格式:properties/property_id 範例:properties/123

subproperty_event_filter

SubpropertyEventFilter

必要欄位。要建立的子資源事件篩選器。

CreateSubpropertyRequest

CreateSubproperty RPC 的要求訊息。

欄位
parent

string

必要欄位。要建立子資源的一般資源。格式:properties/property_id 範例:properties/123

subproperty

Property

必要欄位。要建立的子資源。

subproperty_event_filter

SubpropertyEventFilter

選用設定。在一般資源上建立的子資源事件篩選器。

CreateSubpropertyResponse

CreateSubproperty RPC 的回應訊息。

欄位
subproperty

Property

已建立的子資源。

subproperty_event_filter

SubpropertyEventFilter

已建立的子資源事件篩選器。

CustomDimension

自訂維度的定義。

欄位
name

string

僅供輸出。這項自訂維度資源的資源名稱。格式:properties/{property}/customDimensions/{customDimension}

parameter_name

string

必要欄位。不可變動。這個自訂維度的代碼參數名稱。

如果是以使用者為範圍的維度,這會是使用者屬性名稱。如果這是以事件為範圍的維度,則會是事件參數名稱。

如果是以商品為範圍的維度,這就是電子商務項目陣列中的參數名稱。

只能使用英數字元和底線字元,開頭須為英文字母。以使用者為範圍的維度長度上限為 24 個字元;以事件為範圍的維度長度上限為 40 個字元。

display_name

string

必要欄位。此自訂維度的顯示名稱 (如 Analytics (分析) 使用者介面所示)。長度上限為 82 個英數字元、空格和底線,且開頭須為英文字母。舊版系統產生的顯示名稱可包含方括號,但這個欄位的更新內容一律不允許使用方括號。

description

string

選用設定。這個自訂維度的說明。長度上限為 150 個半形字元。

scope

DimensionScope

必要欄位。不可變動。這個維度的範圍。

disallow_ads_personalization

bool

選用設定。如果設為 True,請將這個維度設為非個人化廣告,並從廣告個人化中排除。

目前只有以使用者為範圍的自訂維度支援這項功能。

DimensionScope

這個維度範圍的有效值。

列舉
DIMENSION_SCOPE_UNSPECIFIED 範圍不明或未指定。
EVENT 範圍限定為事件的維度。
USER 維度範圍僅限使用者。
ITEM 範圍僅限電子商務項目的維度

CustomMetric

自訂指標的定義。

欄位
name

string

僅供輸出。這項自訂指標資源的資源名稱。格式:properties/{property}/customMetrics/{customMetric}

parameter_name

string

必要欄位。不可變動。此自訂指標的標記名稱。

如果這是以事件為範圍的指標,這就是事件參數名稱。

只能使用英數字元和底線字元,開頭須為英文字母。以事件為範圍的指標長度上限為 40 個半形字元。

display_name

string

必要欄位。這項自訂指標的顯示名稱,如 Analytics (分析) 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 「指標」會回報收益資料,

DataRedactionSettings

用戶端資料遮蓋設定。網站串流下的單例模式資源。

欄位
name

string

僅供輸出。這項資料遮蓋設定資源的名稱。格式:property/{property_id}/dataStreams/{data_stream}/dataRedactionSettings 範例:「properties/1000/dataStreams/2000/dataRedactionSettings」

email_redaction_enabled

bool

如果啟用,系統就會遮蓋任何像電子郵件的事件參數或使用者屬性值。

query_parameter_redaction_enabled

bool

如果查詢參數位於已設定的查詢參數組合,系統會遮蓋查詢參數的鍵和值部分。

如果啟用這項設定,系統將針對串流執行網址查詢替換邏輯。系統會遮蓋 query_parameter_keys 中定義的所有查詢參數。

query_parameter_keys[]

string

如果網址中出現遮蓋邏輯,則要套用遮蓋邏輯的查詢參數鍵。查詢參數比對不區分大小寫。

如果 query_parameter_replacement_enabled 為 true,則必須包含至少一個元素。鍵不得包含半形逗號。

DataRetentionSettings

資料保留的設定值。這是單例模式資源。

欄位
name

string

僅供輸出。這項 DatareservationSetting 資源的資源名稱。格式:property/{property}/datareservationSettings

event_data_retention

RetentionDuration

事件層級資料保留的時間長度。

reset_user_data_on_new_activity

bool

如果設為「true」,系統會重設該使用者每個事件的使用者 ID 保留期限。

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 Analytics (分析) 帳戶資料共用設定的資源訊息。

欄位
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 (如果有的話)。如果 Android 應用程式遭到刪除並重新建立,這組 ID 可能會改變。

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 (如果有的話)。如果 iOS 應用程式遭到刪除並重新建立,這組 ID 可能會改變。

bundle_id

string

必要欄位。不可變動。應用程式的 Apple App Store 套件 ID,例如:「com.example.myiosapp」

WebStreamData

網頁串流專屬資料。

欄位
measurement_id

string

僅供輸出。Analytics (分析) 評估 ID。

例如:「G-1A2BCD345E」

firebase_app_id

string

僅供輸出。Firebase 中相應網頁應用程式的 ID (如果有的話)。如果刪除並重新建立網頁應用程式,這個 ID 可能會改變。

default_uri

string

受評估網頁應用程式的網域名稱,或空白。例如:「http://www.google.com」、「https://www.google.com」

DeleteAccessBindingRequest

DeleteAccessBinding RPC 的要求訊息。

欄位
name

string

必要欄位。格式:- accounts/{account}/accessBindings/{accessBinding} -properties/{property}/accessBindings/{accessBinding}

DeleteAccountRequest

DeleteAccount RPC 的要求訊息。

欄位
name

string

必要欄位。要虛刪除的帳戶名稱。格式:accounts/{account} 範例:「accounts/100」

DeleteAdSenseLinkRequest

要求訊息要傳送至 DeleteAdSenseLink 方法。

欄位
name

string

必要欄位。要刪除的 AdSense 連結專屬 ID。格式:property/{propertyId}/adSenseLinks/{linkId} 範例:properties/1234/adSenseLinks/5678

DeleteCalculatedMetricRequest

DeleteCalculatedMetric RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 CalculatedMetric 名稱。格式:properties/{property_id}/calculatedMetrics/{calculated_metric_id} 範例:properties/1234/calculatedMetrics/Metric01

DeleteChannelGroupRequest

DeleteChannelGroup RPC 要求訊息。

欄位
name

string

必要欄位。要刪除的管道群組。格式範例:properties/1234/channelGroups/5678

DeleteConnectedSiteTagRequest

DeleteConnectedSiteTag RPC 的要求訊息。

欄位
property

string

要刪除已連結網站代碼的通用 Analytics (分析) 資源。這個 API 不支援 GA4 資源。格式:properties/{universalAnalyticsPropertyId} 範例:properties/1234

tag_id

string

要轉寄事件的代碼 ID。又稱為評估 ID 或「G-ID」(例如:G-12345)。

DeleteConversionEventRequest

DeleteConversionEvent RPC 的要求訊息

欄位
name

string

必要欄位。要刪除的轉換事件資源名稱。格式:properties/{property}/conversionEvents/{conversion_event} 範例:「properties/123/conversionEvents/456」

DeleteDataStreamRequest

DeleteDataStream RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 DataStream 名稱。格式範例:properties/1234/dataStreams/5678

DeleteDisplayVideo360AdvertiserLinkProposalRequest

DeleteDisplayVideo360AdvertiserLinkProposal RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 DisplayVideo360AdvertiserLinkProposal 的名稱。格式範例:property/1234/displayVideo360AdvertiserLinkProposals/5678

DeleteDisplayVideo360AdvertiserLinkRequest

DeleteDisplayVideo360AdvertiserLink RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 DisplayVideo360AdvertiserLink 名稱。格式範例:properties/1234/displayVideo360AdvertiserLinks/5678

DeleteEventCreateRuleRequest

DeleteEventCreateRule RPC 的要求訊息。

欄位
name

string

必要欄位。格式範例:properties/123/dataStreams/456/eventCreateRules/789

DeleteExpandedDataSetRequest

DeleteExpandedDataSet RPC 的要求訊息。

欄位
name

string

必要欄位。格式範例:properties/1234/expandedDataSets/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」

DeleteRollupPropertySourceLinkRequest

DeleteRollupPropertySourceLink RPC 的要求訊息。

欄位
name

string

必要欄位。格式:properties/{property_id}/rollupPropertySourceLinks/{rollup_property_source_link_id} 範例:properties/1234/rollupPropertySourceLinks/5678

DeleteSKAdNetworkConversionValueSchemaRequest

DeleteSKAdNetworkConversionValueSchema RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 SKAdNetworkConversionValueSchema 名稱。格式:properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema/{skadnetwork_conversion_value_schema}

DeleteSearchAds360LinkRequest

DeleteSearchAds360Link RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的 SearchAds360 連結名稱。格式範例:property/1234/SearchAds360Links/5678

DeleteSubpropertyEventFilterRequest

DeleteSubpropertyEventFilter RPC 的要求訊息。

欄位
name

string

必要欄位。要刪除的子資源事件篩選器的資源名稱。格式:properties/property_id/subpropertyEventFilters/subproperty_event_filter 範例:properties/123/subpropertyEventFilters/456

DisplayVideo360AdvertiserLinkProposal

在 GA4 資源與 Display & Video 360 廣告主之間連結的提案。

提案一經核准,就會轉換為 DisplayVideo360AdvertiserLink。Google Analytics (分析) 管理員核准傳入提案,而 Display & Video 360 管理員核准出外提案。

欄位
name

string

僅供輸出。此 DisplayVideo360AdvertiserLinkProposal 資源的資源名稱。格式:property/{propertyId}/displayVideo360AdvertiserLinkProposals/{proposalId}

注意:提案 ID 不是 Display & Video 360 廣告主 ID

advertiser_id

string

不可變動。Display & Video 360 廣告主的廣告主 ID。

advertiser_display_name

string

僅供輸出。Display & Video 360 廣告主的顯示名稱。只會針對源自 Display & Video 360 的提案填入資料。

validation_email

string

僅限輸入。在傳送至 Display & Video 360 的提案中,這個欄位必須設為目標廣告客戶管理員的電子郵件地址。這是為了確認 Google Analytics (分析) 管理員是否知道該 Display & Video 360 廣告客戶的至少一位管理員。這不會限制只有單一使用者能取得提案。任何 Display & Video 360 廣告主的管理員都可以核准提案。

ads_personalization_enabled

BoolValue

不可變動。在這次整合中啟用個人化廣告功能。如果建立時未設定這個欄位,系統會將這個欄位預設為 true。

campaign_data_sharing_enabled

BoolValue

不可變動。啟用從 Display & Video 360 匯入廣告活動資料的功能。如果建立時未設定這個欄位,系統會將這個欄位預設為 true。

cost_data_sharing_enabled

BoolValue

不可變動。啟用從 Display & Video 360 匯入費用資料的功能。您必須先啟用 campaign_data_sharing_enabled,才能啟用這個選項。如果建立時未設定這個欄位,系統會將這個欄位預設為 true。

EnhancedMeasurementSettings

網站 DataStream 下的單例模式資源,設定額外網站互動和內容的評估。

欄位
name

string

僅供輸出。加強型評估設定的資源名稱。格式:property/{property_id}/dataStreams/{data_stream}/enhancedMeasurementSettings 範例:「properties/1000/dataStreams/2000/enhancedMeasurementSettings」

stream_enabled

bool

表示是否將加強型評估設定用於自動評估此網站串流上的互動和內容。

變更這個值不會影響設定本身,但會決定是否要遵循設定。

scrolls_enabled

bool

啟用後,在每次訪客瀏覽到網頁底部時,擷取捲動事件。

outbound_clicks_enabled

bool

啟用後,每次訪客按下會將他們從目前網域帶離的連結時,即記錄一次外連點擊事件。

site_search_enabled

bool

如果啟用這個選項,系統會在每次訪客在您的網站上執行搜尋 (根據查詢參數) 時,擷取瀏覽搜尋結果事件。

video_engagement_enabled

bool

如果啟用,即可在訪客觀看網站上內嵌的影片時,擷取影片播放、進度和完整事件。

file_downloads_enabled

bool

如果啟用此功能,則每次具有一般文件、壓縮檔、應用程式、影片或音訊副檔名的連結獲得點擊時,即擷取檔案下載事件。

page_changes_enabled

bool

啟用後,每次網站變更瀏覽器記錄狀態,系統就會記錄一次網頁瀏覽事件。

form_interactions_enabled

bool

啟用後,每當訪客與網站上的表單互動,系統就會記錄表單互動事件。預設為 False。

search_query_parameter

string

必要欄位。要解讀為站內搜尋參數的網址查詢參數。長度上限為 1,024 個字元。欄位不得留空。

uri_query_parameter

string

其他網址查詢參數。長度上限為 1,024 個字元。

EventCreateRule

「事件建立規則」用來定義條件,可根據來源事件的相符條件觸發全新事件的建立作業。可以定義來源事件中的其他參數異動事件。

與「事件編輯」規則不同的是,事件建立規則未定義順序。這些 API 會各自獨立執行。

「事件編輯」和「事件建立」規則無法用來修改透過「事件建立」規則建立的事件。

欄位
name

string

僅供輸出。這項 EventCreateRule 資源的資源名稱。格式:properties/{property}/dataStreams/{data_stream}/eventCreateRules/{event_create_rule}

destination_event

string

必要欄位。要建立的新事件名稱,

這個值必須:* 小於 40 個半形字元 * 只能包含英文字母、數字或 _ (底線) * 開頭須為英文字母

event_conditions[]

MatchingCondition

必要欄位。至少須設定一個條件,且最多不得超過 10 個。來源事件的條件必須相符,系統才會套用這項規則。

source_copy_parameters

bool

若為 true,來源參數就會複製到新事件。如果設為 False 或未設定,系統就不會從來源事件複製所有非內部參數。系統會在複製參數後套用參數異動。

parameter_mutations[]

ParameterMutation

參數異動會定義新事件的參數行為,並依序套用。最多可以套用 20 個異動。

EventMapping

用於比對事件的事件設定條件。

欄位
event_name

string

必要欄位。GA4 事件的名稱。請務必設定。顯示名稱的長度上限為 40 個 UTF-16 代碼單位。

min_event_count

int64

必須設定下列四個最小值/最大值中的其中一個。系統會將設定的值以 AND 結合在一起,以便評估事件。事件發生次數下限。如果未設定,系統就不會檢查事件計數下限。

max_event_count

int64

事件發生次數的最大值。如未設定,系統就不會檢查事件數量上限。

min_event_value

double

因為事件產生的最低收益。系統會在資源層級定義收益幣別。如果未設定,系統就不會檢查最低事件價值。

max_event_value

double

透過事件產生的最高收益。系統會在資源層級定義收益幣別。如果未設定,系統就不會檢查事件價值上限。

ExpandedDataSet

代表 GA4ExpandedDataSet 的資源訊息。

欄位
name

string

僅供輸出。此 ExpandedDataSet 資源的資源名稱。格式:properties/{property_id}/expandedDataSets/{expanded_data_set}

display_name

string

必要欄位。StartedDataSet 的顯示名稱。最多 200 個字元。

description

string

選用設定。OpenedDataSet 的說明。最多 50 個半形字元。

dimension_names[]

string

不可變動。OpenedDataSet 中包含的維度清單。如需維度名稱清單,請參閱 API 維度

metric_names[]

string

不可變動。OpenedDataSet 中包含的指標清單。如要查看維度名稱清單,請參閱 API 指標

dimension_filter_expression

ExpandedDataSetFilterExpression

不可變動。套用至 ExpandedDataSet 中維度的 ExpandedDataSet 篩選器邏輯運算式。這個篩選器用於減少列數,因此可能會發生 other 列。

data_collection_start_time

Timestamp

僅供輸出。展開資料集開始 (或開始) 收集資料的時間。

ExpandedDataSetFilter

單一維度的專屬篩選器

欄位
field_name

string

必要欄位。要篩選的維度名稱。

聯集欄位 one_filter。以上其中一個篩選器。one_filter 只能是下列其中一項:
string_filter

StringFilter

篩選符合特定模式的字串類型維度。

in_list_filter

InListFilter

符合特定選項清單的字串維度篩選器。

InListFilter

符合特定選項清單的字串維度篩選器。

欄位
values[]

string

必要欄位。要比對的可能字串值清單。不得空白。

case_sensitive

bool

選用設定。如果為 true,則比對會區分大小寫。如果設為 False,比對時不區分大小寫。必須為 true。

StringFilter

篩選符合特定模式的字串類型維度。

欄位
match_type

MatchType

必要欄位。字串篩選器的比對類型。

value

string

必要欄位。要比對的字串值。

case_sensitive

bool

選用設定。如果為 true,則比對會區分大小寫。如果設為 False,比對時不區分大小寫。當 match_type 為 EXACT 時,必須為 true。當 match_type 為 CONTAINS 時,必須為 false。

MatchType

字串篩選器的比對類型。

列舉
MATCH_TYPE_UNSPECIFIED 未指定
EXACT 完全符合字串值。
CONTAINS 包含字串值。

ExpandedDataSetFilterExpression

EnhancedDataSet 維度篩選器的邏輯運算式。

欄位
聯集欄位 expr。套用至篩選器的運算式。expr 只能是下列其中一項:
and_group

ExpandedDataSetFilterExpressionList

要結合 AND 的運算式清單。其中包含的 StartedDataSetFilterExpression 必須採用 not_expression 或 dimension_filter。必須為頂層 ExpandedDataSetFilterExpression 設定。

not_expression

ExpandedDataSetFilterExpression

要「不」的篩選運算式 (也就是反轉、互補)。必須包含維度_filter。無法在頂層 ExpandedDataSetFilterExpression 上設定這項設定。

filter

ExpandedDataSetFilter

單一維度的篩選器。無法在頂層 ExpandedDataSetFilterExpression 上設定這項設定。

ExpandedDataSetFilterExpressionList

StartedDataSet 篩選器運算式清單。

欄位
filter_expressions[]

ExpandedDataSetFilterExpression

StartedDataSet 篩選器運算式清單。

FetchAutomatedGa4ConfigurationOptOutRequest

要求擷取自動 GA4 設定程序的停用狀態。

欄位
property

string

必要欄位。通用 Analytics (分析) 資源則會顯示「選擇拒絕」狀態。請注意,這項要求會使用內部資源 ID,而非 UA-XXXXXX-YY 格式的追蹤 ID。格式:property/{internalWebPropertyId}範例:properties/1234

FetchAutomatedGa4ConfigurationOptOutResponse

擷取自動 GA4 設定程序退出狀態的回應訊息。

欄位
opt_out

bool

通用 Analytics (分析) 資源的停用狀態。

FetchConnectedGa4PropertyRequest

要求查詢已連結至通用 Analytics (分析) 資源的 GA4 資源。

欄位
property

string

必要欄位。用於查詢已連結 GA4 資源的通用 Analytics (分析) 資源。請注意,這項要求會使用內部資源 ID,而非 UA-XXXXXX-YY 格式的追蹤 ID。格式:properties/{internal_web_property_id} 範例:property/1234

FetchConnectedGa4PropertyResponse

回覆查詢已連結通用 Analytics (分析) 資源的 GA4 資源。

欄位
property

string

已連結至通用 Analytics (分析) 資源的 GA4 資源。沒有已連結的 GA4 資源時,系統會傳回空字串。格式:properties/{property_id} 範例:properties/1234

GetAccessBindingRequest

GetAccessBinding RPC 的要求訊息。

欄位
name

string

必要欄位。要擷取的存取權繫結名稱。格式:- accounts/{account}/accessBindings/{accessBinding} -properties/{property}/accessBindings/{accessBinding}

GetAccountRequest

GetAccount RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的帳戶名稱。格式:accounts/{account} 範例:「accounts/100」

GetAdSenseLinkRequest

要求訊息以便傳遞至 GetAdSenseLink 方法。

欄位
name

string

必要欄位。所請求 AdSense 連結的專屬 ID。格式:properties/{propertyId}/adSenseLinks/{linkId} 範例:properties/1234/adSenseLinks/5678

GetAttributionSettingsRequest

GetAttributionSettings RPC 的要求訊息。

欄位
name

string

必要欄位。要擷取的歸因設定名稱。格式:property/{property}/attributionSettings

GetAudienceRequest

GetAudience RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的目標對象名稱。格式範例:Properties/1234/audiences/5678

GetBigQueryLinkRequest

GetBigQueryLink RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的 BigQuery 連結名稱。格式:properties/{property_id}/bigQueryLinks/{bigquery_link_id} 範例:properties/123/bigQueryLinks/456

GetCalculatedMetricRequest

GetCalculatedMetric RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 CalculatedMetric 名稱。格式:properties/{property_id}/calculatedMetrics/{calculated_metric_id} 範例:properties/1234/calculatedMetrics/Metric01

GetChannelGroupRequest

GetChannelGroup RPC 要求訊息。

欄位
name

string

必要欄位。要取得的管道群組。格式範例:properties/1234/channelGroups/5678

GetConversionEventRequest

GetConversionEvent RPC 的要求訊息

欄位
name

string

必要欄位。要擷取的轉換事件資源名稱。格式:properties/{property}/conversionEvents/{conversion_event} 範例:「properties/123/conversionEvents/456」

GetCustomDimensionRequest

GetCustomDimensions RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的自訂維度名稱。格式範例:properties/1234/customDimensions/5678

GetCustomMetricRequest

GetCustomMetric RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的自訂指標名稱。格式範例:properties/1234/customMetrics/5678

GetDataRedactionSettingsRequest

GetDataRedactionSettings RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的設定名稱。格式:properties/{property}/dataStreams/{data_stream}/dataRedactionSettings 範例:「properties/1000/dataStreams/2000/dataRedactionSettings」

GetDataRetentionSettingsRequest

GetDatakeepSettings RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的設定名稱。格式:properties/{property}/dataRekeepSettings 範例:「properties/1000/data 資料保留設定」

GetDataSharingSettingsRequest

GetData 共享 Settings RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的設定名稱。格式:accounts/{account}/dataSharingSettings 範例:「accounts/1000/dataSharingSettings」

GetDataStreamRequest

GetDataStream RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 DataStream 名稱。格式範例:properties/1234/dataStreams/5678

GetDisplayVideo360AdvertiserLinkProposalRequest

GetDisplayVideo360AdvertiserLinkProposal RPC 的請求訊息。

欄位
name

string

必要欄位。要取得的 DisplayVideo360AdvertiserLinkProposal 的名稱。格式範例:property/1234/displayVideo360AdvertiserLinkProposals/5678

GetDisplayVideo360AdvertiserLinkRequest

GetDisplayVideo360AdvertiserLink RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 DisplayVideo360AdvertiserLink 名稱。格式範例:properties/1234/displayVideo360AdvertiserLink/5678

GetEnhancedMeasurementSettingsRequest

GetEnhancedMeasurementSettings RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的設定名稱。格式:property/{property}/dataStreams/{data_stream}/enhancedMeasurementSettings 範例:「properties/1000/dataStreams/2000/enhancedMeasurementSettings」

GetEventCreateRuleRequest

GetEventCreateRule RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 EventCreateRule 名稱。格式範例:properties/123/dataStreams/456/eventCreateRules/789

GetExpandedDataSetRequest

GetExpandedDataSet RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 ExpandedDataSet 名稱。格式範例:properties/1234/expandedDataSets/5678

GetGlobalSiteTagRequest

GetGlobalSiteTag RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的網站代碼名稱。請注意,網站代碼是單例模式,並沒有專屬 ID。格式:properties/{property_id}/dataStreams/{stream_id}/globalSiteTag 範例:「properties/123/dataStreams/456/globalSiteTag」

GetGoogleSignalsSettingsRequest

GetGoogleSignalsSettings RPC 的要求訊息

欄位
name

string

必要欄位。要擷取的 Google 信號設定名稱。格式:property/{property}/googleSignalsSettings

GetKeyEventRequest

GetKeyEvent RPC 的要求訊息

欄位
name

string

必要欄位。要擷取的重要事件資源名稱。格式:properties/{property}/keyEvents/{key_event} 範例:「properties/123/keyEvents/456」

GetMeasurementProtocolSecretRequest

GetMeasurementProtocolSecret RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的 Measurement Protocol 密鑰名稱。格式:properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

GetPropertyRequest

GetProperty RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的屬性名稱。格式:properties/{property_id},範例:「properties/1000」

GetRollupPropertySourceLinkRequest

GetRollupPropertySourceLink RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的綜覽資源來源連結名稱。格式:properties/{property_id}/rollupPropertySourceLinks/{rollup_property_source_link_id} 範例:properties/123/rollupPropertySourceLinks/456

GetSKAdNetworkConversionValueSchemaRequest

GetSKAdNetworkConversionValueSchema RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的 SKAdNetwork 轉換價值結構定義的資源名稱。格式:properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema/{skadnetwork_conversion_value_schema}

GetSearchAds360LinkRequest

GetSearchAds360Link RPC 的要求訊息。

欄位
name

string

必要欄位。要取得的 SearchAds360Link 名稱。格式範例:property/1234/SearchAds360Link/5678

GetSubpropertyEventFilterRequest

GetSubpropertyEventFilter RPC 的要求訊息。

欄位
name

string

必要欄位。要查詢的子資源事件篩選器資源名稱。格式:properties/property_id/subpropertyEventFilters/subproperty_event_filter 範例:properties/123/subpropertyEventFilters/456

GlobalSiteTag

唯讀資源,具有從網站將資料傳送至 DataStream 的標記。只會顯示網站 DataStream 資源。

欄位
name

string

僅供輸出。這項 GlobalSiteTag 資源的資源名稱。格式:properties/{property_id}/dataStreams/{stream_id}/globalSiteTag 範例:「properties/123/dataStreams/456/globalSiteTag」

snippet

string

不可變動。需將 JavaScript 程式碼片段做為第一個項目貼到每個網頁的 head 代碼中以進行評估。

GoogleSignalsConsent

Google 信號設定的同意聲明欄位。

列舉

GoogleSignalsSettings

Google 信號的設定值。這是單例模式資源。

欄位
name

string

僅供輸出。這項設定的資源名稱。格式:property/{property_id}/googleSignalsSettings 範例:「properties/1000/googleSignalsSettings」

state

GoogleSignalsState

這項設定的狀態。

consent

GoogleSignalsConsent

僅供輸出。接受《服務條款》。

GoogleSignalsState

Google 信號設定的狀態。

列舉
GOOGLE_SIGNALS_STATE_UNSPECIFIED Google 信號狀態預設為「GOOGLE_SIGNALS_STATE_UNSPECIFIED」,表示使用者並未做出明確選擇。
GOOGLE_SIGNALS_ENABLED 已啟用 Google 信號。
GOOGLE_SIGNALS_DISABLED 已停用 Google 信號。

GroupingRule

用來管理流量歸類至單一管道的規則。

欄位
display_name

string

必要欄位。客戶為頻道定義的顯示名稱。

expression

ChannelGroupFilterExpression

必要欄位。定義分組規則的篩選器運算式。

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 Analytics (分析) 資源中的重要事件。

欄位
name

string

僅供輸出。此重要事件的資源名稱。格式:properties/{property}/keyEvents/{key_event}

event_name

string

不可變動。這個重要事件的事件名稱。例如:「點擊」、「購買」

create_time

Timestamp

僅供輸出。在資源中建立此重要事件的時間。

deletable

bool

僅供輸出。如果設為 True,就可以刪除這個事件。

custom

bool

僅供輸出。如果設為 True,這個重要事件就會參照自訂事件。如果設為 False,這個重要事件會在 Google Analytics (分析) 中代表預設事件。預設事件在 Google Analytics (分析) 中通常具有特殊意義。預設事件通常是由 Google Analytics (分析) 系統建立,但在某些情況下,資源管理員可以建立預設事件。自訂事件會計入每個資源可建立的自訂重要事件數量上限。

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

LinkProposalInitiatingProduct

指出使用者發起連結提案的來源產品。

列舉
GOOGLE_ANALYTICS 此提案是由 Google Analytics (分析) 的使用者建立。
LINKED_PRODUCT 這個提案是由已連結產品 (而非 Google Analytics (分析)) 中的使用者建立。

LinkProposalState

連結提案資源的狀態。

列舉
AWAITING_REVIEW_FROM_GOOGLE_ANALYTICS 這項提案正在等待 Google Analytics (分析) 使用者的審查。此提案一段時間後將自動失效。
AWAITING_REVIEW_FROM_LINKED_PRODUCT 這項提案正在等待已連結產品使用者的審查。此提案一段時間後將自動失效。
WITHDRAWN 管理員已撤回這個提案中產品。此提案會在一段時間後自動刪除。
DECLINED 接收產品的管理員已拒絕這個提案。此提案會在一段時間後自動刪除。
EXPIRED 由於接收中產品的管理員缺少回應,這項提案已過期。此提案會在一段時間後自動刪除。
OBSOLETE 由於直接建立連結至這個提案指定的某個外部產品資源,因此這項提案已過時。此提案會在一段時間後自動刪除。

LinkProposalStatusDetails

連結提案的狀態資訊。

欄位
requestor_email

string

僅供輸出。提出此連結提案的使用者電子郵件地址。

ListAccessBindingsRequest

ListAccessBindings RPC 的要求訊息。

欄位
parent

string

必要欄位。格式:-accounts/{account} - 資源/{property}

page_size

int32

要傳回的存取繫結數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 200 個存取繫結。許可的最大值為 500;超出的數值將一律指定為 500。

page_token

string

屬於接收自前一個 ListAccessBindings 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 ListAccessBindings 的所有其他參數須與提供網頁權杖的呼叫相符。

ListAccessBindingsResponse

ListAccessBindings RPC 的回應訊息。

欄位
access_bindings[]

AccessBinding

AccessBindings 清單。這類項目會以任意順序排列。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

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 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListAdSenseLinksRequest

要傳遞至 ListAdSenseLinks 方法的要求訊息。

欄位
parent

string

必要欄位。父項屬性的資源名稱。格式:properties/{propertyId} 範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

接收自前一個 ListAdSenseLinks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListAdSenseLinks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListAdSenseLinksResponse

ListAdSenseLinks 方法的回應訊息。

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListAudiencesRequest

ListAudiences RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListAudiences 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListAudiences 的所有其他參數須與提供網頁權杖的呼叫相符。

ListAudiencesResponse

ListAudiences RPC 的回應訊息。

欄位
audiences[]

Audience

目標對象清單。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListBigQueryLinksRequest

ListBigQueryLinks RPC 的要求訊息。

欄位
parent

string

必要欄位。要在其下方列出 BigQuery 連結的資源名稱。格式:properties/{property_id} 範例:properties/1234

page_size

int32

要傳回的資源數量上限。服務傳回的網頁可能會少於這個值,即使還有其他網頁也一樣。如未指定,最多將傳回 50 個資源。最大值為 200 (系統會將較高的值強制轉換為最大值)

page_token

string

屬於接收自前一個 ListBigQueryLinks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 ListBigQueryLinks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListBigQueryLinksResponse

ListBigQueryLinks RPC 的回應訊息

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListCalculatedMetricsRequest

ListCalculatedMetrics RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

選用設定。要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

選用設定。屬於接收自前一個 ListCalculatedMetrics 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListCalculatedMetrics 的所有其他參數須與提供網頁權杖的呼叫相符。

ListCalculatedMetricsResponse

ListCalculatedMetrics RPC 的回應訊息。

欄位
calculated_metrics[]

CalculatedMetric

CalculatedMetrics 清單。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListChannelGroupsRequest

ListChannelGroups RPC 的要求訊息。

欄位
parent

string

必要欄位。要列出 ChannelGroup 的屬性。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListChannelGroups 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListChannelGroups 的所有其他參數須與提供網頁權杖的呼叫相符。

ListChannelGroupsResponse

ListChannelGroups RPC 的回應訊息。

欄位
channel_groups[]

ChannelGroup

ChannelGroup 清單。這類項目會以任意順序排列。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListConnectedSiteTagsRequest

ListConnectedSiteTags RPC 的要求訊息。

欄位
property

string

要擷取已連結網站代碼的通用 Analytics (分析) 資源。這項功能不適用於 GA4 資源。系統最多會傳回 20 個已連結的網站代碼。格式範例:properties/1234

ListConnectedSiteTagsResponse

ListConnectedSiteTags RPC 的回應訊息。

欄位
connected_site_tags[]

ConnectedSiteTag

通用 Analytics (分析) 資源的網站代碼。系統最多會傳回 20 個已連結的網站代碼。

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

ListCustomDimensions RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListCustomDimensions 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListCustomDimensions 的所有其他參數須與提供網頁權杖的呼叫相符。

ListCustomDimensionsResponse

ListCustomDimensions RPC 的回應訊息。

欄位
custom_dimensions[]

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

自訂指標清單。

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 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListDisplayVideo360AdvertiserLinkProposalsRequest

ListDisplayVideo360AdvertiserLinkProposals RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListDisplayVideo360AdvertiserLinkProposals 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListDisplayVideo360AdvertiserLinkProposals 的所有其他參數須與提供網頁權杖的呼叫相符。

ListDisplayVideo360AdvertiserLinkProposalsResponse

ListDisplayVideo360AdvertiserLinkProposals RPC 的回應訊息。

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListDisplayVideo360AdvertiserLinksRequest

ListDisplayVideo360AdvertiserLinks RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListDisplayVideo360AdvertiserLinks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListDisplayVideo360AdvertiserLinks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListDisplayVideo360AdvertiserLinksResponse

ListDisplayVideo360AdvertiserLinks RPC 的回應訊息。

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListEventCreateRulesRequest

ListEventCreateRules RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/123/dataStreams/456

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListEventCreateRules 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListEventCreateRules 的所有其他參數須與提供網頁權杖的呼叫相符。

ListEventCreateRulesResponse

ListEventCreateRules RPC 的回應訊息。

欄位
event_create_rules[]

EventCreateRule

EventCreateRules 清單。這類項目會以任意順序排列。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListExpandedDataSetsRequest

ListExpandedDataSets RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListExpandedDataSets 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListExpandedDataSet 的所有其他參數須與提供網頁權杖的呼叫相符。

ListExpandedDataSetsResponse

ListExpandedDataSets RPC 的回應訊息。

欄位
expanded_data_sets[]

ExpandedDataSet

OpenedDataSet 清單。這類項目會以任意順序排列。

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 Analytics (分析) 對每項資源僅支援一個 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 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListRollupPropertySourceLinksRequest

ListRollupPropertySourceLinks RPC 的要求訊息。

欄位
parent

string

必要欄位。綜覽資源的名稱,用來在下方列出綜覽資源來源連結。格式:properties/{property_id} 範例:properties/1234

page_size

int32

選用設定。要傳回的資源數量上限。服務傳回的網頁可能會少於這個值,即使還有其他網頁也一樣。如未指定,最多將傳回 50 個資源。最大值為 200 (系統會將較高的值強制轉換為最大值)

page_token

string

選用設定。屬於接收自前一個 ListRollupPropertySourceLinks 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 ListRollupPropertySourceLinks 的所有其他參數須與提供網頁權杖的呼叫相符。

ListRollupPropertySourceLinksResponse

ListRollupPropertySourceLinks RPC 的回應訊息。

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListSKAdNetworkConversionValueSchemasRequest

ListSKAdNetworkConversionValueSchemas 遠端程序呼叫 (RPC) 的要求訊息

欄位
parent

string

必要欄位。要列出結構定義的 DataStream 資源。格式:properties/{property_id}/dataStreams/{dataStream} 範例:properties/1234/dataStreams/5678

page_size

int32

要傳回的資源數量上限。服務傳回的網頁可能會少於這個值,即使還有其他網頁也一樣。如未指定,最多將傳回 50 個資源。最大值為 200 (系統會將較高的值強制轉換為最大值)

page_token

string

屬於接收自前一個 ListSKAdNetworkConversionValueSchemas 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 ListSKAdNetworkConversionValueSchema 的所有其他參數須與提供網頁權杖的呼叫相符。

ListSKAdNetworkConversionValueSchemasResponse

ListSKAdNetworkConversionValueSchemas 遠端程序呼叫 (RPC) 的回應訊息

欄位
skadnetwork_conversion_value_schemas[]

SKAdNetworkConversionValueSchema

SKAdNetworkConversionValueSchemas 清單。最多只有一個值。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會沒有後續網頁。目前,Google Analytics (分析) 針對每個 dataStream 僅支援一個 SKAdNetworkConversionValueSchema,因此一律不會填入這個值。

ListSearchAds360LinksRequest

ListSearchAds360Links RPC 的要求訊息。

欄位
parent

string

必要欄位。格式範例:properties/1234

page_size

int32

要傳回的資源數量上限。如未指定,最多將傳回 50 個資源。許可的最大值為 200 (上限值將強制轉換成最大值)。

page_token

string

屬於接收自前一個 ListSearchAds360Links 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時,提供至 ListSearchAds360Links 的所有其他參數須與提供網頁權杖的呼叫相符。

ListSearchAds360LinksResponse

ListSearchAds360Links RPC 的回應訊息。

欄位
next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

ListSubpropertyEventFiltersRequest

ListSubpropertyEventFilters RPC 的要求訊息。

欄位
parent

string

必要欄位。一般屬性的資源名稱。格式:properties/property_id 範例:properties/123

page_size

int32

選用設定。要傳回的資源數量上限。服務傳回的網頁可能會少於這個值,即使還有其他網頁也一樣。如未指定,最多將傳回 50 個資源。最大值為 200 (系統會將較高的值強制轉換為最大值)

page_token

string

選用設定。屬於接收自前一個 ListSubpropertyEventFilters 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 ListSubpropertyEventFilters 的所有其他參數須與提供網頁權杖的呼叫相符。

ListSubpropertyEventFiltersResponse

ListSubpropertyEventFilter RPC 的回應訊息。

欄位
subproperty_event_filters[]

SubpropertyEventFilter

子資源事件篩選器清單。

next_page_token

string

可做為 page_token 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

MatchingCondition

定義「事件編輯」或「事件建立」規則套用至事件的條件。

欄位
field

string

必要欄位。要與條件比較的欄位名稱。如果指定「event_name」,此條件會套用至事件名稱。否則,系統會將條件套用至具有指定名稱的參數。

此值不能包含空格。

comparison_type

ComparisonType

必要欄位。要套用至值的比較類型。

value

string

必要欄位。要與這項條件比較的值。執行階段實作可能會執行這個值的類型強制轉換,根據參數值類型評估這個條件。

negated

bool

是否應否定比較結果。舉例來說,如果 negated 為 true,「等於」的比較就會做為「不等於」。

ComparisonType

比對條件的比較類型

列舉
COMPARISON_TYPE_UNSPECIFIED 不明
EQUALS 等於 (區分大小寫)
EQUALS_CASE_INSENSITIVE 等於 (不區分大小寫)
CONTAINS 包含 (區分大小寫)
CONTAINS_CASE_INSENSITIVE 包含 (不區分大小寫)
STARTS_WITH 開頭有大小寫之分
STARTS_WITH_CASE_INSENSITIVE 開頭為 (不區分大小寫)
ENDS_WITH 結尾為區分大小寫
ENDS_WITH_CASE_INSENSITIVE 結尾為不區分大小寫
GREATER_THAN 大於
GREATER_THAN_OR_EQUAL 大於或等於
LESS_THAN 小於
LESS_THAN_OR_EQUAL 小於或等於
REGULAR_EXPRESSION 規則運算式。這項功能僅適用於網站串流。
REGULAR_EXPRESSION_CASE_INSENSITIVE 規則運算式,不區分大小寫。這項功能僅適用於網站串流。

MeasurementProtocolSecret

用來將命中傳送至 Measurement Protocol 的密鑰值。

欄位
name

string

僅供輸出。這個密鑰的資源名稱。這個密鑰可能會是任何串流類型的子項。格式:properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

display_name

string

必要欄位。這個密鑰的使用者可理解的顯示名稱。

secret_value

string

僅供輸出。Measurement Protocol 密鑰值。傳送命中給這個密鑰的父項資源時,請將這個值傳遞至 Measurement Protocol API 的 api_secret 欄位。

NumericValue

表示數字。

欄位
聯集欄位 one_value。其中一個數值 one_value 只能是下列其中一種數值:
int64_value

int64

整數值

double_value

double

雙重值

ParameterMutation

定義要變動的事件參數。

欄位
parameter

string

必要欄位。要變動的參數名稱。這個值必須:* 不得超過 40 個字元。* 規則內所有異動項目的名稱不得重複 * 只能包含字母、數字或 _ (底線)。如果是事件編輯規則,也可以將名稱設為「event_name」,以修改現有的 event_name。

parameter_value

string

必要欄位。要執行的值異動。* 必須少於 100 個字元。* 若要為參數指定常數值,請使用該值的字串。* 如要複製其他參數的值,請使用「[[other_parameter]]」等語法。詳情請參閱這篇說明中心文章

PostbackWindow

SKAdNetwork 轉換回傳回溯期設定。

欄位
conversion_values[]

ConversionValues

系統會根據重複欄位的順序決定轉換價值設定的優先順序。已建立索引的項目優先順序較高。系統會選取評估結果為 true 的第一個轉換價值設定。如果 enable_postback_window_settings 設為 true,至少必須有一個項目。最多可以有 128 個項目。

postback_window_settings_enabled

bool

如果 enable_postback_window_settings 設為 true,您必須填入 conversion_values 的資料,用以判斷在用戶端裝置上設定轉換價值的時機和方式,以及將架構匯出到已連結的 Google Ads 帳戶。如果設為 False,系統不會使用這些設定,但日後可能會繼續使用。對於 postback_window_one,此屬性一律須設為 true。

屬性

代表 Google Analytics (分析) 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}、property/{property} 範例:「accounts/100」、「properties/101」

display_name

string

必要欄位。這項屬性的顯示名稱。

顯示名稱的長度上限為 100 個 UTF-16 代碼單位。

industry_category

IndustryCategory

與這項資源相關的產業範例:AUTOMOTIVE、FOOD_AND_DRINK

time_zone

string

必要欄位。報表時區是報表日的邊界,不論資料來源為何。如果時區採用日光節約時間,Analytics (分析) 會自動根據變更做出調整。

注意:更改時區只會影響日後的報表資料,不會溯及既往。

格式: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 Analytics (分析) 服務層級。

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

ProvisionAccountTicket RPC 的要求訊息。

欄位
account

Account

要建立的帳戶。

redirect_uri

string

重新導向 URI,使用者接受《服務條款》後便會導向這個 URI。必須在 Cloud 控制台中設為重新導向 URI。

ProvisionAccountTicketResponse

ProvisionAccountTicket RPC 的回應訊息。

欄位
account_ticket_id

string

要在服務條款連結中傳遞的參數。

RunAccessReportRequest

針對資料存取記錄報告的要求。

欄位
entity

string

資料存取報表支援在資源層級或帳戶層級提出要求。如在帳戶層級提出要求,資料存取報表就會包含該帳戶下所有資源的所有存取權。

如要在資源層級提出要求,實體應以「properties/123」為例,且「123」是您的 GA4 資源 ID。如要在帳戶層級提出要求,實體應為「accounts/1234」,例如「1234」是您的 GA4 帳戶 ID。

dimensions[]

AccessDimension

要求及顯示在回應中的維度。要求最多可包含 9 個維度。

metrics[]

AccessMetric

要求及顯示在回應中的指標。要求最多可包含 10 個指標。

date_ranges[]

AccessDateRange

要讀取的存取記錄日期範圍。如果要求多個日期範圍,則每個回應列都會包含以 0 為基礎的日期範圍索引。如果兩個日期範圍重疊,這兩個日期範圍的回應列就會包含重疊日期的存取權記錄。最多可以要求 2 個日期範圍。

dimension_filter

AccessFilterExpression

維度篩選器可讓您限制報表只傳回符合篩選器的特定維度值。例如,篩選單一使用者的存取記錄。詳情請參閱「維度篩選器基礎知識」一文。這個篩選器無法使用指標。

metric_filter

AccessFilterExpression

指標篩選器可限制報表只會列出符合篩選條件的特定指標值。指標篩選器會在匯總報表資料列後套用,與 SQL 含子句類似。無法在這個篩選器中使用維度。

offset

int64

起始資料列的列數。第一列會計為第 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

切換是否要傳回這項 Analytics (分析) 資源的配額目前的狀態。系統會在 AccessQuota 中傳回配額。如果是帳戶層級請求,這個欄位必須設為 false。

include_all_users

bool

選用設定。決定是否要在回應中納入從未發出 API 呼叫的使用者。如果設為 true,所有可存取指定資源或帳戶的使用者,無論是否發出 API 呼叫,都會納入回應中。如果設為 False,系統只會納入已發出 API 呼叫的使用者。

expand_groups

bool

選用設定。決定是否要傳回使用者群組中的使用者。只有在 include_all_users 設為 true 時,此欄位才有效。若為 true,系統會傳回所有具有指定資源或帳戶存取權的使用者。如果設為 False,系統只會傳回具有直接存取權的使用者。

RunAccessReportResponse

自訂的資料存取記錄報表回應。

欄位
dimension_headers[]

AccessDimensionHeader

報表中對應特定維度的欄標題。DimensionsHeader 數量和 DimensionsHeader 數量的按順序與列數相符。

metric_headers[]

AccessMetricHeader

報表中對應特定指標的欄標題。MetricHeaders 的數量和 MetricHeaders 的數量與資料列中顯示的指標相符。

rows[]

AccessRow

報表中維度值組合和指標值的資料列。

row_count

int32

查詢結果中的資料列總數。rowCount 與回應中傳回的資料列數量、limit 要求參數和 offset 要求參數不同。舉例來說,如果查詢傳回 175 列,並在 API 要求中包含 50 的 limit,則回應中會包含 175 的 rowCount,但只有 50 列。

如要進一步瞭解這個分頁參數,請參閱分頁

quota

AccessQuota

這項 Analytics (分析) 資源的配額狀態 (包括這項要求)。這個欄位不適用於帳戶層級請求。

SKAdNetworkConversionValueSchema

iOS 串流的 SKAdNetwork 轉換價值結構定義。

欄位
name

string

僅供輸出。結構定義的資源名稱。這會僅是 iOS 串流的子項,iOS 串流中最多只能有一個兒童。格式:properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postback_window_one

PostbackWindow

必要欄位。第一個回傳期的轉換價值設定。這些值與回傳期 2 和 3 的值不同,因為其中包含「精細」的轉換價值 (數值)。

必須設定這個回傳期的轉換價值。其他視窗則為選用視窗,如果不設定或停用,可能會沿用這個視窗設定。

postback_window_two

PostbackWindow

第二個回傳期的轉換價值設定。

只有在需要為這個回傳期定義不同的轉換價值時,才應設定這個欄位。

如果這個回傳期的 enable_postback_window_settings 設為 false,系統將使用 postback_window_one 的值。

postback_window_three

PostbackWindow

第三個回傳期的轉換價值設定。

只有在使用者選擇為這個回傳期定義不同的轉換價值時,才需要設定這個欄位。可以設定視窗 3 而不設定視窗 2。如果視窗 1 和 2 的設定已設置,並將這個回傳期的 enable_postback_window_settings 設為 false,結構定義將沿用 postback_window_two 的設定。

apply_conversion_values

bool

啟用後,Google Analytics (分析) SDK 會使用這個結構定義來設定轉換價值,並將結構定義匯出至與這項資源連結的所有 Google Ads 帳戶。如果停用,Google Analytics (分析) SDK 就不會自動設定轉換價值,結構定義也不會匯出至 Google Ads。

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 Analytics (分析) 提供多種服務層級。

列舉
SERVICE_LEVEL_UNSPECIFIED 服務等級未指定或無效。
GOOGLE_ANALYTICS_STANDARD 標準版 Google Analytics (分析)。
GOOGLE_ANALYTICS_360 付費版 Google Analytics (分析)。

SetAutomatedGa4ConfigurationOptOutRequest

申請自動 GA4 設定程序的停用狀態。

欄位
property

string

必要欄位。用來設定「選擇拒絕」狀態的通用 Analytics (分析) 資源。請注意,這項要求會使用內部資源 ID,而非 UA-XXXXXX-YY 格式的追蹤 ID。格式:property/{internalWebPropertyId}範例:properties/1234

opt_out

bool

要設定的狀態。

SetAutomatedGa4ConfigurationOptOutResponse

這個類型沒有任何欄位。

為自動 GA4 設定程序設定停用狀態的回應訊息。

SubpropertyEventFilter

代表 GA4 子資源事件篩選器的資源訊息。

欄位
name

string

僅供輸出。格式:properties/{ordinary_property_id}/subpropertyEventFilters/{sub_property_event_filter} 範例:properties/1234/subpropertyEventFilters/5678

filter_clauses[]

SubpropertyEventFilterClause

必要欄位。未排序的清單。定義 SubpropertyEventFilter 的篩選器子句。所有子句會以 AND 結合,藉此判斷要將哪些資料傳送至子資源。

apply_to_property

string

不可變動。使用這個篩選器的子資源的資源名稱。

SubpropertyEventFilterClause

定義篩選器的子句。篩選條件可以包含 (符合篩選器子句的事件會納入子資源的資料) 或專屬 (系統會從子資源的資料中排除符合篩選器子句的事件)。

欄位
filter_clause_type

FilterClauseType

必要欄位。篩選器子句的類型。

filter_expression

SubpropertyEventFilterExpression

必要欄位。這是指將哪些事件傳送到子資源的邏輯運算式。

FilterClauseType

指定這是包含或排除篩選器子句。

列舉
FILTER_CLAUSE_TYPE_UNSPECIFIED 篩選器子句類型不明或未指定。
INCLUDE 如果符合篩選器子句,子資源就會包含事件。
EXCLUDE 如果符合篩選器子句,系統就會從子資源中排除事件。

SubpropertyEventFilterCondition

特定篩選運算式

欄位
field_name

string

必要欄位。要篩選的欄位。

聯集欄位 one_filter

one_filter 只能採用下列其中一種設定:

null_filter

bool

空值篩選器。

string_filter

StringFilter

篩選符合特定模式的字串類型維度。

StringFilter

篩選符合特定模式的字串類型維度。

欄位
match_type

MatchType

必要欄位。字串篩選器的比對類型。

value

string

必要欄位。用於比對的字串值。

case_sensitive

bool

選用設定。如果設為 true,字串值會區分大小寫。如果設為 False,比對時不區分大小寫。

MatchType

使用篩選器判斷相符項目的方式。

列舉
MATCH_TYPE_UNSPECIFIED 比對類型不明或未指定。
EXACT 完全符合字串值。
BEGINS_WITH 以字串值開頭。
ENDS_WITH 以字串值結尾。
CONTAINS 包含字串值。
FULL_REGEXP 完整的規則運算式與字串值相符。
PARTIAL_REGEXP 部分規則運算式與字串值相符。

SubpropertyEventFilterExpression

子資源事件篩選器的邏輯運算式。

欄位
聯集欄位 expr。套用至篩選器的運算式。expr 只能是下列其中一項:
or_group

SubpropertyEventFilterExpressionList

要結合 OR 的運算式清單。只能使用 not_expression 或 filter_condition 運算式。

not_expression

SubpropertyEventFilterExpression

不得為「不」的篩選運算式 (反向、互補)。只能加入篩選器。這項設定無法在頂層 SubpropertyEventFilterExpression 上設定,

filter_condition

SubpropertyEventFilterCondition

建立與特定事件相符的篩選器。這項設定無法在頂層 SubpropertyEventFilterExpression 上設定,

SubpropertyEventFilterExpressionList

子資源事件篩選器運算式清單。

欄位
filter_expressions[]

SubpropertyEventFilterExpression

必要欄位。未排序的清單。子資源事件篩選器運算式清單

UpdateAccessBindingRequest

UpdateAccessBinding RPC 的要求訊息。

欄位
access_binding

AccessBinding

必要欄位。要更新的存取權繫結。

UpdateAccountRequest

UpdateAccount RPC 的要求訊息。

欄位
account

Account

必要欄位。要更新的帳戶。帳戶的 name 欄位會用來識別帳戶。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 格式 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateAttributionSettingsRequest

UpdateAttributionSettings RPC 的要求訊息

欄位
attribution_settings

AttributionSettings

必要欄位。要更新的歸因設定。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateAudienceRequest

UpdateAudience RPC 的要求訊息。

欄位
audience

Audience

必要欄位。要更新的目標對象。目標對象的 name 欄位用來找出要更新的目標對象。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateCalculatedMetricRequest

UpdateCalculatedMetric RPC 的要求訊息。

欄位
calculated_metric

CalculatedMetric

必要欄位。要更新的 CalculatedMetric

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateChannelGroupRequest

UpdateChannelGroup 遠端程序呼叫 (RPC) 的要求訊息。

欄位
channel_group

ChannelGroup

必要欄位。要更新的管道群組。這項資源的 name 欄位是用來識別要更新的 ChannelGroup。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateConversionEventRequest

UpdateConversionEvent RPC 的要求訊息

欄位
conversion_event

ConversionEvent

必要欄位。要更新的轉換事件。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateCustomDimensionRequest

UpdateCustomDimensions RPC 的要求訊息。

欄位
custom_dimension

CustomDimension

要更新的自訂維度

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateCustomMetricRequest

UpdateCustomMetric RPC 的要求訊息。

欄位
custom_metric

CustomMetric

要更新的自訂指標

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateDataRedactionSettingsRequest

UpdateDataRedactionSettings RPC 的要求訊息。

欄位
data_redaction_settings

DataRedactionSettings

必要欄位。要更新的設定。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateDataRetentionSettingsRequest

UpdateDatareservationSettings RPC 的要求訊息。

欄位
data_retention_settings

DataRetentionSettings

必要欄位。要更新的設定。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateDataStreamRequest

UpdateDataStream RPC 的要求訊息。

欄位
data_stream

DataStream

要更新的 DataStream

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateDisplayVideo360AdvertiserLinkRequest

UpdateDisplayVideo360AdvertiserLink RPC 的要求訊息。

欄位
update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateEnhancedMeasurementSettingsRequest

UpdateEnhancedMeasurementSettings RPC 的要求訊息。

欄位
enhanced_measurement_settings

EnhancedMeasurementSettings

必要欄位。要更新的設定。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateEventCreateRuleRequest

UpdateEventCreateRule RPC 的要求訊息。

欄位
event_create_rule

EventCreateRule

必要欄位。要更新的 EventCreateRule。這項資源的 name 欄位是用來識別要更新的 EventCreateRule。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateExpandedDataSetRequest

UpdateExpandedDataSet RPC 的要求訊息。

欄位
expanded_data_set

ExpandedDataSet

必要欄位。要更新的 ExpandedDataSet。資源的 name 欄位是用來識別要更新的 ExpandedDataSet。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateGoogleAdsLinkRequest

UpdateGoogleAdsLink RPC 的要求訊息

欄位
update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateGoogleSignalsSettingsRequest

UpdateGoogleSignalsSettings RPC 的要求訊息

欄位
google_signals_settings

GoogleSignalsSettings

必要欄位。要更新的設定。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateKeyEventRequest

UpdateKeyEvent RPC 的要求訊息

欄位
key_event

KeyEvent

必要欄位。要更新的重要事件。name 欄位的用途是指明要更新的設定。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateMeasurementProtocolSecretRequest

UpdateMeasurementProtocolSecret RPC 的要求訊息

欄位
measurement_protocol_secret

MeasurementProtocolSecret

必要欄位。要更新的 Measurement Protocol 密鑰。

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。

UpdatePropertyRequest

UpdateProperty RPC 的要求訊息。

欄位
property

Property

必要欄位。要更新的屬性。這個屬性的 name 欄位是用來識別要更新的屬性。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 大寫 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateSKAdNetworkConversionValueSchemaRequest

UpdateSKAdNetworkConversionValueSchema RPC 的要求訊息。

欄位
skadnetwork_conversion_value_schema

SKAdNetworkConversionValueSchema

必要欄位。要更新的 SKAdNetwork 轉換價值結構定義。

update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。

UpdateSearchAds360LinkRequest

UpdateSearchAds360Link RPC 的要求訊息。

欄位
update_mask

FieldMask

必要欄位。要更新的欄位清單。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。

UpdateSubpropertyEventFilterRequest

UpdateSubpropertyEventFilter RPC 的要求訊息。

欄位
subproperty_event_filter

SubpropertyEventFilter

必要欄位。要更新的子資源事件篩選器。

update_mask

FieldMask

必要欄位。要更新的欄位清單。欄位名稱必須採用 snake 格式 (例如「field_to_update」)。系統不會更新已略過的欄位。如要取代整個實體,請使用單一路徑搭配「*」字串,比對所有欄位。