儲者帳戶數據物件 - 客戶管理
定義廣告商帳戶。
語法
<xs:complexType name="AdvertiserAccount" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="BillToCustomerId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="tns:CurrencyCode" />
<xs:element minOccurs="0" name="AccountFinancialStatus" nillable="true" type="tns:AccountFinancialStatus" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Language" nillable="true" type="tns:LanguageType" />
<xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ParentCustomerId" type="xs:long" />
<xs:element minOccurs="0" name="PaymentMethodId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="PaymentMethodType" nillable="true" type="tns:PaymentMethodType" />
<xs:element minOccurs="0" name="PrimaryUserId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="AccountLifeCycleStatus" nillable="true" type="tns:AccountLifeCycleStatus" />
<xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="tns:TimeZoneType" />
<xs:element minOccurs="0" name="PauseReason" nillable="true" type="xs:unsignedByte" />
<xs:element xmlns:q1="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q1:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="LinkedAgencies" nillable="true" type="tns:ArrayOfCustomerInfo" />
<xs:element minOccurs="0" name="SalesHouseCustomerId" nillable="true" type="xs:long" />
<xs:element xmlns:q2="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="TaxInformation" nillable="true" type="q2:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="BackUpPaymentInstrumentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="BillingThresholdAmount" nillable="true" type="xs:decimal" />
<xs:element minOccurs="0" name="BusinessAddress" nillable="true" type="tns:Address" />
<xs:element minOccurs="0" name="AutoTagType" nillable="true" type="tns:AutoTagType" />
<xs:element minOccurs="0" name="SoldToPaymentInstrumentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="TaxCertificate" nillable="true" type="tns:AccountTaxCertificate">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="AccountMode" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
元素
MarketplaceAccount 物件具有下列元素：AccountFinancialStatus、AccountLifeCycleStatus、AccountMode、AutoTagType、BackUpPaymentInstrumentId、BillingThresholdAmount、BillToCustomerId、BusinessAddress、CurrencyCode、ForwardCompatibilityMap、Id、Language、LastModifiedByUserId、LastModifiedTime、LinkedAgencies、Name、Number、ParentCustomerId、PauseReason、PaymentMethodId、PaymentMethodType、PrimaryUserId、SalesHouseCustomerId、SoldToPaymentInstrumentId、TaxCertificate、TaxInformation、TimeStamp、TimeZone。
| 元素 | 描述 | 資料類型 |
|---|---|---|
| AccountFinancialStatus | 帳戶的財務狀態。 例如，狀態可以指出帳戶是否處於良好狀態或已逾期。 加： 唯讀 更新： 唯讀 |
AccountFinancialStatus |
| AccountLifeCycleStatus | 帳戶的狀態。 您無法設定帳戶的狀態。 加： 唯讀 更新： 唯讀 |
AccountLifeCycleStatus |
| AccountMode | 帳戶模式會區分智慧型和專家帳戶。 可能的值包括但不限於： 專家 - 專家模式是廣告體驗Microsoft完整功能。 它可讓您更充分掌控營銷活動管理、讓您將更多內容新增至廣告，以及提供更多效能報告和追蹤的方式。 Smart - Microsoft Advertising 將使用 Microsoft AI 為您建立廣告及管理廣告營銷活動。 UnifiedSmart - 此帳戶支援 Bing、Google 和 Facebook 之間的廣告。 您也可以在 Facebook、LinkedIn 上管理您的社交網路存在狀態。 注意：自 2023 年 4 月 25 日起，UnifiedSmart 不再支援 Twitter。 大部分的 Bing 廣告 API 作業僅支援專家帳戶。 當您要求帳戶資訊時，會傳回具有任何帳戶模式的帳戶，例如 FindAccountsOrCustomersInfo、 GetAccount、 GetAccountsInfo、 GetUser 和 SearchAccounts。 加： 大部分帳戶的唯讀。 處於封閉整合智慧營銷活動試驗的客戶可以將帳戶模式設定為 「UnifiedSmart」。。 更新： 唯讀 |
string |
| AutoTagType | 決定是否要附加或取代支援的 UTM 追蹤程式代碼。 Microsoft Advertising 可以自動將 UTM 標籤新增至您的目的地 URL，讓您可以使用您的網站分析工具，例如 Google Analytics，追蹤人員如何前往您的網站。 例如，自動標記會套用至展開的文字廣告、關鍵詞、Microsoft購物活動和網站連結延伸模組。 如需自動標記的詳細資訊，請參閱 Microsoft Advertising 說明文章 如何? 將 UTM 標籤新增至登陸頁面 URL？。 加： 自選。 如果未指定，則預設值為 [非使用中]。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
AutoTagType |
| BackUpPaymentInstrumentId | 用來結算帳戶的備份付款方式標識碼。 此元素不適用於已開立發票的帳戶。 加： 唯讀 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
長 |
| BillingThresholdAmount | 客戶針對所選付款方式的結算指定金額。 加： 唯讀 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
十進位 |
| BillToCustomerId | 客戶的標識碼，此標識碼會針對帳戶產生的費用計費。 這是代表擁有者管理此帳戶的匯總工具，或是擁有帳戶的客戶標識符。 服務會根據 PaymentMethodId 元素中識別的付款方式擁有者來設定標識碼。 加： 唯讀 更新： 唯讀 |
長 |
| BusinessAddress | 貴公司在法律上註冊的位置。 如果您是做為客戶代理程序的機構，這就是您客戶在法律上註冊的位置。 如果您是做為匯總者的機構，這是貴公司在法律上註冊的商務位址。 商務地址可用來判斷您的稅務需求。 加： 必填。 所有國家或地區都需要 Address BusinessName、City 和 Line1 元素。 對於巴西 (BR) 和印度 (IN) ，也需要 PostalCode 和 StateOrProvince 元素。 更新： 對於未按月發票計費的帳戶，則為選擇性。 說過，如果您想要對 Address 進行任何變更，則必須在適用的) (設定其 BusinessName、City、CountryCode、Line1 和 StateOrProvince 元素;每月發票帳戶的唯讀。 若要更新發票帳戶的 BusinessAddress ，請連絡您的帳戶管理員或支持人員。 |
Address |
| CurrencyCode | 用來結算帳戶之貨幣的 ISO 代碼。 服務會使用貨幣信息來進行計費。 加： 必填 更新： 唯讀 |
CurrencyCode |
| ForwardCompatibilityMap | 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。 |
KeyValuePairOfstringstring 陣 列 |
| 標識碼 | 系統產生的帳戶標識碼。 這是您在許多營銷活動要求中將 AccountId 元素和 CustomerAccountId SOAP 標頭設定為 的識別碼。 加： 唯讀 更新： 必填 |
長 |
| 語言 | 如果您使用發票做為付款方式) ，用以轉譯您從 Microsoft Advertising (收到的帳單文件的語言。 此設定僅適用於此帳戶的計費檔，不適用於您可能擁有的其他 Microsoft Advertising 帳戶。 如果您在註冊客戶時將此專案保留空白，作業會使用主要使用者 之 Lcid 元素的語言值。 如果 Lcid 設定為 FrenchCanada 之類的值，則帳戶語言會設定為 法文。 加：AddAccount 的只讀;如果已設定 UserInvitation，則 SignupCustomer 為必要項，否則此元素為 Optional。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
LanguageType |
| LastModifiedByUserId | 要更新帳戶信息的最後一個使用者標識碼。 加： 唯讀 更新： 唯讀 |
長 |
| LastModifiedTime | 上次更新帳戶的日期和時間。 值為國際標準時間 (UTC)。 日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。 加： 唯讀 更新： 唯讀 |
dateTime |
| LinkedAgencies | 連結至此帳戶的機構清單。 當您新增帳戶時，目前僅支援一個代理商客戶。 當您擷取帳戶時，將會包含所有連結的代理商客戶資訊。 加：AddAccount 為選擇性;如果代理商客戶在代表用戶端建立帳戶試驗中，則為 SignupCustomer 的選擇性 (GetCustomerPilotFeatures 會傳回 793) 。 匯總工具無法在此內容中連結為機構，因此無法設定這個專案。 更新： 唯讀 |
CustomerInfo 陣列 |
| 名稱 | 帳戶的名稱。 字串可以包含 3 到 100 個字元，而且在客戶內的所有帳戶名稱中必須是唯一的。 加： 必填 更新： 必填 |
string |
| 數字 | 系統產生的帳戶號碼，用來識別 Microsoft Advertising Web 應用程式中的帳戶。 帳戶編號的格式為 xxxxxxxxxx，其中 xxxxxxxxxx 是任何八個英數位元數的序列。 加： 唯讀 更新： 唯讀 |
string |
| ParentCustomerId | 擁有帳戶之客戶的標識碼。 在需要客戶標識碼的營銷活動要求中，這是您設定 CustomerId SOAP 標頭的標識碼。 加：AddAccount 的必要項;如果未設定 UserInvitation，則為 SignupCustomer 的必要項目，否則會忽略這個專案。 更新： 唯讀 |
長 |
| PauseReason | 旗標值，指出暫停帳戶的人員。 可能的值如下： 1 - 使用者已暫停帳戶。 2 - 計費服務已暫停帳戶。 4 - 使用者和計費服務已暫停帳戶。 加： 唯讀 更新： 唯讀 |
unsignedByte |
| PaymentMethodId | 用來結算帳戶之付款方式的標識碼。 加：AddAccount 為選擇性;如果未設定 UserInvitation，則為 SignupCustomer 只讀。 當您呼叫 SignupCustomer 時 ，請將此元素設定為 NULL。 服務會自動挑選與匯總工具客戶發票相關聯的付款方式標識碼。 若 為 SignupCustomer ，如果已設定 UserInvitation ，且新的用戶端帳戶正透過 LinkedAgencies 連結至代理商，而且如果應該向代理商收費，請將此元素設定為代理商的付款方式標識符。 否則，您應該將此元素保留為 null。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
長 |
| PaymentMethodType | 用來結算帳戶的付款方式類型。 您不需要設定此值，因為類型是由對應至 PaymentMethodId 元素的付款方式所決定。 當您呼叫 GetAccount 和 SearchAccounts 以取得帳戶數據時， PaymentMethodType 會設定為 NULL，而且您無法判斷帳戶使用的付款方式。 保留給內部使用。 加： 唯讀 更新： 唯讀 |
PaymentMethodType |
| PrimaryUserId | 主要負責管理此帳戶之帳戶管理員的標識碼。 只有超級 管理員和 Standard 用戶可以設定為帳戶的主要聯繫人。 加： 針對 AddAccount ，如果新的用戶端帳戶正透過 LinkedAgencies 連結至代理程式，則您可以將其中一個機構使用者指派為新帳戶的主要使用者。 當您呼叫 SignupCustomer 做為匯總工具，但不包含 UserInvitation 時，您應該將此元素保留空白，而主要使用者將會設定為匯總工具使用者識別碼。 當您呼叫 SignupCustomer 並包含 UserInvitation 時，您可以將此元素保留空白，而主要用戶會設定為接受邀請之新用戶端使用者的識別碼。 當您呼叫 SignupCustomer 時，如果已設定 UserInvitation ，而且新的用戶端帳戶正透過 LinkedAgencies 連結至代理程式，則您可以將其中一個機構使用者指派為新帳戶的主要使用者。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
長 |
| SalesHouseCustomerId | 負責銷售潛在客戶的第三方標識符。 加： 唯讀 更新： 唯讀 |
長 |
| SoldToPaymentInstrumentId | 用戶端付款方式的標識碼， (要用來結帳的客戶) 。 加：如果 BillToCustomerId 與 ParentCustomerId 不同，則 AddAccount為必要項;唯讀且不適用於 SignupCustomer。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
長 |
| TaxCertificate | 帳戶稅務憑證數據物件。 | AccountTaxCertificate |
| TaxInformation | 如需此元素的有效索引鍵和值字串清單，請參閱下一節中的對應帳戶 稅務資訊 。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要移除索引鍵和值組，請設定索引鍵，然後將值設定為空字串 (“”) 。 |
KeyValuePairOfstringstring 陣 列 |
| 時間戳 | 當您呼叫 UpdateAccount 和 DeleteAccount 作業時，系統在內部用來協調更新的時間戳值。 加： 唯讀 更新： 必填 |
base64Binary |
| TimeZone | 要用於此帳戶中營銷活動的預設時區值。 如果您未在新增帳戶時指定值，則根據預設，時區會設定為 PacificTimeUSCanadaTi方a 。 Microsoft Advertising Web 應用程式會使用此時區值來顯示帳戶時區喜好設定，而且不會為使用大量或營銷活動管理 API 所建立的活動提供預設時區值。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
TimeZoneType |
註解
VatAccount TaxInformation
以下是適用於一個 PublisherAccount 之 TaxInformation 元素的索引鍵清單。
注意事項
Microsoft Advertising 無法提供稅務或加值稅的指引。 如果您有任何問題，請連絡您的稅務顧問或當地稅務機關。
| TaxInformation 金鑰 | 描述 | 國家或地區 |
|---|---|---|
| AUGSTNumber | 澳洲帳戶的稅務標識碼。 如果沒有稅務標識符，可能會根據您的 BusinessAddress 位置來套用稅金。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
澳洲 |
| CCM | 法務實體的註冊號碼，或 (CCM) 的 Cadastro de contribuinte mobiliario。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
巴西 |
| CNPJ | 巴西企業帳戶的稅務標識碼。 如果沒有稅務標識符，可能會根據您的 BusinessAddress 位置來套用稅金。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
巴西 |
| CPF | 巴西個人帳戶的稅務標識碼。 如果沒有稅務標識符，可能會根據您的 BusinessAddress 位置來套用稅金。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
巴西 |
| GSTINNumber | 此標識符的開頭為兩個數位，代表企業註冊的狀態代碼，後面最多 13 個數位和字母。 加： 自選 更新： 自選 |
印度 |
| GSTNumber | 在新加坡，計費是由愛爾蘭Microsoft管理。 自 2020 年 1 月 1 日起，Microsoft Advertising 必須向在新加坡註冊的企業收取新加坡商品和服務稅金 (SG GST) 。 如果您提供 SG GST 註冊號碼，Microsoft Advertising 會以 0% 套用 SG GST。 如果您未提供 SG GST 註冊號碼，Microsoft廣告必須收取 7% 的 SG GST 費用。 (注意：稅率可能會變更。) 可能的 GSTNumber 格式包括：兩個英數位元，後面接著選擇性的虛線，後面接著七個數位，後面接著選擇性的虛線，後面接著一個英數位元;OR 8 或 9 位數，後面接著一個英數位元;OR T 或 S 後面接著兩位數，後面接著一個大寫字母 A - Z，後面接著一個英數位元，後面接著四個數位，後面接著一個英數位元。 GSTNumber 範例：ab-1234567-a;ab1234567-a;ab1234567a;ab-1234567a;12345678a;123456789a;T12Aa1234a 加： 自選 更新： 自選 |
新加坡 |
| IsIVAOrVATTaxPayer | 值為 TRUE 或 FALSE，用於稅務決定。 加： 必填 更新： 必填 |
智利 |
| IsWithholdingTaxExempted | 值為 TRUE 或 FALSE，用於稅務決定。 加： 必填 更新： 必填 |
智利 |
| NZGSTNumber | 這是 8 或 9 位數的長稅標識碼。 如果沒有 NZGSTNumber 稅金，可能會根據您的業務位置來套用。 加： 自選 更新： 唯讀 |
紐西蘭 |
| PanNumber | PAN 編號。 加： 必填 更新： 唯讀 |
印度 |
| VATNumber | 帳戶的加值稅 (VAT) 註冊編號 (也稱為 VAT 識別碼) 。 VAT 編號在您於 BusinessAddress 元素中指定的國家或地區中必須有效。 如果沒有加值稅註冊號碼或豁免憑證，稅金可能會根據您的營業地點來套用。 加： 自選 更新： 自選 |
如需詳細資訊，請參閱 每個國家/地區的加值稅編號格式 。 |
每個國家或地區的 VAT 編號格式
下表列出每個國家或地區的加值稅註冊編號格式。
| VAT 編號 | 國家/地區 |
|---|---|
| 從每個國家/地區特有的 2 個字母開始，後面最多 12 位數或字母。 | 奧地利、比利時、比利時、匈牙利、捷克、德國、丹麥、愛沙尼亞、希臘、芬蘭、法國、英國、克羅埃西亞、匈牙利、愛爾蘭、義大利、立陶宛、荷蘭、拉脫維亞、丹麥、荷蘭、波蘭、葡萄牙、羅馬尼亞、西班牙、瑞典、斯洛維尼亞和斯洛伐克。 |
| 必須是下列格式：XXXXXXXX-X 或 XXXXXXXX-K，其中 X 代表 8 位數，後面接著尾端數位。 | 智利 |
| 必須是下列格式：HUXXXXXXXXXX (，其中胡後面接著 8 個數位) 。 | 匈牙利 |
| 必須是下列格式：LIXXXXX 或 XXXXX (，其中支援這兩種格式，且 LI 為選擇性，且數位數目為 5) 。 | 列支敦斯登 |
| 必須使用下列格式：XXXXXXXX-0001 (，其中8位數早於 -0001) 。 | 奈及利亞 |
| 必須使用下列格式：PTXXXXXXXXXXX (，其中 PT 後面接著 9 位數) 。 | 葡萄牙 |
| 長度為 9 或 13 位數，其中前 8 或 12 位數是實際標識符，最後一個數位是根據 ISO 7064 計算的總和檢查碼數位，MOD 11-10。 | 塞爾維亞 |
| CHE + 9 個數位 + TVA、MWST 或 IVA (例如 CHE-123.456.788 TVA) 。 最後一個數位是以加權模式建置的MOD11總和檢查碼數位：5,4,3,2,7,6,5,4。 | 瑞士 |
| 必須使用下列格式：長度為13位數。 | 泰國 |
需求
服務： CustomerManagementService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities
消費者
AddAccount
GetAccount
SearchAccounts
SignupCustomer
UpdateAccount