{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "tax_id": "GB896391250",
    "address_city": "London",
    "business_relationship": "SELF",
    "address_street1": "21 March St",
    "address_last_name": null,
    "address_company": "ABC, Inc.",
    "tax_category": "BUSINESS_WITH_VAT",
    "address_postal_code": "SW1A 1AA",
    "bill_to": "NOT_SET",
    "address_region": "London",
    "address_country": "GB",
    "address_first_name": null,
    "invoice_jurisdiction": "NOT_SET",
    "address_street2": null,
    "address_email": null
  }
}

PUT accounts/:account_id/tax_settings¶

現在のアカウントの税設定を更新します。

リソースURL¶

https://ads-api.x.com/10/accounts/:account_id/tax_settings

パラメーター¶

名前	説明
account_id 必須	利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。タイプ: 文字列例: `18ce54d4x5t`
address_city 任意	アカウント所有者の住所の都市。タイプ: 文字列例: `San Francisco`
address_country 任意	アカウント所有者の住所の2文字の国コード。タイプ: 文字列例: `US`
address_email 任意	アカウントの所有者の住所に関連付けられているメール。タイプ: 文字列例: `api@mctestface.com`
address_first_name 任意	アカウントの所有者の住所に関連付けられている名。タイプ: 文字列例: `API`
address_last_name 任意	アカウントの所有者の住所に関連付けられている姓。タイプ: 文字列例: `McTestface`
address_name 任意	アカウントの所有者の住所に関連付けられている会社名。タイプ: 文字列例: `ABC, Co.`
address_postal_code 任意	アカウントの所有者の住所に関連付けられている郵便番号。タイプ: 文字列例: `94102`
address_region 任意	アカウントの所有者の住所に関連付けられている地域。タイプ: 文字列例: `California`
address_street1 任意	アカウントの所有者の住所に関連付けられている番地。タイプ: 文字列例: `21 March St`
address_street2 任意	アカウントの所有者の住所に関連付けられている番地2。タイプ: 文字列例: `Suite 99`
bill_to 任意	課金対象のエンティティ。タイプ: 列挙使用可能な値: `ADVERTISER`、`AGENCY`
business_relationship 任意	アカウントを所有するのが、広告主か代理業者か。タイプ: 列挙使用可能な値: `AGENCY`、`SELF`
client_address_city 任意	広告主の住所の都市。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `Toronto`
client_address_country 任意	広告主の住所の2文字の国コード。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `CA`
client_address_email 任意	広告主の住所に関連付けられているメール。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `ads@brand.com`
client_address_first_name 任意	広告主の住所の名。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `Brand`
client_address_last_name 任意	広告主の住所の姓。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `Advertiser`
client_address_name 任意	広告主の住所の会社名。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `Brand, Inc.`
client_address_postal_code 任意	広告主の住所の郵便番号。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `M5H 2N2`
client_address_region 任意	広告主の住所の地域。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `Ontario`
client_address_street1 任意	広告主の住所の番地。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `280 Queen St W`
client_address_street2 任意	広告主の住所の番地2。広告アカウントが代理業者によって所有される場合にこれを設定します。タイプ: 文字列例: `The 6`
invoice_jurisdiction 任意	インボイスの管轄地域。タイプ: 列挙使用可能な値: `LOI_SAPIN`、`NONE`、`NOT_SET`
tax_category 任意	課税対象が個人か企業か。タイプ: 列挙使用可能な値: `BUSINESS_NO_VAT`、`BUSINESS_WITH_VAT`、`INDIVIDUAL`
tax_exemption_id 任意	VAT適用除外ID。タイプ: 文字列例: `12345`
tax_id 任意	VAT登録ID。タイプ: 文字列使用可能な値: `67890`

リクエストの例¶

PUT https://ads-api.x.com/10/accounts/18ce54d4x5t/tax_settings?address_name=ABC, Co.

応答の例¶

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "address_name": "ABC Co."
    }
  },
  "data": {
    "tax_id": "GB896391250",
    "address_city": "London",
    "business_relationship": "SELF",
    "address_street1": "21 March St",
    "address_last_name": null,
    "address_company": "ABC, Co.",
    "tax_category": "BUSINESS_WITH_VAT",
    "address_postal_code": "SW1A 1AA",
    "bill_to": "NOT_SET",
    "address_region": "London",
    "address_country": "GB",
    "address_first_name": null,
    "invoice_jurisdiction": "NOT_SET",
    "address_street2": null,
    "address_email": null
  }
}