docs: Minor formatting (#6537)

docs: Add clarifications
PiperOrigin-RevId: 553885123
Source-Link: googleapis/googleapis@9458a5a
Source-Link: googleapis/googleapis-gen@8b78760
Copy-Tag: eyJwIjoiQW5hbHl0aWNzRGF0YS8uT3dsQm90LnlhbWwiLCJoIjoiOGI3ODc2MDM0ZmNmYjUyMWRiZDkyOTc3MDllMDczYjYxY2Q4OTM1MSJ9

AnalyticsData/src/V1beta/Gapic/BetaAnalyticsDataGapicClient.php

@@ -457,10 +457,6 @@ public function batchRunReports(array $optionalArgs = [])
      *           `property` should be the same value as in your `runReport` request.
      *
      *           Example: properties/1234
-     *
-     *           Set the Property ID to 0 for compatibility checking on dimensions and
-     *           metrics common to all properties. In this special mode, this method will
-     *           not return custom dimensions and metrics.
      *     @type Dimension[] $dimensions
      *           The dimensions in this report. `dimensions` should be the same value as in
      *           your `runReport` request.
@@ -668,6 +664,13 @@ public function getMetadata($name, array $optionalArgs = [])
      *           If false or unspecified, each row with all metrics equal to 0 will not be
      *           returned. If true, these rows will be returned if they are not separately
      *           removed by a filter.
+     *
+     *           Regardless of this `keep_empty_rows` setting, only data recorded by the
+     *           Google Analytics (GA4) property can be displayed in a report.
+     *
+     *           For example if a property never logs a `purchase` event, then a query for
+     *           the `eventName` dimension and  `eventCount` metric will not have a row
+     *           eventName: "purchase" and eventCount: 0.
      *     @type bool $returnPropertyQuota
      *           Toggles whether to return the current state of this Analytics Property's
      *           quota. Quota is returned in [PropertyQuota](#PropertyQuota).
@@ -790,7 +793,7 @@ public function runPivotReport(array $optionalArgs = [])
      *           SQL having-clause. Dimensions cannot be used in this filter.
      *     @type int $limit
      *           The number of rows to return. If unspecified, 10,000 rows are returned. The
-     *           API returns a maximum of 100,000 rows per request, no matter how many you
+     *           API returns a maximum of 250,000 rows per request, no matter how many you
      *           ask for. `limit` must be positive.
      *
      *           The API can also return fewer rows than the requested `limit`, if there
@@ -934,7 +937,7 @@ public function runRealtimeReport(array $optionalArgs = [])
      *           response rows for both date ranges. In a cohort request, this `dateRanges`
      *           must be unspecified.
      *     @type FilterExpression $dimensionFilter
-     *           Dimension filters allow you to ask for only specific dimension values in
+     *           Dimension filters let you ask for only specific dimension values in
      *           the report. To learn more, see [Fundamentals of Dimension
      *           Filters](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters)
      *           for examples. Metrics cannot be used in this filter.
@@ -953,7 +956,7 @@ public function runRealtimeReport(array $optionalArgs = [])
      *           [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
      *     @type int $limit
      *           The number of rows to return. If unspecified, 10,000 rows are returned. The
-     *           API returns a maximum of 100,000 rows per request, no matter how many you
+     *           API returns a maximum of 250,000 rows per request, no matter how many you
      *           ask for. `limit` must be positive.
      *
      *           The API can also return fewer rows than the requested `limit`, if there
@@ -980,6 +983,13 @@ public function runRealtimeReport(array $optionalArgs = [])
      *           If false or unspecified, each row with all metrics equal to 0 will not be
      *           returned. If true, these rows will be returned if they are not separately
      *           removed by a filter.
+     *
+     *           Regardless of this `keep_empty_rows` setting, only data recorded by the
+     *           Google Analytics (GA4) property can be displayed in a report.
+     *
+     *           For example if a property never logs a `purchase` event, then a query for
+     *           the `eventName` dimension and  `eventCount` metric will not have a row
+     *           eventName: "purchase" and eventCount: 0.
      *     @type bool $returnPropertyQuota
      *           Toggles whether to return the current state of this Analytics Property's
      *           quota. Quota is returned in [PropertyQuota](#PropertyQuota).