REST Resource: customers.adsDataLinks

• 资源：AdsDataLink
  • JSON 表示法
• Entity
  • JSON 表示法
• EntityType
• 平台
• 指标
• GmpExportScope
• 方法

资源：AdsDataLink

表示广告数据链接。

JSON 表示法
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

字段
name	string 用于唯一标识 AdsDataLink 资源的名称。其格式为 customer/[customerId]/adsDataLinks/[resource_id]。资源 ID 由服务器生成。
linkedEntity	object (Entity) 通过此 AdsDataLink 关联的实体。
parentEntity	object (Entity) 相关父实体（如果有）。如果关联的实体是 Google Ads 广告系列，此字段将包含广告系列所属的相应 Google Ads 客户。
childEntities[]	object (Entity) 相关子实体（如果有）。如果关联的实体是与客户经理关联的 Google Ads 客户，childchild 将包括一个完全扩展的 Google Ads 客户群组，其中的数据会通过此链接导入到广告数据中心。
platform	enum (Platform) 与关联实体相关联的广告平台。
customerLink	object (CustomerLink) 可访问所关联数据的客户链接。系统仅填充名称、客户 ID 和 displayName。
status	enum (LinkStatus) 数据链接的状态。
createTime	string (Timestamp format) 建立关联的时间。 时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒级，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime	string (Timestamp format) 关联状态上次更新的时间。 时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒级，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
vendorClientId	string 供应商客户 ID（如果有）。
metrics[]	enum (Metric) 可通过此数据链接访问的指标。如果为空，则不会应用任何指标限制。此字段目前仅为单数字段，且仅当链接实体类型为 GOOGLE_ADS_CAMPAIGN 或 YT_RESERVE_LINE_ITEM 时才受支持。
gmpExportScopes[]	enum (GmpExportScope) 将为 Display &Video 360 关联导出的数据类型。仅在平台为 GOOGLE_MARKETING_PLATFORM 时填充。如果为空，则未指定，并且可能会提供任意组合。

实体

表示可与广告数据中心客户关联的广告实体。

JSON 表示法
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

字段
entityId	string (int64 format) 实体 ID。此处列出的值取决于实体类型。
displayName	string 实体显示名称。
type	enum (EntityType) 关联的实体类型。

EntityType

支持的广告实体。

枚举
ENTITY_TYPE_UNSPECIFIED	未指定的实体类型。
GOOGLE_ADS_CUSTOMER	Google Ads 客户。entityId 对应于 Google Ads API 中的 [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer]。
GOOGLE_ADS_CAMPAIGN	Google Ads 广告系列。entityId 对应于 Google Ads API 中的 [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign]。
GMP_CM_ACCOUNT	Google Marketing Platform Campaign Manager 帐号。entityId 对应于 [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts]
GMP_CM_FLOODLIGHT	Campaign Manager Floodlight 帐号。entityId 对应于 [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/FloodlightConfigurations]
GMP_DV360_PARTNER	Display &Video 360 合作伙伴 ID。entityId 是一个 DV360 合作伙伴 ID。
GMP_DV360_ADVERTISER	一个 Display &Video 360 广告客户 ID。entityId 是一个 DV360 广告客户 ID。
GMP_DV360_ORDER	Display &Video 360 订单 ID。entityId 是一个 DV360 订单 ID。
GMP_DV360_LINE_ITEM	一个 Display &Video 360 订单项 ID。entityId 是一个 DV360 订单项 ID。
YT_RESERVE_ORDER	YouTube 预订型广告资源的订单 ID。entityId 对应于 Google Ads 管理器中的 [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/Constant.Order#id]。
YT_RESERVE_LINE_ITEM	YouTube 预订型广告资源订单项。entityId 对应于 Google Ads 管理器中的 [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/AdGroupCriterion.LineItem#id]。
VENDOR_CLIENT_ID_REGISTRATION	由第三方广告技术供应商手动注册的供应商客户端 ID，用于提供第三方衡量服务。
GOOGLE_AD_MANAGER_ORDER	Google Ad Manager 订单 ID。entityId 对应于 Google Ads 管理器中的 [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/Constant.Order#id]。
GOOGLE_AD_MANAGER_LINE_ITEM	Google Ad Manager 订单项。entityId 对应于 Google Ads 管理器中的 [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/AdGroupCriterion.LineItem#id]。

平台

支持的广告平台。

枚举
PLATFORM_UNSPECIFIED	未指定平台。
GOOGLE_ADS	该实体与 Google Ads 相关联。
GOOGLE_MARKETING_PLATFORM	该实体已与 Google Marketing Platform 相关联。
YOUTUBE_RESERVE	该实体已与 YouTube 预订型广告资源相关联。
GOOGLE_AD_MANAGER	该实体已与 Google Ad Manager 关联。
FREEWHEEL	该实体与 FreeWheel 相关联。

指标

可通过广告数据链接公开的指标。

枚举
METRIC_UNSPECIFIED	未指定指标。
BRAND_LIFT	与品牌提升对应的指标。
BRAND_SAFETY	品牌保障对应的指标。
REACH	与“覆盖面”对应的指标，其中客户是广告客户。
VIEWABILITY	与可见度对应的指标，其中客户是广告客户。
PUBLISHER_REACH	与“覆盖面”对应的指标，其中客户是发布商/内容提供方。
PUBLISHER_VIEWABILITY	与可见度对应的指标，其中客户是发布商/内容提供方。

GmpExportScope

可针对 GMP 链接导出的各种数据。

枚举
GMP_EXPORT_SCOPE_UNSPECIFIED	未指定范围。
GMP_EXPORT_SCOPE_YT_TRUEVIEW	应导出 DV360 YouTube TrueView 数据。
GMP_EXPORT_SCOPE_DT	应导出数据传输数据。

方法
batchApprove	批准待处理的广告数据关联列表。
batchReject	拒绝待处理的广告数据关联列表。
list	列出指定客户与其他 Google 广告实体之间的关联。