AssetGroupPerformanceReportRequest 數據物件 - 報告

定義 AssetGroupPerformanceReportRequest 的數據物件。

語法

<xs:complexType name="AssetGroupPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfAssetGroupPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:AssetGroupPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAssetGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

AssetGroupPerformanceReportRequest 物件具有下列元素：匯總、數據行、篩選、範圍、時間。

元素	描述	資料類型
聚集	用來匯總報表數據的匯總類型。 例如，您可以依日或周匯總報表數據，或要求摘要報表。 默認匯總為 Summary。 請務必注意，如果您未在數據行清單中包含 TimePeriod ，則會忽略您選擇的匯總，不論為何都會使用摘要匯總。	ReportAggregation
Columns	要包含在報表中的屬性和效能統計數據清單。 報表會以您指定資料行的順序來包含這些數據行。	AssetGroupPerformanceReportColumn 陣 列
篩選器	用來篩選報表數據的準則。	AssetGroupPerformanceReportFilter
範圍	報表的實體範圍。 使用此元素可將報表數據限制為特定帳戶、資產群組或活動。	AccountThroughAssetGroupReportScope
時間	要用於報表的時間週期。 您可以指定自定義日期範圍，或選取預先定義的日期範圍，例如 Today 或 ThisWeek。 如需您可以為每個匯總類型指定的時間週期清單，請參閱 匯總和時間。	ReportTime

AssetGroupPerformanceReportRequest 物件具有 Inherited Elements。

繼承的專案

從 ReportRequest 繼承的專案

AssetGroupPerformanceReportRequest 物件衍生自 ReportRequest 物件，並繼承下列元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下列描述專屬於 AssetGroupPerformanceReportRequest，而且可能不適用於從 ReportRequest 物件繼承相同元素的其他物件。

元素	描述	資料類型
ExcludeColumnHeaders	判斷下載的報表是否應該包含每個數據行的標頭描述。 報表數據行標頭符合要求的數據行名稱，例如 [曝光數 ] 和 [ 按兩下]。 如果您想要將報表數據行標頭從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。	布爾
ExcludeReportFooter	判斷下載的報表是否應該包含頁尾元數據，例如 Microsoft 著作權 (@2020 Microsoft Corporation。保留的所有許可權。) 。 如果您想要將報表頁尾元數據從下載的報表中排除，請將此屬性設定 為 true 。 預設值為 false。	布爾
ExcludeReportHeader	判斷下載的報表是否應該包含標頭元數據，例如報表名稱、日期範圍和匯總。 如果您想要從下載的報表中排除報表標頭元數據，請將此屬性設為 true 。 預設值為 false。	布爾
格式	報表數據的格式。 例如，您可以要求以逗號分隔值 (Csv) 格式或索引標籤分隔值 (Tsv) 格式的數據。 預設值為 Csv。 所有下載的檔案都會壓縮。	ReportFormat
FormatVersion	決定所下載報表檔案中特定欄位的格式。 某些欄位的數據格式可以在目前的 API 版本內更新，而不會中斷現有的用戶端應用程式。 您可以將此選擇性要求字段設定為 2.0，以取得最新的資料格式。 如果您未設定此欄位，服務預設為 1.0 版。 如需格式版本之間變更的詳細資訊，請 參閱報表格式版本。	string
ReportName	報表的名稱。 名稱包含在報表標頭中。 如果您未指定報表名稱，系統會以 ReportType-ReportDateTime 格式產生名稱。 報表名稱的最大長度為 200。	string
ReturnOnlyCompleteData	判斷服務是否必須確定所有數據都已處理且可供使用。 如果設為 true ，而且系統尚未根據要求的 匯總、 範圍和 時間完成處理所有數據，服務會傳回錯誤碼 NoCompleteDataAvaliable (2004) 。 否則，根據預設，要求可能會成功，並不會指出數據是否已完成，而且報表只會包含系統在要求時已完成處理的數據。 請注意，因為今天仍在進行中，而且數據尚未完成，所以如果 [時間] 期間 (自定義或預先定義的日期) 包含今天的日期，您就無法將此元素設定為 true。 如需詳細資訊，請參閱 報表中的時區。	布爾

需求

服務： ReportingService.svc v13
命名空間： https://bingads.microsoft.com/Reporting/v13