Dienstvorgang "AddAccount" – Kundenverwaltung
Erstellt ein neues Konto innerhalb eines vorhandenen Kunden.
Ein Benutzer mit Super Admin-Anmeldeinformationen kann Konten unter dem eigenen Kunden hinzufügen.
Tipp
Vertriebspartner sollten in der Regel SignupCustomer anstelle von AddAccount aufrufen. Weitere Informationen finden Sie im technischen Handbuch zur Kontohierarchie .
Hinweis
Kunden im geschlossenen Pilotversuch "Unified Smart Campaigns" können ein neues Konto für einheitliche intelligente Kampagnen hinzufügen. Der AccountMode muss auf "UnifiedSmart" festgelegt werden.
Anfordern von Elementen
Das AddAccountRequest-Objekt definiert den Text und die Headerelemente der Dienstvorgangsanforderung. Die Elemente müssen in der gleichen Reihenfolge wie im Anforderungs-SOAP dargestellt sein.
Hinweis
Sofern unten nicht anders angegeben, sind alle Anforderungselemente erforderlich.
Anforderungstextelemente
Element | Beschreibung | Datentyp |
---|---|---|
Konto | Das Konto, das Sie dem vorhandenen Kunden hinzufügen möchten. Sie müssen die ParentCustomerId im Kontoobjekt des Inserenten festlegen. |
AdvertiserAccount |
Anforderungsheaderelemente
Element | Beschreibung | Datentyp |
---|---|---|
AuthenticationToken | Das OAuth-Zugriffstoken, das die Anmeldeinformationen eines Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Weitere Informationen finden Sie unter Authentifizierung mit OAuth. |
Zeichenfolge |
DeveloperToken | Das Entwicklertoken, das für den Zugriff auf die Bing Ads-API verwendet wird. Weitere Informationen finden Sie unter Abrufen eines Entwicklertokens. |
Zeichenfolge |
Kennwort | Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen. | Zeichenfolge |
UserName | Dieses Element ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie müssen das AuthenticationToken-Element verwenden, um Benutzeranmeldeinformationen festzulegen. | Zeichenfolge |
Antwortelemente
Das AddAccountResponse-Objekt definiert den Text und die Headerelemente der Dienstvorgangsantwort. Die Elemente werden in der gleichen Reihenfolge zurückgegeben, in der die Antwort-SOAP gezeigt wird.
Antworttextelemente
Element | Beschreibung | Datentyp |
---|---|---|
Accountid | Ein vom System generierter Kontobezeichner, der dem in der Anforderung angegebenen neuen Konto entspricht. Verwenden Sie diesen Bezeichner für Vorgangsanforderungen, die ein AccountId-Body-Element und ein SOAP-Headerelement CustomerAccountId erfordern. |
Lange |
Accountnumber | Die vom System generierte Kontonummer, die zum Identifizieren des Kontos in der Microsoft Advertising-Webanwendung verwendet wird. Die Kontonummer hat das Format xxxxxxxx, wobei xxxxxxxx eine Reihe von acht beliebigen alphanumerischen Zeichen ist. |
Zeichenfolge |
CreateTime | Das Datum und die Uhrzeit, zu dem das Konto hinzugefügt wurde. Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen. | dateTime |
Antwortheaderelemente
Element | Beschreibung | Datentyp |
---|---|---|
TrackingId | Der Bezeichner des Protokolleintrags, der die Details des API-Aufrufs enthält. | Zeichenfolge |
SOAP anfordern
Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Anforderung anzuzeigen. Informationen zu unterstützten Typen, die Sie mit diesem Dienstvorgang verwenden können, finden Sie oben in der Referenz zu Anforderungstextelementen .
<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:e206="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e206:BillToCustomerId i:nil="false">ValueHere</e206:BillToCustomerId>
<e206:CurrencyCode i:nil="false">ValueHere</e206:CurrencyCode>
<e206:AccountFinancialStatus i:nil="false">ValueHere</e206:AccountFinancialStatus>
<e206:Id i:nil="false">ValueHere</e206:Id>
<e206:Language i:nil="false">ValueHere</e206:Language>
<e206:LastModifiedByUserId i:nil="false">ValueHere</e206:LastModifiedByUserId>
<e206:LastModifiedTime i:nil="false">ValueHere</e206:LastModifiedTime>
<e206:Name i:nil="false">ValueHere</e206:Name>
<e206:Number i:nil="false">ValueHere</e206:Number>
<e206:ParentCustomerId>ValueHere</e206:ParentCustomerId>
<e206:PaymentMethodId i:nil="false">ValueHere</e206:PaymentMethodId>
<e206:PaymentMethodType i:nil="false">ValueHere</e206:PaymentMethodType>
<e206:PrimaryUserId i:nil="false">ValueHere</e206:PrimaryUserId>
<e206:AccountLifeCycleStatus i:nil="false">ValueHere</e206:AccountLifeCycleStatus>
<e206:TimeStamp i:nil="false">ValueHere</e206:TimeStamp>
<e206:TimeZone i:nil="false">ValueHere</e206:TimeZone>
<e206:PauseReason i:nil="false">ValueHere</e206:PauseReason>
<e206:ForwardCompatibilityMap xmlns:e207="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e207:KeyValuePairOfstringstring>
<e207:key i:nil="false">ValueHere</e207:key>
<e207:value i:nil="false">ValueHere</e207:value>
</e207:KeyValuePairOfstringstring>
</e206:ForwardCompatibilityMap>
<e206:LinkedAgencies i:nil="false">
<e206:CustomerInfo>
<e206:Id i:nil="false">ValueHere</e206:Id>
<e206:Name i:nil="false">ValueHere</e206:Name>
</e206:CustomerInfo>
</e206:LinkedAgencies>
<e206:SalesHouseCustomerId i:nil="false">ValueHere</e206:SalesHouseCustomerId>
<e206:TaxInformation xmlns:e208="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e208:KeyValuePairOfstringstring>
<e208:key i:nil="false">ValueHere</e208:key>
<e208:value i:nil="false">ValueHere</e208:value>
</e208:KeyValuePairOfstringstring>
</e206:TaxInformation>
<e206:BackUpPaymentInstrumentId i:nil="false">ValueHere</e206:BackUpPaymentInstrumentId>
<e206:BillingThresholdAmount i:nil="false">ValueHere</e206:BillingThresholdAmount>
<e206:BusinessAddress i:nil="false">
<e206:City i:nil="false">ValueHere</e206:City>
<e206:CountryCode i:nil="false">ValueHere</e206:CountryCode>
<e206:Id i:nil="false">ValueHere</e206:Id>
<e206:Line1 i:nil="false">ValueHere</e206:Line1>
<e206:Line2 i:nil="false">ValueHere</e206:Line2>
<e206:Line3 i:nil="false">ValueHere</e206:Line3>
<e206:Line4 i:nil="false">ValueHere</e206:Line4>
<e206:PostalCode i:nil="false">ValueHere</e206:PostalCode>
<e206:StateOrProvince i:nil="false">ValueHere</e206:StateOrProvince>
<e206:TimeStamp i:nil="false">ValueHere</e206:TimeStamp>
<e206:BusinessName i:nil="false">ValueHere</e206:BusinessName>
</e206:BusinessAddress>
<e206:AutoTagType i:nil="false">ValueHere</e206:AutoTagType>
<e206:SoldToPaymentInstrumentId i:nil="false">ValueHere</e206:SoldToPaymentInstrumentId>
<e206:TaxCertificate i:nil="false">
<e206:TaxCertificateBlobContainerName i:nil="false">ValueHere</e206:TaxCertificateBlobContainerName>
<e206:TaxCertificates xmlns:e209="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e209:KeyValuePairOfstringbase64Binary>
<e209:key i:nil="false">ValueHere</e209:key>
<e209:value i:nil="false">ValueHere</e209:value>
</e209:KeyValuePairOfstringbase64Binary>
</e206:TaxCertificates>
<e206:Status i:nil="false">ValueHere</e206:Status>
</e206:TaxCertificate>
<e206:AccountMode i:nil="false">ValueHere</e206:AccountMode>
</Account>
</AddAccountRequest>
</s:Body>
</s:Envelope>
Antwort-SOAP
Diese Vorlage wurde von einem Tool generiert, um die Reihenfolge der Text- und Headerelemente für die SOAP-Antwort anzuzeigen.
<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>
Codesyntax
Die Beispielsyntax kann mit Bing Ads SDKs verwendet werden. Weitere Beispiele finden Sie unter Codebeispiele für die Bing Ads-API .
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)
Anforderungen
Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13