本頁面由 Cloud Translation API 翻譯而成。

REST Resource: customers.adsDataLinks

資源：AdsDataLink
- JSON 表示法
Entity
- JSON 表示法
EntityType
平台類型
指標
GmpExportScope
方法

資源：AdsDataLink

代表廣告資料連結。

JSON 表示法

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,
  "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 客戶，則子實體會納入一組完全擴充的 Google Ads 客戶，並透過這個連結將資料匯入廣告資料中心。
`platform`	`enum (Platform)` 與已連結實體相關聯的廣告平台。
`customerLink`	`object (CustomerLink)` 可供存取連結資料的客戶連結。系統只會填入名稱、客戶 ID 和 displayName。
`status`	`enum (LinkStatus)` 資料連結的狀態。
`createTime`	`string (Timestamp format)` 建立連結的時間。 RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。
`updateTime`	`string (Timestamp format)` 連結狀態上次更新時間。 RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例：`"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)` 已連結實體的類型。

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 Reserve 訂單 ID。`entityId` 對應 Google Ads Manager 中的 [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id]。
`YT_RESERVE_LINE_ITEM`	YouTube Reserve 委刊項。`entityId` 對應 Google Ads Manager 中的 [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id]。
`VENDOR_CLIENT_ID_REGISTRATION`	是由第三方廣告技術供應商手動註冊以提供第三方評估結果的供應商客戶 ID。
`GOOGLE_AD_MANAGER_ORDER`	Google Ad Manager 訂單 ID。`entityId` 對應 Google Ads Manager 中的 [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id]。
`GOOGLE_AD_MANAGER_LINE_ITEM`	Google Ad Manager 委刊項。`entityId` 對應 Google Ads Manager 中的 [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id]。

平台

支援的廣告平台。

列舉
`PLATFORM_UNSPECIFIED`	未指定的平台。
`GOOGLE_ADS`	實體與 Google Ads 相關聯。
`GOOGLE_MARKETING_PLATFORM`	實體已與 Google Marketing Platform 建立關聯。
`YOUTUBE_RESERVE`	該實體已與 YouTube Reserve 建立關聯。
`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`	應匯出 DT 資料。

方法
`batchApprove`	核准待審核的廣告資料清單。
`batchReject`	拒絕待審查的廣告資料連結清單。
`list`	列出指定客戶和其他 Google 廣告實體之間的連結。

REST Resource: customers.adsDataLinks

資源：AdsDataLink

實體

EntityType

平台

指標

GmpExportScope

方法

`batchApprove`

`batchReject`

`list`