税設定

GET accounts/:account_id/tax_settings

現在のアカウントに関連付けられている税設定の詳細を取得します。

リソースURL

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

パラメーター

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/tax_settings

応答の例

{
  "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
任意

課金対象のエンティティ。

タイプ: 列挙

使用可能な値: ADVERTISERAGENCY

business_relationship
任意

アカウントを所有するのが、広告主か代理業者か。

タイプ: 列挙

使用可能な値: AGENCYSELF

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_SAPINNONENOT_SET

tax_category
任意

課税対象が個人か企業か。

タイプ: 列挙

使用可能な値: BUSINESS_NO_VATBUSINESS_WITH_VATINDIVIDUAL

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