Operazione del servizio AddAccount - Gestione clienti
Crea un nuovo account all'interno di un cliente esistente.
Un utente con credenziali super Amministrazione può aggiungere account nel proprio cliente.
Consiglio
I rivenditori in genere devono chiamare SignupCustomer anziché AddAccount. Per altri dettagli, vedere la guida tecnica relativa alla gerarchia degli account .
Nota
I clienti del progetto pilota di campagne intelligenti unificate chiuse possono aggiungere un nuovo account per le campagne intelligenti unificate. AccountMode deve essere impostato su "UnifiedSmart".
Elementi della richiesta
L'oggetto AddAccountRequest definisce gli elementi corpo e 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 |
---|---|---|
Account | Account che si vuole aggiungere al cliente esistente. Devi impostare ParentCustomerId nell'oggetto account dell'inserzionista. |
AdvertiserAccount |
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 AddAccountResponse definisce gli elementi corpo e 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 |
---|---|---|
AccountId | Identificatore dell'account generato dal sistema corrispondente al nuovo account specificato nella richiesta. Usare questo identificatore con le richieste di operazione che richiedono un elemento corpo AccountId e un elemento di intestazione SOAP CustomerAccountId . |
long |
AccountNumber | Numero di account generato dal sistema usato per identificare l'account nell'applicazione Web Microsoft Advertising. Il numero di conto ha il formato xxxxxxxx, dove xxxxxxxx è una serie di otto caratteri alfanumerici. |
Stringa |
CreateTime | Data e ora in cui è stato aggiunto l'account. Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi. | Datetime |
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">AddAccount</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<AddAccountRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<Account xmlns:e217="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e217:BillToCustomerId i:nil="false">ValueHere</e217:BillToCustomerId>
<e217:CurrencyCode i:nil="false">ValueHere</e217:CurrencyCode>
<e217:AccountFinancialStatus i:nil="false">ValueHere</e217:AccountFinancialStatus>
<e217:Id i:nil="false">ValueHere</e217:Id>
<e217:Language i:nil="false">ValueHere</e217:Language>
<e217:LastModifiedByUserId i:nil="false">ValueHere</e217:LastModifiedByUserId>
<e217:LastModifiedTime i:nil="false">ValueHere</e217:LastModifiedTime>
<e217:Name i:nil="false">ValueHere</e217:Name>
<e217:Number i:nil="false">ValueHere</e217:Number>
<e217:ParentCustomerId>ValueHere</e217:ParentCustomerId>
<e217:PaymentMethodId i:nil="false">ValueHere</e217:PaymentMethodId>
<e217:PaymentMethodType i:nil="false">ValueHere</e217:PaymentMethodType>
<e217:PrimaryUserId i:nil="false">ValueHere</e217:PrimaryUserId>
<e217:AccountLifeCycleStatus i:nil="false">ValueHere</e217:AccountLifeCycleStatus>
<e217:TimeStamp i:nil="false">ValueHere</e217:TimeStamp>
<e217:TimeZone i:nil="false">ValueHere</e217:TimeZone>
<e217:PauseReason i:nil="false">ValueHere</e217:PauseReason>
<e217:ForwardCompatibilityMap xmlns:e218="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e218:KeyValuePairOfstringstring>
<e218:key i:nil="false">ValueHere</e218:key>
<e218:value i:nil="false">ValueHere</e218:value>
</e218:KeyValuePairOfstringstring>
</e217:ForwardCompatibilityMap>
<e217:LinkedAgencies i:nil="false">
<e217:CustomerInfo>
<e217:Id i:nil="false">ValueHere</e217:Id>
<e217:Name i:nil="false">ValueHere</e217:Name>
</e217:CustomerInfo>
</e217:LinkedAgencies>
<e217:SalesHouseCustomerId i:nil="false">ValueHere</e217:SalesHouseCustomerId>
<e217:TaxInformation xmlns:e219="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e219:KeyValuePairOfstringstring>
<e219:key i:nil="false">ValueHere</e219:key>
<e219:value i:nil="false">ValueHere</e219:value>
</e219:KeyValuePairOfstringstring>
</e217:TaxInformation>
<e217:BackUpPaymentInstrumentId i:nil="false">ValueHere</e217:BackUpPaymentInstrumentId>
<e217:BillingThresholdAmount i:nil="false">ValueHere</e217:BillingThresholdAmount>
<e217:BusinessAddress i:nil="false">
<e217:City i:nil="false">ValueHere</e217:City>
<e217:CountryCode i:nil="false">ValueHere</e217:CountryCode>
<e217:Id i:nil="false">ValueHere</e217:Id>
<e217:Line1 i:nil="false">ValueHere</e217:Line1>
<e217:Line2 i:nil="false">ValueHere</e217:Line2>
<e217:Line3 i:nil="false">ValueHere</e217:Line3>
<e217:Line4 i:nil="false">ValueHere</e217:Line4>
<e217:PostalCode i:nil="false">ValueHere</e217:PostalCode>
<e217:StateOrProvince i:nil="false">ValueHere</e217:StateOrProvince>
<e217:TimeStamp i:nil="false">ValueHere</e217:TimeStamp>
<e217:BusinessName i:nil="false">ValueHere</e217:BusinessName>
</e217:BusinessAddress>
<e217:AutoTagType i:nil="false">ValueHere</e217:AutoTagType>
<e217:SoldToPaymentInstrumentId i:nil="false">ValueHere</e217:SoldToPaymentInstrumentId>
<e217:TaxCertificate i:nil="false">
<e217:TaxCertificateBlobContainerName i:nil="false">ValueHere</e217:TaxCertificateBlobContainerName>
<e217:TaxCertificates xmlns:e220="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e220:KeyValuePairOfstringbase64Binary>
<e220:key i:nil="false">ValueHere</e220:key>
<e220:value i:nil="false">ValueHere</e220:value>
</e220:KeyValuePairOfstringbase64Binary>
</e217:TaxCertificates>
<e217:Status i:nil="false">ValueHere</e217:Status>
</e217:TaxCertificate>
<e217:AccountMode i:nil="false">ValueHere</e217:AccountMode>
</Account>
</AddAccountRequest>
</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>
<AddAccountResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<AccountId>ValueHere</AccountId>
<AccountNumber d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</AccountNumber>
<CreateTime>ValueHere</CreateTime>
</AddAccountResponse>
</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<AddAccountResponse> AddAccountAsync(
AdvertiserAccount account)
{
var request = new AddAccountRequest
{
Account = account
};
return (await CustomerManagementService.CallAsync((s, r) => s.AddAccountAsync(r), request));
}
static AddAccountResponse addAccount(
AdvertiserAccount account) throws RemoteException, Exception
{
AddAccountRequest request = new AddAccountRequest();
request.setAccount(account);
return CustomerManagementService.getService().addAccount(request);
}
static function AddAccount(
$account)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new AddAccountRequest();
$request->Account = $account;
return $GLOBALS['CustomerManagementProxy']->GetService()->AddAccount($request);
}
response=customermanagement_service.AddAccount(
Account=Account)
Requisiti
Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per