Resource: AdsDataLink
Represents an advertising data link.
JSON representation | |
---|---|
{ "name": string, "linkedEntity": { object ( |
Fields | |
---|---|
name |
Name that uniquely identifies an AdsDataLink resource. It has the form customers/[customerId]/adsDataLinks/[resource_id]. The resource ID is generated by the server. |
linkedEntity |
Entity linked through this AdsDataLink. |
parentEntity |
Related parent entity, if any. If the linked entity is a Google Ads campaign, this field will contain a corresponding Google Ads customer to which the campaign belongs. |
childEntities[] |
Related child entities, if any. If the linked entity is a Google Ads customer that corresponds to a customer-manager link, then childEntities will include a fully expanded set of Google Ads customers with data imported into Ads Data Hub through this link. |
platform |
Advertising platform associated with the linked entity. |
customerLink |
Customer link through which the linked data can be accessed. Only name, customer ID, and displayName are populated. |
status |
Status of the data link. |
createTime |
Time the link was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Time the link status was last updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
vendorClientId |
Vendor client ID, if any. |
metrics[] |
Metrics accessible through this data link. If empty, no metric restrictions are applied. This field is currently only singlar, and only supported when link entity type is |
gmpExportScopes[] |
Types of data that will be exported for Display & Video 360 links. Only populated when platform is |
Entity
Represents an advertising entity that can be linked to an Ads Data Hub customer.
JSON representation | |
---|---|
{
"entityId": string,
"displayName": string,
"type": enum ( |
Fields | |
---|---|
entityId |
Entity ID. The value listed here is dependent on the entity type. |
displayName |
Entity display name. |
type |
Type of linked entity. |
EntityType
Supported advertising entities.
Enums | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
Unspecified entity type. |
GOOGLE_ADS_CUSTOMER |
A Google Ads customer. The entityId corresponds to [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] in the Google Ads API. |
GOOGLE_ADS_CAMPAIGN |
A Google Ads campaign. The entityId corresponds to [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] in the Google Ads API. |
GMP_CM_ACCOUNT |
A Google Marketing Platform Campaign Manager account. The entityId corresponds to [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts] |
GMP_CM_FLOODLIGHT |
A Campaign Manager floodlight account. The entityId corresponds to [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations] |
GMP_DV360_PARTNER |
A Display & Video 360 partner ID. The entityId is a DV360 partner ID. |
GMP_DV360_ADVERTISER |
A Display & Video 360 advertiser ID. The entityId is a DV360 advertiser ID. |
GMP_DV360_ORDER |
A Display & Video 360 order ID. entityId is a DV360 order ID. |
GMP_DV360_LINE_ITEM |
A Display & Video 360 line item ID. entityId is a DV360 line item ID. |
YT_RESERVE_ORDER |
A YouTube Reserve order ID. entityId corresponds to [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager. |
YT_RESERVE_LINE_ITEM |
A YouTube Reserve line item. entityId corresponds to [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager. |
VENDOR_CLIENT_ID_REGISTRATION |
A Vendor Client ID that is manually registered by a third-party ad tech vendor to provide third-party measurements. |
GOOGLE_AD_MANAGER_ORDER |
A Google Ad Manager order ID. entityId corresponds to [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] in Google Ads Manager. |
GOOGLE_AD_MANAGER_LINE_ITEM |
A Google Ad Manager line item. entityId corresponds to [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] in Google Ads Manager. |
Platform
Supported advertising platforms.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
Unspecified platform. |
GOOGLE_ADS |
The entity is associated with Google Ads. |
GOOGLE_MARKETING_PLATFORM |
The entity is associated with Google Marketing Platform. |
YOUTUBE_RESERVE |
The entity is associated with Youtube Reserve. |
GOOGLE_AD_MANAGER |
The entity is associated with Google Ad Manager. |
FREEWHEEL |
The entity is associated with FreeWheel. |
Metric
Metrics that can be exposed through ad data links.
Enums | |
---|---|
METRIC_UNSPECIFIED |
Unspecified metric. |
BRAND_LIFT |
Metric corresponding to Brand Lift. |
BRAND_SAFETY |
Metric corresponding to Brand Safety. |
REACH |
Metric corresponding to Reach, where the customer is the advertiser. |
VIEWABILITY |
Metric corresponding to Viewability, where the customer is the advertiser. |
PUBLISHER_REACH |
Metric corresponding to Reach, where the customer is the publisher/content provider. |
PUBLISHER_VIEWABILITY |
Metric corresponding to Viewability, where the customer is the publisher/content provider. |
GmpExportScope
Different types of data that can be exported for GMP links.
Enums | |
---|---|
GMP_EXPORT_SCOPE_UNSPECIFIED |
Unspecified scope. |
GMP_EXPORT_SCOPE_YT_TRUEVIEW |
Should export DV360 Youtube TrueView data. |
GMP_EXPORT_SCOPE_DT |
Should export DT data. |
Methods |
|
---|---|
|
Approve a list of pending ads data links. |
|
Reject a list of pending ads data links. |
|
Lists links between the specified customer and other Google advertising entities. |