Operazione del servizio GetCustomerPilotFeatures - Gestione dei clienti

Articolo
12/21/2023

Ottiene un elenco degli ID pilota della funzionalità abilitati per tutti gli account pubblicitari di proprietà di un cliente (account manager).

Nota

Un flag pilota potrebbe essere abilitato solo per un subset di account pubblicitari in un cliente. Usa l'operazione GetAccountPilotFeatures per ottenere gli ID pilota delle funzionalità a livello di account pubblicitario.

Nota: GetCustomerPilotFeatures potrebbe anche restituire ID pilota a livello di account per uso interno; Tuttavia, per i progetti pilota a livello di account è necessario ignorare i risultati di GetCustomerPilotFeatures.

Elementi della richiesta

L'oggetto GetCustomerPilotFeaturesRequest definisce il corpo e gli elementi di 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
Customerid	Identificatore del cliente usato per ottenere un elenco di ID pilota delle funzionalità.	long

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
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 GetCustomerPilotFeaturesResponse definisce il corpo e gli elementi di 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
FeaturePilotFlags	Elenco di numeri interi che identificano i progetti pilota di funzionalità abilitati per tutti gli account di proprietà di un cliente (account manager). Per altre informazioni sulla partecipazione pilota, contattare il proprio account manager. Ad esempio, i valori seguenti corrispondono ai progetti pilota di funzionalità a livello di cliente. 78 - Monitoraggio delle chiamate 268 - Annunci di ricerca dinamica 317 - Elenchi di remarketing simili 351 - Annunci di inventario locale 388 - Microsoft Audience Network 567 - Account aziendali e dell'istituto di istruzione di Azure AD 574 - Includere nelle conversioni 579 - Destinatari elenco clienti 600 - Testo degli annunci di ricerca dinamica - Parte 2 616 - Conversioni view-through 618 - Gruppo di destinatari elenco combinato 626 - Estensioni per annunci multi-immagine 635 - Aumento del limite dei parametri personalizzati Fase 3 636 - Fase finale suffisso URL 3 637 - Esperimenti Cookie-Based 684 - Campagne di shopping per i marchi 704 - Target ROAS Bid Strategy Type in UK/CA/AU/DE/FR 718 - Campagne di shopping intelligente 720 - Estensioni per annunci promozionali 721 - Tipo di strategia di offerta ROAS target negli Stati Uniti 734 - Google Import As A Service 762 - Target Impression Share Bid Strategy Type 764 - Annuncio di promozione della proprietà del sito per gli hotel 777 - Annunci reattivi per le campagne di shopping intelligente 793 - Creare account per conto del client 802 - Flyer Ad Extensions Si noti che l'elenco degli ID pilota potrebbe includere anche gli ID pilota a livello di account per l'uso interno. È consigliabile ignorare gli ID pilota a livello di account restituiti da questa operazione e usare invece l'operazione GetAccountPilotFeatures .	matrice int

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/Customer/v13">
    <Action mustUnderstand="1">GetCustomerPilotFeatures</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetCustomerPilotFeaturesRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <CustomerId>ValueHere</CustomerId>
    </GetCustomerPilotFeaturesRequest>
  </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/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetCustomerPilotFeaturesResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <FeaturePilotFlags d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <a1:int>ValueHere</a1:int>
      </FeaturePilotFlags>
    </GetCustomerPilotFeaturesResponse>
  </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<GetCustomerPilotFeaturesResponse> GetCustomerPilotFeaturesAsync(
	long customerId)
{
	var request = new GetCustomerPilotFeaturesRequest
	{
		CustomerId = customerId
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.GetCustomerPilotFeaturesAsync(r), request));
}

static GetCustomerPilotFeaturesResponse getCustomerPilotFeatures(
	java.lang.Long customerId) throws RemoteException, Exception
{
	GetCustomerPilotFeaturesRequest request = new GetCustomerPilotFeaturesRequest();

	request.setCustomerId(customerId);

	return CustomerManagementService.getService().getCustomerPilotFeatures(request);
}

static function GetCustomerPilotFeatures(
	$customerId)
{

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

	$request = new GetCustomerPilotFeaturesRequest();

	$request->CustomerId = $customerId;

	return $GLOBALS['CustomerManagementProxy']->GetService()->GetCustomerPilotFeatures($request);
}

response=customermanagement_service.GetCustomerPilotFeatures(
	CustomerId=CustomerId)

Requisiti

Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13

Condividi tramite