# 限制和注意事项
<a name="googleanalytics-connector-limitations"></a>

Google Analytics 4 连接器的限制如下：
+  对于核心报告实体，只允许在请求中发送 9 个维度字段和 10 个指标字段。如果超出允许的字段数，则请求将会失败，并且连接器将发出一条错误消息。
+  对于实时报告实体，只允许在请求中发送 4 个维度字段。如果超出允许的字段数，则请求将会失败，并且连接器将发出一条错误消息。
+  Google Analytics 4 是一款测试版的免费工具，因此会定期发布有关新功能、实体增强、增加新字段和弃用现有字段的更新。
+  核心报告字段是动态填充的，因此可能随时会增加、弃用和重命名字段，以及对字段实施新的限制。
+  默认开始日期为 30 天，结束日期为昨日（当前日期前一日）。如果用户设置了该值或者流程属于增量，则这些日期将在筛选表达式代码中被覆盖。
+  根据文档的说明，如果请求中未传递限制值，则实时报告实体将返回 1 万条记录，否则无论请求的行数为多少，API 将最多为每个请求返回 25 万行。有关更多信息，请参阅 Google Analytics 文档中的 [Method: properties.runRealtimeReport](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport)。
+  实时报告实体不支持基于记录的分区，因为它不支持分页。此外，这种实体不支持基于字段的分区，因为没有任何字段符合定义的标准。
+  由于可以在请求中传递的字段数存在限制，我们在指定限制范围内设置默认维度和指标字段。如果选择“全选”，则将仅检索这些预先确定字段中的数据。
  +  核心报告 
    +  根据 SAAS 规定的限制，最多允许请求 9 个维度和最多 10 个指标，即一条请求最多可以包含 19 个字段（指标\+维度）。
    +  根据具体实现，如果用户使用 SELECT\_ALL 或选定的字段数超过 25 个，则系统将在请求中传递默认字段。
    +  以下字段属于核心报告的默认字段：“country”、“city”、“eventName”、“cityId”、“browser”、“date”、“currencyCode”、“deviceCategory”、“transactionId”、“active1DayUsers”、“active28DayUsers”、“active7DayUsers”、“activeUsers”、“averagePurchaseRevenue”、“averageRevenuePerUser”、“averageSessionDuration”、“engagedSessions”、“eventCount”、“engagementRate”。
  +  实时报告 
    +  根据 SAAS 规定的限制，最多允许请求 4 个维度。
    +  如果用户使用 SELECT\_ALL 或选定的字段数超过 15 个，则系统将在请求中传递默认字段。
    +  以下字段属于实时报告的默认字段：“country”、“deviceCategory”、“city”、“cityId”、“activeUsers”、“conversions”、“eventCount”、“screenPageViews”。
+  在核心报告实体中，如果同时存在基于 date 字段的分区和基于 StartDate 的筛选条件，则在这种情况下，dateRange 值会被 startDate 筛选条件值覆盖。但是，由于分区必须始终优先，因此，如果已经存在基于 date 字段上的分区，则会丢弃 startDate 筛选条件。
+  由于现在 cohortSpecs 也是核心报告请求正文的一部分，因此我们对当前核心报告实体进行了增强，增加了对 cohortSpec 属性的支持。在 cohortSpecs 请求正文中，几乎所有字段都要求用户输入。为了解决这一问题，我们为这些属性/字段设置了默认值，并提供了让用户在需要时覆盖这些值的功能。    
<a name="google-analytics-connector-limitations-table"></a>[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/glue/latest/dg/googleanalytics-connector-limitations.html)
+  您也可以一次性传递所有这些筛选条件，或与其他筛选条件一起传递。
  +  示例 1 – filterPredicate：startDate between "2023-05-09" and "2023-05-10" AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"
  +  示例 2 – filterPredicate: city=“xyz” AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"
+  在 cohort 请求中：
  +  如果请求中传递的是“cohortNthMonth”，则内部 granularity 值将设置为“MONTHLY” 
  +  同样，如果传递的是“cohortNthWeek”，则 granularity 值将设置为“WEEKLY” 
  +  对于“cohortNthDay”，granularity 值将设置为“DAILY”。有关更多信息，请参阅：
    +  [ https://developers.google.com/analytics/devguides/reporting/data/v1/advanced ](https://developers.google.com/analytics/devguides/reporting/data/v1/advanced) 
    +  [ https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/CohortSpec ](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/CohortSpec) 
  +  为用户提供了覆盖 dateRange 和 granularity 默认值的功能。请参阅上表。