CustomerAsset

  • A customer asset links a customer to an asset.

  • The resource_name is immutable and identifies the customer asset in the format customers/{customer_id}/customerAssets/{asset_id}~{field_type}.

  • Key fields include asset (required, immutable, linked asset), field_type (required, immutable, role of the asset), and source (output only, source of the link).

  • The status indicates the advertiser-set status (enabled, paused, or removed), while primary_status provides a more comprehensive serving state considering policy and quality approvals.

  • primary_status_details and primary_status_reasons (both output only) offer details and reasons for the primary status, particularly if an asset is not serving fully or at all.

A link between a customer and an asset.

Fields

resource_name

string

Immutable. The resource name of the customer asset. CustomerAsset resource names have the form:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Required. Immutable. The asset which is linked to the customer.

field_type

AssetFieldType

Required. Immutable. Role that the asset takes for the customer link.

source

AssetSource

Output only. Source of the customer asset link.

status

AssetLinkStatus

Status of the customer asset.

primary_status

AssetLinkPrimaryStatus

Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state.

primary_status_details[]

AssetLinkPrimaryStatusDetails

Output only. Provides the details of the primary status and its associated reasons.

primary_status_reasons[]

AssetLinkPrimaryStatusReason

Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.