REST Resource: advertisers.youtubeAdGroups

Tài nguyên: YouTubeAdGroup

Một nhóm quảng cáo trên YouTube được liên kết với một mục riêng YouTube và Đối tác.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Trường
name

string

Tên tài nguyên của nhóm quảng cáo.
advertiserId

string (int64 format)

Mã nhận dạng duy nhất của nhà quảng cáo có chứa nhóm quảng cáo.
adGroupId

string (int64 format)

Mã nhận dạng duy nhất của nhóm quảng cáo. Do hệ thống chỉ định.
lineItemId

string (int64 format)

Mã nhận dạng duy nhất của mục hàng chứa nhóm quảng cáo.
displayName

string

Tên hiển thị của nhóm quảng cáo.

Phải được mã hoá UTF-8 với kích thước tối đa là 255 byte.
youtubeAdIds[]

string (int64 format)

Mã của những tài nguyên [youtube_ad_group_ad][] được liên kết với nhóm quảng cáo.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Định dạng của quảng cáo trong nhóm quảng cáo.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Chiến lược đặt giá thầu mà nhóm quảng cáo sử dụng.
entityStatus

enum (EntityStatus)

Kiểm soát việc nhóm quảng cáo có thể chi tiêu ngân sách và đặt giá thầu trên khoảng không quảng cáo hay không.

Nếu mục hàng gốc của nhóm quảng cáo không hoạt động, nhóm quảng cáo không thể chi tiêu ngân sách ngay cả khi trạng thái của chính nhóm quảng cáo là ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Chế độ cài đặt mở rộng tiêu chí nhắm mục tiêu của nhóm quảng cáo.

Cấu hình này chỉ áp dụng khi tiêu chí nhắm mục tiêu theo danh sách đối tượng đủ điều kiện được chỉ định cho nhóm quảng cáo.
productFeedData

object (ProductFeedData)

Chế độ cài đặt của nguồn cấp dữ liệu sản phẩm trong nhóm quảng cáo này.

YoutubeAndPartnersAdGroupFormat

Định dạng của nhóm quảng cáo trên YouTube.

Enum
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Giá trị định dạng chưa được chỉ định hoặc không xác định trong phiên bản này.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Quảng cáo trong luồng phát.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Quảng cáo trong nguồn cấp dữ liệu.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Quảng cáo đệm.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Quảng cáo trong luồng phát không thể bỏ qua.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Quảng cáo dạng âm thanh trong luồng phát không thể bỏ qua.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Quảng cáo thích ứng cho chiến dịch thúc đẩy hành động trong quảng cáo dạng video.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Nhóm quảng cáo có phạm vi tiếp cận hiệu quả, bao gồm cả quảng cáo trong luồng phát và quảng cáo đệm.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Quảng cáo trên đầu trang chủ hiển thị ở vị trí hàng đầu trên trang chủ YouTube.

ProductFeedData

Thông tin chi tiết về nguồn cấp dữ liệu sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Trường
productMatchType

enum (ProductMatchType)

Cách sản phẩm được chọn theo nguồn cấp dữ liệu sản phẩm.
productMatchDimensions[]

object (ProductMatchDimension)

Danh sách phương diện được dùng để so khớp sản phẩm.
isFeedDisabled

boolean

Liệu nguồn cấp dữ liệu sản phẩm đã chọn không hiển thị sản phẩm hay chưa.

ProductMatchType

Các loại phương thức so khớp sản phẩm.

Enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Chưa được chỉ định hoặc không xác định.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Tất cả sản phẩm đều trùng khớp.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Một số sản phẩm đã được chọn.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL So khớp sản phẩm theo nhãn tuỳ chỉnh.

ProductMatchDimension

Phương diện dùng để so khớp sản phẩm.

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

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Trường
Trường hợp dimension. Phương diện và giá trị khớp với sản phẩm. dimension chỉ có thể là một trong những trạng thái sau:
productOfferId

string

Mã của sản phẩm để so khớp với một sản phẩm có cùng mã mặt hàng.
customLabel

object (CustomLabel)

Nhãn tuỳ chỉnh để ghép tất cả sản phẩm với nhãn đó.

CustomLabel

Khoá và giá trị của một nhãn tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Trường
key

enum (CustomLabelKey)

Khoá của nhãn.
value

string

Giá trị của nhãn.

CustomLabelKey

Khoá của nhãn tuỳ chỉnh

Enum
CUSTOM_LABEL_KEY_UNSPECIFIED Chưa được chỉ định hoặc không xác định.
CUSTOM_LABEL_KEY_0 Chỉ mục khoá 0.
CUSTOM_LABEL_KEY_1 Chỉ mục chính 1.
CUSTOM_LABEL_KEY_2 Chỉ mục chính 2.
CUSTOM_LABEL_KEY_3 Chỉ mục chính 3.
CUSTOM_LABEL_KEY_4 Chỉ mục chính 4.

Phương thức

bulkListAdGroupAssignedTargetingOptions

 Liệt kê các lựa chọn nhắm mục tiêu được chỉ định cho nhiều nhóm quảng cáo trên YouTube theo các loại tiêu chí nhắm mục tiêu.

get

 Nhận một nhóm quảng cáo trên YouTube.

list

 Liệt kê các nhóm quảng cáo trên YouTube.