Oggetto dati ReportRequest - Creazione di report
Definisce l'oggetto di base per tutte le richieste di report.
Non creare un'istanza di questo oggetto. È invece possibile creare un'istanza di uno degli oggetti richiesta di report che deriva da questo oggetto, ad esempio CampaignPerformanceReportRequest. Per un elenco dei report, vedere la guida Tipi di report .
Sintassi
<xs:complexType name="ReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="ExcludeColumnHeaders" nillable="true" type="xs:boolean" />
<xs:element minOccurs="0" name="ExcludeReportFooter" nillable="true" type="xs:boolean" />
<xs:element minOccurs="0" name="ExcludeReportHeader" nillable="true" type="xs:boolean" />
<xs:element minOccurs="0" name="Format" nillable="true" type="tns:ReportFormat" />
<xs:element minOccurs="0" name="FormatVersion" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ReportName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ReturnOnlyCompleteData" nillable="true" type="xs:boolean" />
</xs:sequence>
</xs:complexType>
Elementi
L'oggetto ReportRequest include gli elementi seguenti: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData.
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| ExcludeColumnHeaders | Determina se il report scaricato deve contenere o meno descrizioni di intestazione per ogni colonna. L'intestazione di colonna del report corrisponde al nome di colonna richiesto, ad esempio Impressions e Clicks. Impostare questa proprietà su true se si desidera escludere le intestazioni di colonna del report dal report scaricato. Il valore predefinito è false. |
Boolean |
| ExcludeReportFooter | Determina se il report scaricato deve contenere o meno metadati del piè di pagina, ad esempio il copyright Microsoft (@2020 Microsoft Corporation. Tutti i diritti riservati.). Impostare questa proprietà su true se si desidera escludere i metadati del piè di pagina del report dal report scaricato. Il valore predefinito è false. |
Boolean |
| ExcludeReportHeader | Determina se il report scaricato deve contenere o meno metadati di intestazione, ad esempio nome del report, intervallo di date e aggregazione. Impostare questa proprietà su true se si desidera escludere i metadati dell'intestazione del report dal report scaricato. Il valore predefinito è false. |
Boolean |
| Formato | Formato dei dati del report. Ad esempio, è possibile richiedere i dati in formato csv (valori delimitati da virgole) o valori separati da tabulazioni (Tsv). Il valore predefinito è Csv. Tutti i file scaricati vengono compressi con zip. |
Formato report |
| FormatVersion | Determina il formato per determinati campi nel file di report scaricato. Il formato dei dati per determinati campi può essere aggiornato all'interno della versione dell'API corrente senza interrompere le applicazioni client esistenti. È possibile ottenere il formato dati più recente impostando questo campo di richiesta facoltativo su 2.0. Se questo campo non viene impostato, per impostazione predefinita il servizio viene impostato sulla versione 1.0. Per informazioni dettagliate sulle modifiche tra le versioni di formato, vedere Versione del formato del report. |
Stringa |
| Reportname | Nome del report. Il nome è incluso nell'intestazione del report. Se non si specifica un nome di report, il sistema genera un nome nel formato ReportType-ReportDateTime. La lunghezza massima del nome del report è 200. |
Stringa |
| ReturnOnlyCompleteData | Determina se il servizio deve assicurarsi che tutti i dati siano stati elaborati e siano disponibili. Se impostato su true e se il sistema non ha completato l'elaborazione di tutti i dati in base all'aggregazione, all'ambito e all'ora richiesti, il servizio restituisce il codice di errore NoCompleteDataAvaliable (2004). In caso contrario, per impostazione predefinita la richiesta può avere esito positivo, non esiste alcuna indicazione sul completamento dei dati e il report conterrà solo i dati che il sistema ha completato l'elaborazione al momento della richiesta. Si noti che poiché oggi è ancora in corso e i dati non sono stati completati, non è possibile impostare questo elemento su true se il periodo di tempo (personalizzato o predefinito) include la data odierna. Per altre informazioni, vedere Fusi orari nella creazione di report. |
Boolean |
Requisiti
Servizio: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13