REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Tài nguyên: YoutubeAssetAssociation

Mối liên kết giữa một tài nguyên và một tài sản trên YouTube.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của mối liên kết.

Đối với mối liên kết ở cấp mục hàng: Mẫu tên là advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Đối với mối liên kết ở cấp nhóm quảng cáo: Mẫu tên là advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Đối với mối liên kết YOUTUBE_ASSET_TYPE_LOCATION và YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId là mã nhận dạng của nhóm tài sản được liên kết hoặc 0 nếu locationMatchingType hoặc affiliateLocationMatchingType là DISABLED.

Đối với mối liên kết YOUTUBE_ASSET_TYPE_SITELINK: youtubeAssetAssociationId là mã nhận dạng của thành phần đường liên kết của trang web được liên kết.
youtubeAssetType

enum (YoutubeAssetType)

Bắt buộc. Loại tài sản trên YouTube được liên kết với tài nguyên.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Bắt buộc. Tài sản trên YouTube được liên kết với tài nguyên.

YoutubeAssetType

Các loại tài sản có thể có trên YouTube.

Những thành phần này sẽ hiển thị thông tin bổ sung cùng với quảng cáo trong quá trình phân phát.

Enum
YOUTUBE_ASSET_TYPE_UNSPECIFIED Loại tài sản trên YouTube không được chỉ định hoặc không xác định trong phiên bản này.
YOUTUBE_ASSET_TYPE_LOCATION Thành phần địa điểm.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Thành phần địa điểm của đơn vị liên kết.

LinkedYouTubeAsset

Một tài sản trên YouTube được liên kết với một tài nguyên trong YoutubeAssetAssociation.

Biểu diễn dưới dạng JSON 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
Trường
Trường nhóm youtube_asset. Tài sản trên YouTube. youtube_asset chỉ có thể là một trong những trạng thái sau:
locationAssetFilter

object (LocationAssetFilter)

Bộ lọc thành phần địa điểm.

Bạn chỉ có thể đặt chế độ này khi youtubeAssetType là YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Bộ lọc thành phần địa điểm của đơn vị liên kết.

Bạn chỉ có thể đặt chế độ này khi youtubeAssetType là YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

Một bộ lọc thành phần khớp với các thành phần vị trí đủ điều kiện để phân phát.

Biểu diễn dưới dạng JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Trường
locationMatchingType

enum (LocationMatchingType)

Bắt buộc. Loại tiêu chí so khớp của bộ lọc thành phần vị trí này.
assetSetId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của nhóm thành phần khớp với các thành phần vị trí đủ điều kiện để phân phát.
locationMatchingFunction

object (LocationMatchingFunction)

Không bắt buộc. Hàm so khớp quy định cách bộ lọc thành phần địa điểm so khớp thành phần địa điểm.

Đây là trường bắt buộc và bạn chỉ có thể đặt trường này nếu locationMatchingType là FILTER hoặc SELECTED_ASSETS.

LocationMatchingType

Các loại tiêu chí khớp có thể xác định những thành phần vị trí đủ điều kiện để phân phát.

Enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Bạn chưa chỉ định hoặc không xác định được loại so khớp vị trí trong phiên bản này.
SELECT_ALL Tất cả thành phần vị trí hiện có đều đủ điều kiện phân phát.
FILTER Những thành phần vị trí phù hợp với bộ lọc tên doanh nghiệp và/hoặc nhãn được cung cấp có thể phân phát.
SELECTED_ASSETS Chỉ những thành phần vị trí được chọn mới có thể phân phát.
DISABLED Không có thành phần địa điểm nào có thể phân phát.

LocationMatchingFunction

Hàm so khớp cho bộ lọc thành phần địa điểm.

Biểu diễn dưới dạng JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Trường
labels[]

string

Không bắt buộc. Nhãn cần khớp.

Các nhãn được liên kết với nhau theo logic OR.

Trường này không bắt buộc và bạn chỉ có thể đặt nếu locationMatchingType là FILTER.
locationAssetIds[]

string (int64 format)

Không bắt buộc. Mã thành phần địa điểm đã chọn.

Bạn bắt buộc phải điền trường này nếu locationMatchingType là SELECTED_ASSETS.
business

string

Không bắt buộc. Tên doanh nghiệp cần khớp.

Trường này không bắt buộc và bạn chỉ có thể đặt nếu locationMatchingType là FILTER.

AffiliateLocationAssetFilter

Một bộ lọc thành phần phù hợp với các thành phần địa điểm đủ điều kiện của đơn vị liên kết để phân phát.

Biểu diễn dưới dạng JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Trường
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Bắt buộc. Loại tiêu chí so khớp của bộ lọc thành phần địa điểm của đơn vị liên kết này.
assetSetId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của nhóm tài sản khớp với thành phần địa điểm của đơn vị liên kết đủ điều kiện để phân phát.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Không bắt buộc. Hàm so khớp quy định cách bộ lọc thành phần địa điểm của đơn vị liên kết so khớp thành phần địa điểm của đơn vị liên kết.

Đây là trường bắt buộc và bạn chỉ có thể đặt trường này nếu affiliateLocationMatchingType là SELECTED_CHAINS.

AffiliateLocationMatchingType

Các loại tiêu chí khớp có thể xác định thành phần địa điểm của đơn vị liên kết nào đủ điều kiện phân phát.

Enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Bạn chưa chỉ định hoặc không xác định được loại so khớp vị trí của đơn vị liên kết trong phiên bản này.
SELECT_ALL Tất cả thành phần địa điểm của đơn vị liên kết hiện có đều đủ điều kiện để phân phát.
SELECTED_CHAINS Các thành phần địa điểm của đơn vị liên kết đã chọn có thể phân phát.
DISABLED Không có thành phần địa điểm của đơn vị liên kết nào có thể phân phát.

AffiliateLocationMatchingFunction

Hàm đối sánh cho bộ lọc thành phần địa điểm của đơn vị liên kết.

Biểu diễn dưới dạng JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Trường
chains[]

object (AffiliateLocationChain)

Không bắt buộc. Mã chuỗi vị trí của đơn vị liên kết đã chọn.

Bạn bắt buộc phải điền trường này nếu affiliateLocationMatchingType là SELECTED_CHAINS.

AffiliateLocationChain

Một chuỗi các địa điểm của đơn vị liên kết.

Biểu diễn dưới dạng JSON 
{
  "chainId": string
}
Trường
chainId

string (int64 format)

Bắt buộc. Mã nhận dạng của chuỗi vị trí đơn vị liên kết.

SitelinkAsset

Một thành phần đường liên kết của trang web.

Biểu diễn dưới dạng JSON 
{
  "assetId": string
}
Trường
assetId

string (int64 format)

Bắt buộc. Mã nhận dạng của thành phần đường liên kết của trang web.

Phương thức

create

 Tạo mối liên kết mới giữa tài nguyên được xác định và một tài sản trên YouTube.

delete

 Xoá mối liên kết hiện có giữa tài nguyên được xác định và một tài sản trên YouTube.

list

 Liệt kê các mối liên kết tài sản trên YouTube được liên kết với tài nguyên đã cho.