用户设置

GET accounts/:account_id/user_settings/:user_id

检索用户设置。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/user_settings/:user_id

参数

名称 说明
account_id
必需
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts
指定账号必须与已验证的用户关联。

类型:string

示例:18ce54d4x5t
user_id
必需
请求中对正在操作的用户的引用。使用 GET users/lookup 检索某个显示名称的用户 ID。

类型:long

示例:756201191646691328

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/user_settings/756201191646691328

响应示例

  {
    "request": {
      "params": {
        "account_id": "18ce54d4x5t",
        "user_id": "756201191646691328"
      }
    },
    "data": {
      "notification_email": "user@domain.com",
      "contact_phone": "",
      "contact_phone_extension": "",
      "subscribed_email_types": [
        "ACCOUNT_PERFORMANCE",
        "PERFORMANCE_IMPROVEMENT"
      ]
    }
  }

PUT accounts/:account_id/user_settings/:user_id

更新用户设置。需要用户情景。账号管理员无法访问。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/user_settings/:user_id

参数

名称 说明
account_id
required
所使用账号的标识符。在资源路径和 GET accounts 中显示。
指定账号必须与已验证的用户关联。

类型:string

示例:18ce54d4x5t
user_id
required
请求中对正在操作的用户的引用。使用 GET users/lookup 检索某个显示名称的用户 ID。

类型:long

示例:756201191646691328
notification_email
可选
用于账号通知的邮件。

类型:string

示例:user@domain.com
contact_phone
可选
联系人电话号码。

类型:string

示例:202-555-0128
contact_phone_extension
可选
联系人 contact_phone 的分机号。

类型:string

示例:1234
subscribed_email_types
optional
通知邮件订阅类型。

类型:string

可能值:CAMPAIGN_EVENTSACCOUNT_PERFORMANCEPERFORMANCE_IMPROVEMENT

请求示例

PUT https://ads-api.twitter.com/10/accounts/18ce54d4x5t/user_settings/756201191646691328?notification_email='user@domain.com'&subscribe_email_types=ACCOUNT_PERFORMANCE,PERFORMANCE_IMPROVEMENT"

响应示例

  {
    "request": {
      "params": {
        "account_id": "18ce54d4x5t",
        "user_id": "756201191646691328"
        "notification_email": "user@domain.com",
        "subscribed_campaign_events": [
          "ACCOUNT_PERFORMANCE",
          "PERFORMANCE_IMPROVEMENT"
        ]
      }
    },
    "data": {
      "notification_email": "user@domain.com",
      "contact_phone": "",
      "Contact_phone_extension": "",
      "subscribed_email_types": [
        "ACCOUNT_PERFORMANCE",
        "PERFORMANCE_IMPROVEMENT"
      ]
    }
  }