Campaign Manager 360 API v3.4 已被弃用,并将于 2021 年 12 月 24 日停用。所有用户都必须在该截止日期之前迁移到新版 API。

AccountUserProfiles

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示形式

AccountUserProfiles 包含某项 Campaign Manager 用户个人资料的属性。此资源专门用于管理用户个人资料,而 UserProfiles 用于访问该 API。

{
  "kind": "dfareporting#accountUserProfile",
  "id": long,
  "name": string,
  "email": string,
  "accountId": long,
  "subaccountId": long,
  "locale": string,
  "userRoleId": long,
  "userAccessType": string,
  "active": boolean,
  "comments": string,
  "traffickerType": string,
  "campaignFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "siteFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "userRoleFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "advertiserFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  }
}
属性名称 说明 备注
accountId long 对应此用户个人资料的帐号 ID。此字段是只读字段,可以留空。
active boolean 此用户个人资料是否有效。该值默认为 false,在插入时必须设为 true 才能使此用户个人资料可以使用。
advertiserFilter nested object 描述哪些广告客户对此用户个人资料可见的过滤器。
advertiserFilter.kind string 所属资源种类。值:固定字符串 "dfareporting#objectFilter"
advertiserFilter.objectIds[] list 当状态为 ASSIGNED 时适用。用户有权访问具有这些对象 ID 的对象。
advertiserFilter.status string 过滤器的状态。NONE 表示用户无权访问任何对象。ALL 表示用户有权访问所有对象。ASSIGNED 表示用户有权访问 ID 位于 objectIds 列表中的对象。

可接受的值为:
  • ALL
  • ASSIGNED
  • NONE
campaignFilter nested object 描述哪些广告系列对此用户个人资料可见的过滤器。
campaignFilter.kind string 所属资源种类。值:固定字符串 "dfareporting#objectFilter"
campaignFilter.objectIds[] list 当状态为 ASSIGNED 时适用。用户有权访问具有这些对象 ID 的对象。
campaignFilter.status string 过滤器的状态。NONE 表示用户无权访问任何对象。ALL 表示用户有权访问所有对象。ASSIGNED 表示用户有权访问 ID 位于 objectIds 列表中的对象。

可接受的值为:
  • ALL
  • ASSIGNED
  • NONE
comments string 有关此用户个人资料的备注。
email string 此用户个人资料的电子邮件地址。该电子邮件地址必须与某个 Google 帐号相关联。在插入时,此字段是必填字段;而在插入后,此字段是只读字段。
id long 用户个人资料的 ID。此字段是自动生成的只读字段。
kind string 所属资源种类。值:固定字符串 "dfareporting#accountUserProfile"
locale string 用户个人资料的语言区域。此字段是必填字段。

可接受的值为:

  • cs”(捷克语)
  • de”(德语)
  • en”(英语)
  • en-GB”(英语 [英国])
  • es”(西班牙语)
  • fr”(法语)
  • it”(意大利语)
  • ja”(日语)
  • ko”(韩语)
  • pl”(波兰语)
  • pt-BR”(葡萄牙语 [巴西])
  • ru”(俄语)
  • sv”(瑞典语)
  • tr”(土耳其语)
  • zh-CN”(简体中文)
  • zh-TW”(繁体中文)

name string 此用户个人资料的名称。此字段是必填字段。长度必须少于 64 个字符,必须在全局级别具有唯一性,且不得包含空格符或以下任何字符:“&;<>"#%,”。
siteFilter nested object 对用户个人资料可见的网站。
siteFilter.kind string 所属资源种类。值:固定字符串 "dfareporting#objectFilter"
siteFilter.objectIds[] list 当状态为 ASSIGNED 时适用。用户有权访问具有这些对象 ID 的对象。
siteFilter.status string 过滤器的状态。NONE 表示用户无权访问任何对象。ALL 表示用户有权访问所有对象。ASSIGNED 表示用户有权访问 ID 位于 objectIds 列表中的对象。

可接受的值为:
  • ALL
  • ASSIGNED
  • NONE
subaccountId long 对应此用户个人资料的子帐号 ID。此字段是只读字段,可以留空。
traffickerType string 此用户个人资料的广告投放人员类型。此字段是只读字段。

可接受的值包括:
  • EXTERNAL_TRAFFICKER
  • INTERNAL_NON_TRAFFICKER
  • INTERNAL_TRAFFICKER
userAccessType string 此用户个人资料的用户类型。此字段是只读字段,可以留空。

可接受的值为:
  • INTERNAL_ADMINISTRATOR
  • NORMAL_USER
  • READ_ONLY_SUPER_USER
  • SUPER_USER
userRoleFilter nested object 对此用户个人资料可见的用户角色。
userRoleFilter.kind string 所属资源种类。值:固定字符串 "dfareporting#objectFilter"
userRoleFilter.objectIds[] list 当状态为 ASSIGNED 时适用。用户有权访问具有这些对象 ID 的对象。
userRoleFilter.status string 过滤器的状态。NONE 表示用户无权访问任何对象。ALL 表示用户有权访问所有对象。ASSIGNED 表示用户有权访问 ID 位于 objectIds 列表中的对象。

可接受的值为:
  • ALL
  • ASSIGNED
  • NONE
userRoleId long 此用户个人资料的用户角色 ID。此字段是必填字段。

方法

get
根据 ID 获取一份帐号用户个人资料。
insert
插入新的帐号用户个人资料。
list
检索帐号用户个人资料列表,该列表可能经过了过滤。此方法支持分页
patch
更新现有帐号用户个人资料。此方法支持补丁语义
update
更新现有帐号用户个人资料。