广告商帐户数据对象 - 客户管理

项目
11/13/2024

定义广告客户帐户。

语法

XML
JSON

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

{
  "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"
}

元素

AdvertiserAccount 对象具有以下元素：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广告体验。它使你能够更好地控制市场活动管理，使你能够向广告添加更多内容，并在性能报告和跟踪方面提供更多内容。智能 - Microsoft广告将使用Microsoft AI 为你创建广告和管理广告活动。 UnifiedSmart - 该帐户支持跨必应、Google 和Facebook进行广告。还可以管理 Facebook、Instagram 和 LinkedIn 上的社交网络状态。注意：从 2023 年 4 月 25 日起，UnifiedSmart 不再支持 Twitter。大多数必应广告 API 操作仅支持专家帐户。当你请求帐户信息（例如 FindAccountsOrCustomersInfo、GetAccount、GetAccountsInfo、GetUser 和 SearchAccounts）时，将返回具有任何帐户模式的帐户。加：大多数帐户为只读。已关闭的统一智能市场活动试点的客户可以将帐户模式设置为“UnifiedSmart”。更新：只读	string
AutoTagType	确定是追加还是替换支持的 UTM 跟踪代码。 Microsoft广告可以自动将 UTM 标记添加到目标 URL，以便你可以使用网站分析工具（例如 Google Analytics）跟踪用户如何访问您的网站。例如，自动标记应用于展开的文本广告、关键字、Microsoft购物市场活动以及 Sitelink 扩展。有关自动标记的详细信息，请参阅Microsoft广告帮助文章如何实现将 UTM 标记添加到我的登陆页 URL？。加：自选。如果未指定，则默认值为“非活动”。更新：自选。如果未为更新设置任何值，则不会更改此设置。	AutoTagType
BackUpPaymentInstrumentId	用于结算帐户的备份付款方式的标识符。此元素不适用于开票的帐户。加：只读更新：自选。如果未为更新设置任何值，则不会更改此设置。	long
BillingThresholdAmount	客户指定了针对所选付款方式进行结算的金额。加：只读更新：自选。如果未为更新设置任何值，则不会更改此设置。	十进制
BillToCustomerId	为帐户生成的费用计费的客户标识符。这是代表所有者管理此帐户的聚合器，或者是拥有该帐户的客户标识符。该服务基于 PaymentMethodId 元素中标识的付款方式的所有者设置标识符。加：只读更新：只读	long
BusinessAddress	你的企业合法注册的位置。如果你是代理客户，这是客户合法注册的位置。如果你是作为聚合商工作的代理，这是贵公司合法注册的业务地址。公司地址用于确定税务要求。加：必填。所有国家或地区都需要 Address BusinessName、City 和 Line1 元素。对于巴西 (BR) 和印度 (IN) ，还需要邮政编码和 StateOrProvince 元素。更新：对于不按月发票计费的帐户，可选。话虽如此，如果要对地址进行任何更改，则必须将其 BusinessName、City、CountryCode、Line1 和 StateOrProvince 元素设置为 (（如果适用) ）;每月发票帐户的只读。若要更新发票帐户的 BusinessAddress ，请联系客户经理或支持人员。	地址
CurrencyCode	用于结算帐户的货币的 ISO 代码。该服务使用货币信息进行计费。加：必填更新：只读	CurrencyCode
ForwardCompatibilityMap	用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。将来的版本中将在此处记录向前兼容性更改。此对象当前没有向前兼容性更改。	KeyValuePairOfstringstring 数组
ID	帐户的系统生成的标识符。这是在许多市场活动请求中将 AccountId 元素和 CustomerAccountId SOAP 标头设置为的标识符。加：只读更新：必填	long
语言	如果使用发票作为付款方式) ，则用于呈现从 Microsoft Advertising 收到的计费文档的语言 (。此设置仅适用于此帐户的计费文档，不适用于你可能拥有的其他Microsoft广告帐户。如果在注册客户时将此内容留空，则操作将使用主要用户的 Lcid 元素中的语言值。如果将 Lcid 设置为一个值（例如 FrenchCanada），则帐户语言设置为法语。加：AddAccount 的只读;如果设置了 UserInvitation，则 SignupCustomer 是必需的，否则此元素为 Optional。更新：自选。如果未为更新设置任何值，则不会更改此设置。	LanguageType
LastModifiedByUserId	要更新帐户信息的最后一个用户的标识符。加：只读更新：只读	long
LastModifiedTime	上次更新帐户的日期和时间。该值以协调世界时 (UTC) 表示。日期和时间值反映服务器的日期和时间，而不是客户端。有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。加：只读更新：只读	dateTime
LinkedAgencies	链接到此帐户的代理列表。添加帐户时，目前仅支持一个代理客户。检索帐户时，将包括所有链接的代理客户信息。加：AddAccount 可选;如果代理客户在代表客户创建帐户试点 (GetCustomerPilotFeatures 返回 793) ，则为 SignupCustomer 可选。在此上下文中，聚合器不能作为代理链接，因此无法设置此元素。更新：只读	CustomerInfo 数组
名称	帐户的名称。该字符串可以包含 3 到 100 个字符，并且必须在客户中的所有帐户名中唯一。加：必填更新：必填	string
数字	系统生成的帐号，用于标识Microsoft广告 Web 应用程序中的帐户。帐户号的格式为 xxxxxxxx，其中 xxxxxxxx 是任意 8 个字母数字字符的系列。加：只读更新：只读	string
ParentCustomerId	拥有帐户的客户标识符。在需要客户标识符的活动请求中，这是将 CustomerId SOAP 标头设置为的标识符。加：AddAccount 是必需的;如果未设置 UserInvitation，则 SignupCustomer 是必需的，否则忽略此元素。更新：只读	long
PauseReason	指示暂停帐户的人员的标志值。以下是可能的值： 1 - 用户暂停了帐户。 2 - 计费服务暂停了帐户。 4 - 用户和计费服务暂停了帐户。加：只读更新：只读	unsignedByte
PaymentMethodId	用于结算帐户的付款方式的标识符。加：AddAccount 可选;如果未设置 UserInvitation，则为 SignupCustomer 只读。调用 SignupCustomer 时，将此元素设置为 NULL。该服务会自动选取与聚合器客户的发票关联的付款方式标识符。对于 SignupCustomer ，如果设置了 UserInvitation ，并且新客户帐户通过 LinkedAgencies 链接到代理，并且应向代理计费，请将此元素设置为代理的付款方式 ID。否则，应将此元素保留为 null。更新：自选。如果未为更新设置任何值，则不会更改此设置。	long
PaymentMethodType	用于结算帐户的付款方式类型。无需设置此值，因为类型由与 PaymentMethodId 元素对应的付款方式确定。调用 GetAccount 和 SearchAccounts 以获取帐户数据时， PaymentMethodType 设置为 NULL，并且无法确定帐户使用的付款方式。仅供内部使用。加：只读更新：只读	PaymentMethodType
PrimaryUserId	主要负责管理此帐户的帐户经理的标识符。只能将超级管理员和Standard用户设置为帐户的主要联系人。加：对于 AddAccount ，如果新客户帐户通过 LinkedAgencies 链接到代理，则可以将其中一个代理用户分配为新帐户的主要用户。当调用 SignupCustomer 作为聚合器而不包括 UserInvitation 时，应将此元素留空，并且主用户将设置为聚合器用户标识符。调用 SignupCustomer 并包含 UserInvitation 时，可以将此元素留空，并且主用户将设置为接受邀请的新客户端用户的标识符。调用 SignupCustomer 并且如果设置了 UserInvitation ，并且新客户端帐户正通过 LinkedAgencies 链接到代理，则可以将其中一个代理用户分配为新帐户的主要用户。更新：自选。如果未为更新设置任何值，则不会更改此设置。	long
SalesHouseCustomerId	负责销售潜在顾客的第三方的标识符。加：只读更新：只读	long
SoldToPaymentInstrumentId	客户付款方式的标识符 (用于结算帐户的已销售客户) 。加：如果 BillToCustomerId 与 ParentCustomerId 不同，则 AddAccount 是必需的;只读，不适用于 SignupCustomer。更新：自选。如果未为更新设置任何值，则不会更改此设置。	long
TaxCertificate	帐户税务证书数据对象。	AccountTaxCertificate
TaxInformation	有关此元素的有效键和值字符串的列表，请参阅以下部分中的广告商帐户 TaxInformation 。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。若要删除键值对，请设置键，然后将该值设置为空字符串 (“”) 。	KeyValuePairOfstringstring 数组
时间戳	调用 UpdateAccount 和 DeleteAccount 操作时，系统在内部用于协调更新的时间戳值。加：只读更新：必填	base64Binary
TimeZone	用于此帐户中的市场活动的默认时区值。如果在添加帐户时未指定值，则默认情况下，时区将设置为 PacificTimeUSCanadaTijuana 。 Microsoft广告 Web 应用程序使用此时区值来显示帐户时区首选项，并且不会为使用批量或市场活动管理 API 创建的市场活动提供默认时区值。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。	TimeZoneType

备注

广告商帐户 TaxInformation

下面是可用于广告商帐户的 TaxInformation 元素的键列表。

注意

Microsoft广告无法提供有关税收或增值税的指导。如有疑问，请联系税务顾问或当地税务局。

TaxInformation 密钥	说明	国家或地区
AUGSTNumber	澳大利亚帐户的税务标识符。如果没有税务标识符，可能会根据 BusinessAddress 位置收取税款。加：必填更新：自选。如果未为更新设置任何值，则不会更改此设置。	澳大利亚
CCM	法律实体的市政注册号或 Cadastro de contribuinte mobiliario (CCM) 。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。	巴西
CNPJ	巴西企业帐户的税务标识符。如果没有税务标识符，可能会根据 BusinessAddress 位置收取税款。加：必填更新：自选。如果未为更新设置任何值，则不会更改此设置。	巴西
CPF	巴西个人帐户的税务标识符。如果没有税务标识符，可能会根据 BusinessAddress 位置收取税款。加：必填更新：自选。如果未为更新设置任何值，则不会更改此设置。	巴西
GSTINNumber	此 ID 以两个数字开头，表示注册企业时所在的状态代码，后跟最多 13 个数字和字母。加：自选更新：自选	印度
GSTNumber	在新加坡，计费由爱尔兰Microsoft爱尔兰运营有限公司管理。自 2020 年 1 月 1 日起，Microsoft广告必须对在新加坡注册的企业收取新加坡商品和服务税 (SG GST) 。如果提供 SG GST 注册号，Microsoft广告将采用 0% 的 SG GST。如果未提供 SG GST 注册号，Microsoft广告需要收取 7% 的 SG GST 费用。 (注意：税率可能会更改。) 可能的 GSTNumber 格式包括：两个字母数字字符，后跟一个可选的短划线，后跟七位数字，后跟一个可选短划线，后跟一个字母数字字符;或 8 位或 9 位数字后跟一个字母数字字符;或 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 位数的长税务 ID。如果没有 NZGST，可能会根据你的业务位置征收税款。加：自选更新：只读	新西兰
PanNumber	PAN 编号。加：必填更新：只读	印度
VATNumber	帐户的增值税 (增值税) 注册号 (也称为增值税标识符) 。 VAT 号必须在 BusinessAddress 元素中指定的国家或地区有效。如果没有增值税登记号或免税证书，可能会根据你的营业地点征收税款。加：自选更新：自选	有关详细信息，请参阅每个国家/地区的增值税号格式。

每个国家或地区的 VAT 号码格式

下表列出了每个国家或地区的增值税注册号格式。

VAT 编号	国家/地区
以 2 个特定于每个国家/地区的字母开头，后跟最多 12 个数字或字母。	奥地利、比利时、保加利亚、塞浦路斯、捷克共和国、德国、丹麦、爱沙尼亚、希腊、芬兰、法国、英国、克罗地亚、匈牙利、爱尔兰、意大利、立陶宛、卢森堡、拉脱维亚、马耳他、摩纳哥、荷兰、波兰、葡萄牙、罗马尼亚、西班牙、瑞典、斯洛文尼亚和斯洛伐克。
必须采用以下格式：XXXXXXXX-X 或 XXXXXXXX-K，其中 X 表示 8 位数字，后跟尾随数字。	智利
必须采用以下格式：HUXXXXXXXX (其中胡后跟 8 位数字) 。	匈牙利
必须采用以下格式：LIXXXXX 或 XXXXX (这两种格式都支持，LI 是可选的，并且位数为 5) 。	列支敦士登
必须采用以下格式：XXXXXXXX-0001 (其中 8 位数字为 -0001) 。	尼日利亚
必须采用以下格式：PTXXXXXXXXX (其中 PT 后跟 9 位数字) 。	葡萄牙
长度为 9 或 13 位，其中前 8 位或 12 位是实际 ID 号，最后一位是根据 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

通过

广告商帐户数据对象 - 客户管理

语法

元素

备注

广告商帐户 TaxInformation

每个国家或地区的 VAT 号码格式

要求

使用者

反馈

其他资源