SignupCustomer Service Operation – Kundenverwaltung
Erstellt einen neuen Kunden und ein neues Konto.
In der Regel müssen Sie ein Benutzer mit Aggregatoranmeldeinformationen sein, um diesen Vorgang aufrufen zu können. In diesem Fall erstellt der Vorgang einen neuen Kunden und ein Neues Konto, das für Ihre Aggregator-Zahlungsmethode verwendet wird. Das AdvertiserAccount-Objekt muss den Namen des Kontos, den Typ der Währung, die zum Begleichen des Kontos verwendet werden soll, enthalten, und der Bezeichner der Zahlungsmethode muss auf NULL festgelegt werden. Der Vorgang generiert ein Rechnungskonto und legt den Bezeichner der Zahlungsmethode auf den Bezeichner fest, der der Rechnung des Aggregators zugeordnet ist. Ihnen werden alle Gebühren in Rechnung gestellt, die für die von Ihnen verwalteten Kunden anfallen.
Hinweis
Agenturkunden im Pilotversuch "Konten im Auftrag des Kunden erstellen" (GetCustomerPilotFeatures gibt 793 zurück) können einen neuen Kunden im Namen eines Kunden registrieren und optional als Agentur mit dem neuen Konto verknüpfen. In diesem Fall wird eine UserInvitation gesendet, und der Client muss die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche ausführen, z. B. die Bedingungen akzeptieren.
Hinweis
Kunden im geschlossenen Pilotversuch unified smart campaigns können einen neuen Kunden mit einem Konto für unified smart campaigns registrieren. Optional können sie sich als Agentur mit dem neuen Konto verknüpfen. Der Superadministrator wird bereitgestellt, indem entweder das Element UserId oder UserInvitation festgelegt wird.
Hinweis
Kunden im nahtlos eingerichteten Clientkonto und PI-Pilot können einen neuen Kunden mit einem Konto registrieren und gleichzeitig einen Administratorbenutzer erstellen. Der Administratorbenutzer wird durch Festlegen des User-Elements bereitgestellt. Und der Kunde muss die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche auf der Microsoft Advertising-Kundenseite ausführen, auf der microsoft Advertising aktiviert wird.
Anfordern von Elementen
Das SignupCustomerRequest-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 | Ein AdvertiserAccount , das die Details des primären Kontos des Kunden angibt. Kunden im geschlossenen Pilotversuch "Unified Smart Campaigns" müssen das AccountMode-Element auf "UnifiedSmart" festlegen. |
AdvertiserAccount |
| Kunde | Ein Kunde , der die Details des Kunden angibt, den Sie hinzufügen. | Kunde |
| ParentCustomerId | Die Kunden-ID des Aggregators oder der Agentur, der den neuen untergeordneten Kunden verwaltet. Dieses Element ist für Aggregatoren erforderlich, wird aber für Agenturen ignoriert, wenn das UserInvitation-Anforderungselement festgelegt ist. Kunden im geschlossenen Pilotversuch unified smart campaigns können den neuen Kunden mit der ID der übergeordneten Agentur verknüpfen oder dieses Element leer lassen. |
lang |
| Benutzer | Der zu erstellende Benutzer. Sie können dieses Element erfüllen, wenn Sie einen neuen Kunden registrieren und gleichzeitig einen neuen Administratorbenutzer erstellen möchten. Nachdem der neue Kunde registriert wurde, muss der neu erstellte Administratorbenutzer die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche auf der Microsoft Advertising-Kundenseite ausführen, auf der die Kundenseite aktiviert wird. Die URL lautet https://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}& aid={new_account_Id} , wobei new_customer_Id und new_account_Id die IDs sind, die Sie in SignupCustomerResponse erhalten. Das AuthenticationToken im User-Element ist das OAuth-Zugriffstoken, das die Anmeldeinformationen des neuen Administratorbenutzers darstellt, der während der Registrierung erstellt wird. Kunden in der nahtlosen Einrichtung des Clientkontos und des PI-Pilotprojekts müssen eine oder mehrere der UserId oder UserInvitation oder User festlegen. Die erforderlichen Felder im User-Objekt sind ContactInfo.Email, Name.FirstName, Name.LastName und AuthenticationToken. |
Benutzer |
| UserId | Der Bezeichner eines vorhandenen Benutzers, der dem neuen Kunden als Super Admin hinzugefügt wird. Dieses Element ist nur für Kunden im geschlossenen Pilotversuch einheitlicher intelligenter Kampagnen verfügbar. Mindestens ein UserId - oder UserInvitation-Element muss festgelegt werden. |
lang |
| UserInvitation | Die Benutzerinladung zu senden, wenn Sie einen neuen Kunden im Namen eines Kunden registrieren und optional mit dem neuen Konto als Agentur verknüpfen möchten. Ein Super Admin-Clientbenutzer muss die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche ausführen, z. B. die Bedingungen akzeptieren. Dieses Element ist für Agenturkunden im Pilotprojekt Erstellen von Konten im Auftrag des Kunden optional. Kunden im geschlossenen Unified Smart Campaigns-Pilot müssen mindestens ein UserId - oder UserInvitation-Element festlegen. |
UserInvitation |
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 SignupCustomerResponse-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. |
lang |
| 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 |
| CustomerId | Eine vom System generierte Kunden-ID, die dem in der Anforderung angegebenen neuen Kunden entspricht. Verwenden Sie diesen Bezeichner für Vorgangsanforderungen, die ein CustomerId-SOAP-Headerelement erfordern. |
lang |
| CustomerNumber | Eine vom System generierte Kundennummer, die in der Microsoft Advertising-Webanwendung verwendet wird. Die Kundennummer hat das Format xxxxxxxxxxxx, wobei xxxxxxxxxx eine Reihe von zehn alphanumerischen Zeichen ist. |
Zeichenfolge |
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">SignupCustomer</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<SignupCustomerRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<Customer xmlns:e559="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e559:CustomerFinancialStatus i:nil="false">ValueHere</e559:CustomerFinancialStatus>
<e559:Id i:nil="false">ValueHere</e559:Id>
<e559:Industry i:nil="false">ValueHere</e559:Industry>
<e559:LastModifiedByUserId i:nil="false">ValueHere</e559:LastModifiedByUserId>
<e559:LastModifiedTime i:nil="false">ValueHere</e559:LastModifiedTime>
<e559:MarketCountry i:nil="false">ValueHere</e559:MarketCountry>
<e559:ForwardCompatibilityMap xmlns:e560="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e560:KeyValuePairOfstringstring>
<e560:key i:nil="false">ValueHere</e560:key>
<e560:value i:nil="false">ValueHere</e560:value>
</e560:KeyValuePairOfstringstring>
</e559:ForwardCompatibilityMap>
<e559:MarketLanguage i:nil="false">ValueHere</e559:MarketLanguage>
<e559:Name i:nil="false">ValueHere</e559:Name>
<e559:ServiceLevel i:nil="false">ValueHere</e559:ServiceLevel>
<e559:CustomerLifeCycleStatus i:nil="false">ValueHere</e559:CustomerLifeCycleStatus>
<e559:TimeStamp i:nil="false">ValueHere</e559:TimeStamp>
<e559:Number i:nil="false">ValueHere</e559:Number>
<e559:CustomerAddress i:nil="false">
<e559:City i:nil="false">ValueHere</e559:City>
<e559:CountryCode i:nil="false">ValueHere</e559:CountryCode>
<e559:Id i:nil="false">ValueHere</e559:Id>
<e559:Line1 i:nil="false">ValueHere</e559:Line1>
<e559:Line2 i:nil="false">ValueHere</e559:Line2>
<e559:Line3 i:nil="false">ValueHere</e559:Line3>
<e559:Line4 i:nil="false">ValueHere</e559:Line4>
<e559:PostalCode i:nil="false">ValueHere</e559:PostalCode>
<e559:StateOrProvince i:nil="false">ValueHere</e559:StateOrProvince>
<e559:TimeStamp i:nil="false">ValueHere</e559:TimeStamp>
<e559:BusinessName i:nil="false">ValueHere</e559:BusinessName>
</e559:CustomerAddress>
</Customer>
<Account xmlns:e561="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e561:BillToCustomerId i:nil="false">ValueHere</e561:BillToCustomerId>
<e561:CurrencyCode i:nil="false">ValueHere</e561:CurrencyCode>
<e561:AccountFinancialStatus i:nil="false">ValueHere</e561:AccountFinancialStatus>
<e561:Id i:nil="false">ValueHere</e561:Id>
<e561:Language i:nil="false">ValueHere</e561:Language>
<e561:LastModifiedByUserId i:nil="false">ValueHere</e561:LastModifiedByUserId>
<e561:LastModifiedTime i:nil="false">ValueHere</e561:LastModifiedTime>
<e561:Name i:nil="false">ValueHere</e561:Name>
<e561:Number i:nil="false">ValueHere</e561:Number>
<e561:ParentCustomerId>ValueHere</e561:ParentCustomerId>
<e561:PaymentMethodId i:nil="false">ValueHere</e561:PaymentMethodId>
<e561:PaymentMethodType i:nil="false">ValueHere</e561:PaymentMethodType>
<e561:PrimaryUserId i:nil="false">ValueHere</e561:PrimaryUserId>
<e561:AccountLifeCycleStatus i:nil="false">ValueHere</e561:AccountLifeCycleStatus>
<e561:TimeStamp i:nil="false">ValueHere</e561:TimeStamp>
<e561:TimeZone i:nil="false">ValueHere</e561:TimeZone>
<e561:PauseReason i:nil="false">ValueHere</e561:PauseReason>
<e561:ForwardCompatibilityMap xmlns:e562="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e562:KeyValuePairOfstringstring>
<e562:key i:nil="false">ValueHere</e562:key>
<e562:value i:nil="false">ValueHere</e562:value>
</e562:KeyValuePairOfstringstring>
</e561:ForwardCompatibilityMap>
<e561:LinkedAgencies i:nil="false">
<e561:CustomerInfo>
<e561:Id i:nil="false">ValueHere</e561:Id>
<e561:Name i:nil="false">ValueHere</e561:Name>
</e561:CustomerInfo>
</e561:LinkedAgencies>
<e561:SalesHouseCustomerId i:nil="false">ValueHere</e561:SalesHouseCustomerId>
<e561:TaxInformation xmlns:e563="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e563:KeyValuePairOfstringstring>
<e563:key i:nil="false">ValueHere</e563:key>
<e563:value i:nil="false">ValueHere</e563:value>
</e563:KeyValuePairOfstringstring>
</e561:TaxInformation>
<e561:BackUpPaymentInstrumentId i:nil="false">ValueHere</e561:BackUpPaymentInstrumentId>
<e561:BillingThresholdAmount i:nil="false">ValueHere</e561:BillingThresholdAmount>
<e561:BusinessAddress i:nil="false">
<e561:City i:nil="false">ValueHere</e561:City>
<e561:CountryCode i:nil="false">ValueHere</e561:CountryCode>
<e561:Id i:nil="false">ValueHere</e561:Id>
<e561:Line1 i:nil="false">ValueHere</e561:Line1>
<e561:Line2 i:nil="false">ValueHere</e561:Line2>
<e561:Line3 i:nil="false">ValueHere</e561:Line3>
<e561:Line4 i:nil="false">ValueHere</e561:Line4>
<e561:PostalCode i:nil="false">ValueHere</e561:PostalCode>
<e561:StateOrProvince i:nil="false">ValueHere</e561:StateOrProvince>
<e561:TimeStamp i:nil="false">ValueHere</e561:TimeStamp>
<e561:BusinessName i:nil="false">ValueHere</e561:BusinessName>
</e561:BusinessAddress>
<e561:AutoTagType i:nil="false">ValueHere</e561:AutoTagType>
<e561:SoldToPaymentInstrumentId i:nil="false">ValueHere</e561:SoldToPaymentInstrumentId>
<e561:TaxCertificate i:nil="false">
<e561:TaxCertificateBlobContainerName i:nil="false">ValueHere</e561:TaxCertificateBlobContainerName>
<e561:TaxCertificates xmlns:e564="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e564:KeyValuePairOfstringbase64Binary>
<e564:key i:nil="false">ValueHere</e564:key>
<e564:value i:nil="false">ValueHere</e564:value>
</e564:KeyValuePairOfstringbase64Binary>
</e561:TaxCertificates>
<e561:Status i:nil="false">ValueHere</e561:Status>
</e561:TaxCertificate>
<e561:AccountMode i:nil="false">ValueHere</e561:AccountMode>
</Account>
<ParentCustomerId i:nil="false">ValueHere</ParentCustomerId>
<UserInvitation xmlns:e565="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e565:Id>ValueHere</e565:Id>
<e565:FirstName i:nil="false">ValueHere</e565:FirstName>
<e565:LastName i:nil="false">ValueHere</e565:LastName>
<e565:Email i:nil="false">ValueHere</e565:Email>
<e565:CustomerId>ValueHere</e565:CustomerId>
<e565:RoleId>ValueHere</e565:RoleId>
<e565:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</e565:AccountIds>
<e565:ExpirationDate>ValueHere</e565:ExpirationDate>
<e565:Lcid>ValueHere</e565:Lcid>
</UserInvitation>
<UserId i:nil="false">ValueHere</UserId>
<User xmlns:e566="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e566:ContactInfo i:nil="false">
<e566:Address i:nil="false">
<e566:City i:nil="false">ValueHere</e566:City>
<e566:CountryCode i:nil="false">ValueHere</e566:CountryCode>
<e566:Id i:nil="false">ValueHere</e566:Id>
<e566:Line1 i:nil="false">ValueHere</e566:Line1>
<e566:Line2 i:nil="false">ValueHere</e566:Line2>
<e566:Line3 i:nil="false">ValueHere</e566:Line3>
<e566:Line4 i:nil="false">ValueHere</e566:Line4>
<e566:PostalCode i:nil="false">ValueHere</e566:PostalCode>
<e566:StateOrProvince i:nil="false">ValueHere</e566:StateOrProvince>
<e566:TimeStamp i:nil="false">ValueHere</e566:TimeStamp>
<e566:BusinessName i:nil="false">ValueHere</e566:BusinessName>
</e566:Address>
<e566:ContactByPhone i:nil="false">ValueHere</e566:ContactByPhone>
<e566:ContactByPostalMail i:nil="false">ValueHere</e566:ContactByPostalMail>
<e566:Email i:nil="false">ValueHere</e566:Email>
<e566:EmailFormat i:nil="false">ValueHere</e566:EmailFormat>
<e566:Fax i:nil="false">ValueHere</e566:Fax>
<e566:HomePhone i:nil="false">ValueHere</e566:HomePhone>
<e566:Id i:nil="false">ValueHere</e566:Id>
<e566:Mobile i:nil="false">ValueHere</e566:Mobile>
<e566:Phone1 i:nil="false">ValueHere</e566:Phone1>
<e566:Phone2 i:nil="false">ValueHere</e566:Phone2>
</e566:ContactInfo>
<e566:CustomerId i:nil="false">ValueHere</e566:CustomerId>
<e566:Id i:nil="false">ValueHere</e566:Id>
<e566:JobTitle i:nil="false">ValueHere</e566:JobTitle>
<e566:LastModifiedByUserId i:nil="false">ValueHere</e566:LastModifiedByUserId>
<e566:LastModifiedTime i:nil="false">ValueHere</e566:LastModifiedTime>
<e566:Lcid i:nil="false">ValueHere</e566:Lcid>
<e566:Name i:nil="false">
<e566:FirstName i:nil="false">ValueHere</e566:FirstName>
<e566:LastName i:nil="false">ValueHere</e566:LastName>
<e566:MiddleInitial i:nil="false">ValueHere</e566:MiddleInitial>
</e566:Name>
<e566:Password i:nil="false">ValueHere</e566:Password>
<e566:SecretAnswer i:nil="false">ValueHere</e566:SecretAnswer>
<e566:SecretQuestion>ValueHere</e566:SecretQuestion>
<e566:UserLifeCycleStatus i:nil="false">ValueHere</e566:UserLifeCycleStatus>
<e566:TimeStamp i:nil="false">ValueHere</e566:TimeStamp>
<e566:UserName i:nil="false">ValueHere</e566:UserName>
<e566:ForwardCompatibilityMap xmlns:e567="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e567:KeyValuePairOfstringstring>
<e567:key i:nil="false">ValueHere</e567:key>
<e567:value i:nil="false">ValueHere</e567:value>
</e567:KeyValuePairOfstringstring>
</e566:ForwardCompatibilityMap>
<e566:AuthenticationToken i:nil="false">ValueHere</e566:AuthenticationToken>
</User>
</SignupCustomerRequest>
</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>
<SignupCustomerResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<CustomerId>ValueHere</CustomerId>
<CustomerNumber d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</CustomerNumber>
<AccountId d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</AccountId>
<AccountNumber d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</AccountNumber>
<CreateTime>ValueHere</CreateTime>
</SignupCustomerResponse>
</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<SignupCustomerResponse> SignupCustomerAsync(
Customer customer,
AdvertiserAccount account,
long? parentCustomerId,
UserInvitation userInvitation,
long? userId,
User user)
{
var request = new SignupCustomerRequest
{
Customer = customer,
Account = account,
ParentCustomerId = parentCustomerId,
UserInvitation = userInvitation,
UserId = userId,
User = user
};
return (await CustomerManagementService.CallAsync((s, r) => s.SignupCustomerAsync(r), request));
}
static SignupCustomerResponse signupCustomer(
Customer customer,
AdvertiserAccount account,
java.lang.Long parentCustomerId,
UserInvitation userInvitation,
java.lang.Long userId,
User user) throws RemoteException, Exception
{
SignupCustomerRequest request = new SignupCustomerRequest();
request.setCustomer(customer);
request.setAccount(account);
request.setParentCustomerId(parentCustomerId);
request.setUserInvitation(userInvitation);
request.setUserId(userId);
request.setUser(user);
return CustomerManagementService.getService().signupCustomer(request);
}
static function SignupCustomer(
$customer,
$account,
$parentCustomerId,
$userInvitation,
$userId,
$user)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new SignupCustomerRequest();
$request->Customer = $customer;
$request->Account = $account;
$request->ParentCustomerId = $parentCustomerId;
$request->UserInvitation = $userInvitation;
$request->UserId = $userId;
$request->User = $user;
return $GLOBALS['CustomerManagementProxy']->GetService()->SignupCustomer($request);
}
response=customermanagement_service.SignupCustomer(
Customer=Customer,
Account=Account,
ParentCustomerId=ParentCustomerId,
UserInvitation=UserInvitation,
UserId=UserId,
User=User)
Anforderungen
Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
Anforderungs-URL
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/Customer/Signup
Anfordern von Elementen
Das SignupCustomerRequest-Objekt definiert den Text und die Headerelemente der Dienstvorgangsanforderung.
Hinweis
Sofern unten nicht anders angegeben, sind alle Anforderungselemente erforderlich.
Anforderungstextelemente
| Element | Beschreibung | Datentyp |
|---|---|---|
| Konto | Ein AdvertiserAccount , das die Details des primären Kontos des Kunden angibt. Kunden im geschlossenen Pilotversuch "Unified Smart Campaigns" müssen das AccountMode-Element auf "UnifiedSmart" festlegen. |
AdvertiserAccount |
| Kunde | Ein Kunde , der die Details des Kunden angibt, den Sie hinzufügen. | Kunde |
| ParentCustomerId | Die Kunden-ID des Aggregators oder der Agentur, der den neuen untergeordneten Kunden verwaltet. Dieses Element ist für Aggregatoren erforderlich, wird aber für Agenturen ignoriert, wenn das UserInvitation-Anforderungselement festgelegt ist. Kunden im geschlossenen Pilotversuch unified smart campaigns können den neuen Kunden mit der ID der übergeordneten Agentur verknüpfen oder dieses Element leer lassen. |
lang |
| Benutzer | Der zu erstellende Benutzer. Sie können dieses Element erfüllen, wenn Sie einen neuen Kunden registrieren und gleichzeitig einen neuen Administratorbenutzer erstellen möchten. Nachdem der neue Kunde registriert wurde, muss der neu erstellte Administratorbenutzer die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche auf der Microsoft Advertising-Kundenseite ausführen, auf der die Kundenseite aktiviert wird. Die URL lautet https://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}& aid={new_account_Id} , wobei new_customer_Id und new_account_Id die IDs sind, die Sie in SignupCustomerResponse erhalten. Das AuthenticationToken im User-Element ist das OAuth-Zugriffstoken, das die Anmeldeinformationen des neuen Administratorbenutzers darstellt, der während der Registrierung erstellt wird. Kunden in der nahtlosen Einrichtung des Clientkontos und des PI-Pilotprojekts müssen eine oder mehrere der UserId oder UserInvitation oder User festlegen. Die erforderlichen Felder im User-Objekt sind ContactInfo.Email, Name.FirstName, Name.LastName und AuthenticationToken. |
Benutzer |
| UserId | Der Bezeichner eines vorhandenen Benutzers, der dem neuen Kunden als Super Admin hinzugefügt wird. Dieses Element ist nur für Kunden im geschlossenen Pilotversuch einheitlicher intelligenter Kampagnen verfügbar. Mindestens ein UserId - oder UserInvitation-Element muss festgelegt werden. |
lang |
| UserInvitation | Die Benutzerinladung zu senden, wenn Sie einen neuen Kunden im Namen eines Kunden registrieren und optional mit dem neuen Konto als Agentur verknüpfen möchten. Ein Super Admin-Clientbenutzer muss die Registrierungsschritte über die Microsoft Advertising-Benutzeroberfläche ausführen, z. B. die Bedingungen akzeptieren. Dieses Element ist für Agenturkunden im Pilotprojekt Erstellen von Konten im Auftrag des Kunden optional. Kunden im geschlossenen Unified Smart Campaigns-Pilot müssen mindestens ein UserId - oder UserInvitation-Element festlegen. |
UserInvitation |
Anforderungsheaderelemente
| Element | Beschreibung | Datentyp |
|---|---|---|
| Authorization | Das OAuth-Zugriffstoken, das die Anmeldeinformationen eines Benutzers darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Stellen Sie sicher, dass dem Token das Präfix "Bearer" vorangestellt ist. Dies ist für die ordnungsgemäße Authentifizierung erforderlich. 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 SignupCustomerResponse-Objekt definiert den Text und die Headerelemente der Dienstvorgangsantwort. Die Elemente werden in der gleichen Reihenfolge zurückgegeben wie im Antwort-JSON-Code gezeigt.
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. |
lang |
| 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 |
| CustomerId | Eine vom System generierte Kunden-ID, die dem in der Anforderung angegebenen neuen Kunden entspricht. Verwenden Sie diesen Bezeichner für Vorgangsanforderungen, die ein CustomerId-SOAP-Headerelement erfordern. |
lang |
| CustomerNumber | Eine vom System generierte Kundennummer, die in der Microsoft Advertising-Webanwendung verwendet wird. Die Kundennummer hat das Format xxxxxxxxxxxx, wobei xxxxxxxxxx eine Reihe von zehn alphanumerischen Zeichen ist. |
Zeichenfolge |
Antwortheaderelemente
| Element | Beschreibung | Datentyp |
|---|---|---|
| TrackingId | Der Bezeichner des Protokolleintrags, der die Details des API-Aufrufs enthält. | Zeichenfolge |
JSON anfordern
Diese Vorlage wurde von einem Tool generiert, um die Text- und Headerelemente für die JSON-Anforderung anzuzeigen. Informationen zu unterstützten Typen, die Sie mit diesem Dienstvorgang verwenden können, finden Sie oben in der Referenz zu Anforderungstextelementen .
{
"Customer": {
"CustomerAddress": {
"BusinessName": "ValueHere",
"City": "ValueHere",
"CountryCode": "ValueHere",
"Id": "LongValueHere",
"Line1": "ValueHere",
"Line2": "ValueHere",
"Line3": "ValueHere",
"Line4": "ValueHere",
"PostalCode": "ValueHere",
"StateOrProvince": "ValueHere",
"TimeStamp": "ValueHere"
},
"CustomerFinancialStatus": "ValueHere",
"CustomerLifeCycleStatus": "ValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"Id": "LongValueHere",
"Industry": "ValueHere",
"LastModifiedByUserId": "LongValueHere",
"LastModifiedTime": "ValueHere",
"MarketCountry": "ValueHere",
"MarketLanguage": "ValueHere",
"Name": "ValueHere",
"Number": "ValueHere",
"ServiceLevel": "ValueHere",
"TimeStamp": "ValueHere"
},
"Account": {
"AccountFinancialStatus": "ValueHere",
"AccountLifeCycleStatus": "ValueHere",
"AccountMode": "ValueHere",
"AutoTagType": "ValueHere",
"BackUpPaymentInstrumentId": "LongValueHere",
"BillingThresholdAmount": DecimalValueHere,
"BillToCustomerId": "LongValueHere",
"BusinessAddress": {
"BusinessName": "ValueHere",
"City": "ValueHere",
"CountryCode": "ValueHere",
"Id": "LongValueHere",
"Line1": "ValueHere",
"Line2": "ValueHere",
"Line3": "ValueHere",
"Line4": "ValueHere",
"PostalCode": "ValueHere",
"StateOrProvince": "ValueHere",
"TimeStamp": "ValueHere"
},
"CurrencyCode": "ValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"Id": "LongValueHere",
"Language": "ValueHere",
"LastModifiedByUserId": "LongValueHere",
"LastModifiedTime": "ValueHere",
"LinkedAgencies": [
{
"Id": "LongValueHere",
"Name": "ValueHere"
}
],
"Name": "ValueHere",
"Number": "ValueHere",
"ParentCustomerId": "LongValueHere",
"PauseReason": "ValueHere",
"PaymentMethodId": "LongValueHere",
"PaymentMethodType": "ValueHere",
"PrimaryUserId": "LongValueHere",
"SalesHouseCustomerId": "LongValueHere",
"SoldToPaymentInstrumentId": "LongValueHere",
"TaxCertificate": {
"Status": "ValueHere",
"TaxCertificateBlobContainerName": "ValueHere",
"TaxCertificates": [
{
"key": "ValueHere",
"value": "ValueHere"
}
]
},
"TaxInformation": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"TimeStamp": "ValueHere",
"TimeZone": "ValueHere"
},
"ParentCustomerId": "LongValueHere",
"UserInvitation": {
"AccountIds": [
"LongValueHere"
],
"CustomerId": "LongValueHere",
"Email": "ValueHere",
"ExpirationDate": "ValueHere",
"FirstName": "ValueHere",
"Id": "LongValueHere",
"LastName": "ValueHere",
"Lcid": "ValueHere",
"RoleId": IntValueHere
},
"UserId": "LongValueHere",
"User": {
"AuthenticationToken": "ValueHere",
"ContactInfo": {
"Address": {
"BusinessName": "ValueHere",
"City": "ValueHere",
"CountryCode": "ValueHere",
"Id": "LongValueHere",
"Line1": "ValueHere",
"Line2": "ValueHere",
"Line3": "ValueHere",
"Line4": "ValueHere",
"PostalCode": "ValueHere",
"StateOrProvince": "ValueHere",
"TimeStamp": "ValueHere"
},
"ContactByPhone": "ValueHere",
"ContactByPostalMail": "ValueHere",
"Email": "ValueHere",
"EmailFormat": "ValueHere",
"Fax": "ValueHere",
"HomePhone": "ValueHere",
"Id": "LongValueHere",
"Mobile": "ValueHere",
"Phone1": "ValueHere",
"Phone2": "ValueHere"
},
"CustomerId": "LongValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"Id": "LongValueHere",
"JobTitle": "ValueHere",
"LastModifiedByUserId": "LongValueHere",
"LastModifiedTime": "ValueHere",
"Lcid": "ValueHere",
"Name": {
"FirstName": "ValueHere",
"LastName": "ValueHere",
"MiddleInitial": "ValueHere"
},
"Password": "ValueHere",
"SecretAnswer": "ValueHere",
"SecretQuestion": "ValueHere",
"TimeStamp": "ValueHere",
"UserLifeCycleStatus": "ValueHere",
"UserName": "ValueHere"
}
}
Antwort-JSON
Diese Vorlage wurde von einem Tool generiert, um die Text- und Headerelemente für die JSON-Antwort anzuzeigen.
{
"CustomerId": "LongValueHere",
"CustomerNumber": "ValueHere",
"AccountId": "LongValueHere",
"AccountNumber": "ValueHere",
"CreateTime": "ValueHere"
}
Codesyntax
Um die REST-API über SDKs aufzurufen, müssen Sie das SDK auf eine bestimmte Version aktualisieren und die Systemparameter konfigurieren. Die Beispielsyntax kann mit Bing Ads SDKs verwendet werden. Weitere Beispiele finden Sie unter Codebeispiele für die Bing Ads-API .
public async Task<SignupCustomerResponse> SignupCustomerAsync(
Customer customer,
AdvertiserAccount account,
long? parentCustomerId,
UserInvitation userInvitation,
long? userId,
User user)
{
var request = new SignupCustomerRequest
{
Customer = customer,
Account = account,
ParentCustomerId = parentCustomerId,
UserInvitation = userInvitation,
UserId = userId,
User = user
};
return (await CustomerManagementService.CallAsync((s, r) => s.SignupCustomerAsync(r), request));
}
static SignupCustomerResponse signupCustomer(
Customer customer,
AdvertiserAccount account,
java.lang.Long parentCustomerId,
UserInvitation userInvitation,
java.lang.Long userId,
User user) throws RemoteException, Exception
{
SignupCustomerRequest request = new SignupCustomerRequest();
request.setCustomer(customer);
request.setAccount(account);
request.setParentCustomerId(parentCustomerId);
request.setUserInvitation(userInvitation);
request.setUserId(userId);
request.setUser(user);
return CustomerManagementService.getService().signupCustomer(request);
}
static function SignupCustomer(
$customer,
$account,
$parentCustomerId,
$userInvitation,
$userId,
$user)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new SignupCustomerRequest();
$request->Customer = $customer;
$request->Account = $account;
$request->ParentCustomerId = $parentCustomerId;
$request->UserInvitation = $userInvitation;
$request->UserId = $userId;
$request->User = $user;
return $GLOBALS['CustomerManagementProxy']->GetService()->SignupCustomer($request);
}
response=customermanagement_service.SignupCustomer(
Customer=Customer,
Account=Account,
ParentCustomerId=ParentCustomerId,
UserInvitation=UserInvitation,
UserId=UserId,
User=User)