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 các 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 bộ thành phầ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.

Các 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 vị trí.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Thành phần vị trí 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
Trường
Tài sản trên YouTube. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
locationAssetFilter

object (LocationAssetFilter)

Bộ lọc thành phần vị trí.

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

object (AffiliateLocationAssetFilter)

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

Bạn chỉ có thể đặt tham số này khi youtubeAssetType là YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.
Kết thúc các trường loại trừ lẫn nhau.

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 bộ 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 xác định cách bộ lọc thành phần vị trí so khớp thành phần vị trí.

Bạn phải điền trường này và chỉ có thể đặt nếu locationMatchingType là FILTER hoặc SELECTED_ASSETS.

LocationMatchingType

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

Enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Loại tiêu chí khớp vị trí không được chỉ định hoặc không xác định trong phiên bản này.
SELECT_ALL Tất cả thành phần địa điểm có sẵn đề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 địa điểm đã 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 vị trí.

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 so khớp.

Các nhãn được kết hợp với nhau bằng 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 vị trí đã chọn.

Bạn 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 khớp với các thành phần vị trí của đơn vị liên kết đủ điều kiện để 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. Kiểu khớp của bộ lọc thành phần vị trí 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 bộ thành phần khớp với các 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 xác định cách bộ lọc thành phần vị trí của đơn vị liên kết so khớp thành phần vị trí 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ể có để quyết đị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 không 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 vị trí 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 phải điền trường này nếu affiliateLocationMatchingType là SELECTED_CHAINS.

AffiliateLocationChain

Một chuỗi các vị trí 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í của đơn vị liên kết.

SitelinkAsset

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 giữa tài sản trên YouTube với tài nguyên đã cho.