AddAccount Hizmeti İşlemi - Müşteri Yönetimi

Makale
12/21/2023

Mevcut müşteri içinde yeni bir hesap oluşturur.

Süper Yönetici kimlik bilgilerine sahip bir kullanıcı kendi müşterisinin altına hesap ekleyebilir.

İpucu

Kurumsal bayiler genellikle AddAccount yerine SignupCustomer'ı aramalıdır. Daha fazla ayrıntı için Hesap Hiyerarşisi teknik kılavuzuna bakın.

Not

Kapatılan Birleşik akıllı kampanya pilotundaki müşteriler Birleşik akıllı kampanyalar için yeni bir hesap ekleyebilir. AccountMode "UnifiedSmart" olarak ayarlanmalıdır.

İstek Öğeleri

AddAccountRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
Hesabı	Mevcut müşteriye eklemek istediğiniz hesap. Reklamveren hesabı nesnesinde ParentCustomerId değerini ayarlamanız gerekir.	ReklamverenHesap

İstek Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
AuthenticationToken	Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.	Dize
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	Dize
Password	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize
Username	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize

Yanıt Öğeleri

AddAccountResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
AccountId	İstekte belirtilen yeni hesaba karşılık gelen sistem tarafından oluşturulan hesap tanımlayıcısı. AccountId gövde öğesi ve CustomerAccountId SOAP üst bilgi öğesi gerektiren işlem istekleriyle bu tanımlayıcıyı kullanın.	Uzun
AccountNumber	Microsoft Advertising web uygulamasında hesabı tanımlamak için kullanılan sistem tarafından oluşturulan hesap numarası. Hesap numarası xxxxxx biçimindedir. Burada xxxxxxxxx , sekiz alfasayısal karakterden oluşan bir seridir.	Dize
CreateTime	Hesabın eklendiği tarih ve saat. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.	Datetime

Yanıt Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
TrackingId	API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı.	Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<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>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<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>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

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)

Gereksinimler

Hizmet: CustomerManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/Customer/v13

Aracılığıyla paylaş