Operazione del servizio PollGenerateReport - Creazione di report

Articolo
12/21/2023

Ottiene lo stato di una richiesta di report.

La creazione di report è un processo asincrono. Di seguito è riportato il flusso generale per la richiesta di un report.

Creare una richiesta con i parametri del report. Non utilizzare l'oggetto ReportRequest . È invece necessario usare uno degli oggetti richiesta di report derivati, ad esempio CampaignPerformanceReportRequest. Per un elenco dei report, vedere la guida Tipi di report .
Inviare una richiesta al servizio di report, ad esempio tramite SubmitGenerateReport.
Il servizio accoda la richiesta fino a quando non è in grado di elaborarla
Eseguire periodicamente il polling del servizio per ottenere lo stato del processo di report, ad esempio tramite PollGenerateReport
Quando lo stato del polling è Riuscito, usare l'URL fornito dal servizio per scaricare il report.

Per altre informazioni, vedere la guida Richiedere e scaricare un report .

Nota

È necessario usare le stesse credenziali utente per SubmitGenerateReport e PollGenerateReport.

Elementi della richiesta

L'oggetto PollGenerateReportRequest definisce il corpo e gli elementi dell'intestazione della richiesta di operazione del servizio. Gli elementi devono essere nello stesso ordine indicato nella richiesta SOAP.

Nota

Se non diversamente indicato di seguito, sono necessari tutti gli elementi della richiesta.

Elementi del corpo della richiesta

Elemento	Descrizione	Tipo di dati
ReportRequestId	Identificatore della richiesta di report. L'operazione SubmitGenerateReport restituisce l'identificatore. L'identificatore è valido per un massimo di un giorno. Se il file non è stato scaricato correttamente entro questo periodo, viene rimosso dal sito di download ed è necessario ottenere un nuovo identificatore della richiesta di report. La stringa ha una lunghezza fino a 40 e può contenere qualsiasi carattere.	Stringa

Elementi dell'intestazione della richiesta

Elemento	Descrizione	Tipo di dati
AuthenticationToken	Token di accesso OAuth che rappresenta le credenziali di un utente che dispone delle autorizzazioni per gli account Microsoft Advertising. Per altre informazioni, vedere Autenticazione con OAuth.	Stringa
CustomerAccountId	Identificatore dell'account pubblicitario proprietario o associato alle entità nella richiesta. Questo elemento di intestazione deve avere lo stesso valore dell'elemento del corpo AccountId quando sono necessari entrambi. Questo elemento è necessario per la maggior parte delle operazioni del servizio e, come procedura consigliata, è consigliabile impostarlo sempre. Per altre informazioni, vedere Ottenere l'account e gli ID cliente.	Stringa
Customerid	Identificatore dell'account manager (cliente) da cui l'utente accede o opera. Un utente può avere accesso a più account manager. Questo elemento è necessario per la maggior parte delle operazioni del servizio e, come procedura consigliata, è consigliabile impostarlo sempre. Per altre informazioni, vedere Ottenere l'account e gli ID cliente.	Stringa
DeveloperToken	Token di sviluppo usato per accedere all'API Bing Ads. Per altre informazioni, vedere Ottenere un token per sviluppatori.	Stringa
Password	Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API. È necessario usare l'elemento AuthenticationToken per impostare le credenziali utente.	Stringa
UserName	Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API. È necessario usare l'elemento AuthenticationToken per impostare le credenziali utente.	Stringa

Elementi di risposta

L'oggetto PollGenerateReportResponse definisce il corpo e gli elementi dell'intestazione della risposta dell'operazione del servizio. Gli elementi vengono restituiti nello stesso ordine illustrato nella soap di risposta.

Elementi del corpo della risposta

Elemento	Descrizione	Tipo di dati
ReportRequestStatus	Contiene lo stato della richiesta di report e l'URL di download.	ReportRequestStatus

Elementi dell'intestazione della risposta

Elemento	Descrizione	Tipo di dati
TrackingId	Identificatore della voce di log che contiene i dettagli della chiamata API.	Stringa

Richiedi SOAP

Questo modello è stato generato da uno strumento per visualizzare l'ordine degli elementi corpo e intestazione per la richiesta SOAP. Per i tipi supportati che è possibile usare con questa operazione del servizio, vedere il riferimento Request Body Elements sopra riportato.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Reporting/v13">
    <Action mustUnderstand="1">PollGenerateReport</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <PollGenerateReportRequest xmlns="https://bingads.microsoft.com/Reporting/v13">
      <ReportRequestId i:nil="false">ValueHere</ReportRequestId>
    </PollGenerateReportRequest>
  </s:Body>
</s:Envelope>

SOAP della risposta

Questo modello è stato generato da uno strumento per visualizzare l'ordine degli elementi del corpo e dell'intestazione per la risposta SOAP.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Reporting/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <PollGenerateReportResponse xmlns="https://bingads.microsoft.com/Reporting/v13">
      <ReportRequestStatus d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <ReportDownloadUrl d4p1:nil="false">ValueHere</ReportDownloadUrl>
        <Status>ValueHere</Status>
      </ReportRequestStatus>
    </PollGenerateReportResponse>
  </s:Body>
</s:Envelope>

Sintassi del codice

La sintassi di esempio può essere usata con gli SDK di Bing Ads. Per altri esempi, vedere Esempi di codice DELL'API Bing Ads .

public async Task<PollGenerateReportResponse> PollGenerateReportAsync(
	string reportRequestId)
{
	var request = new PollGenerateReportRequest
	{
		ReportRequestId = reportRequestId
	};

	return (await ReportingService.CallAsync((s, r) => s.PollGenerateReportAsync(r), request));
}

static PollGenerateReportResponse pollGenerateReport(
	java.lang.String reportRequestId) throws RemoteException, Exception
{
	PollGenerateReportRequest request = new PollGenerateReportRequest();

	request.setReportRequestId(reportRequestId);

	return ReportingService.getService().pollGenerateReport(request);
}

static function PollGenerateReport(
	$reportRequestId)
{

	$GLOBALS['Proxy'] = $GLOBALS['ReportingProxy'];

	$request = new PollGenerateReportRequest();

	$request->ReportRequestId = $reportRequestId;

	return $GLOBALS['ReportingProxy']->GetService()->PollGenerateReport($request);
}

response=reporting_service.PollGenerateReport(
	ReportRequestId=ReportRequestId)

Requisiti

Servizio: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

Condividi tramite