REST Resource: advertisers.adGroups

Tài nguyên: Nhóm quảng cáo

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

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên tài nguyên của nhóm quảng cáo.
advertiserId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo sở hữu nhóm quảng cáo.
adGroupId

string (int64 format)

Chỉ có đầu ra. 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)

Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của mục hàng chứa nhóm quảng cáo.
displayName

string

Bắt buộc. 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.
adGroupFormat

enum (AdGroupFormat)

Bắt buộc. Không thể thay đổi. Định dạng của quảng cáo trong nhóm quảng cáo.
bidStrategy

object (BiddingStrategy)

Không bắt buộc. Chiến lược đặt giá thầu mà nhóm quảng cáo sử dụng. Bạn chỉ có thể sử dụng trường youtubeAndPartnersBid và demandGenBid trong chiến lược đặt giá thầu.
entityStatus

enum (EntityStatus)

Bắt buộc. 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 cho 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, thì 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 nhóm quảng cáo là ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Không bắt buộc. Chế độ cài đặt tối ưu hoá tiêu chí nhắm mục tiêu của nhóm quảng cáo.
productFeedData

object (ProductFeedData)

Không bắt buộc. 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.
adGroupInventoryControl

object (AdGroupInventoryControl)

Không bắt buộc. Bắt buộc đối với nhóm quảng cáo Tạo nhu cầu. Chỉ định chế độ kiểm soát khoảng không quảng cáo của nhóm quảng cáo.
adSource

enum (AdSource)

Không bắt buộc. Nguồn của quảng cáo trong nhóm quảng cáo này. Trường này chỉ được dùng khi quảng cáo được tạo tự động từ một nguồn nhất định.
creativeAssignments[]

object (CreativeAssignment)

Không bắt buộc. Mẫu quảng cáo được dùng để tạo quảng cáo trong nhóm quảng cáo.

Bạn chỉ có thể chỉ định trường này nếu adSource là AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

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

Enum
AD_GROUP_FORMAT_UNSPECIFIED Giá trị định dạng không được chỉ định hoặc không xác định trong phiên bản này.
AD_GROUP_FORMAT_IN_STREAM Quảng cáo trong luồng phát.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Quảng cáo trong nguồn cấp dữ liệu.
AD_GROUP_FORMAT_BUMPER Quảng cáo đệm.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Quảng cáo trong luồng phát không thể bỏ qua.
AD_GROUP_FORMAT_AUDIO Quảng cáo dạng âm thanh trong luồng phát không thể bỏ qua.
AD_GROUP_FORMAT_RESPONSIVE Quảng cáo thích ứng.
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.
AD_GROUP_FORMAT_MASTHEAD Quảng cáo trên đầu trang chủ xuất hiện ở vị trí trên cùng của trang chủ YouTube.
AD_GROUP_FORMAT_DEMAND_GEN Quảng cáo Tạo nhu cầu.

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 chọn sản phẩm theo nguồn cấp dữ liệu sản phẩm.
productMatchDimensions[]

object (ProductMatchDimension)

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

boolean

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

ProductMatchType

Các loại cách so khớp sản phẩm.

Enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Không được chỉ định hoặc không xác định.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Tất cả sản phẩm đều được so 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

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

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:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Trường
Phương diện và giá trị để so khớp sản phẩm. 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:
productOfferId

string

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

object (CustomLabel)

Nhãn tuỳ chỉnh để so khớp tất cả sản phẩm có nhãn này.
Kết thúc các trường loại trừ lẫn nhau.

CustomLabel

Khoá và giá trị của 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 Không đượ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 khoá 1.
CUSTOM_LABEL_KEY_2 Chỉ mục khoá 2.
CUSTOM_LABEL_KEY_3 Chỉ mục khoá 3.
CUSTOM_LABEL_KEY_4 Chỉ mục khoá 4.

AdGroupInventoryControl

Chế độ kiểm soát khoảng không quảng cáo của nhóm quảng cáo.

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:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Trường
Chế độ kiểm soát khoảng không quảng cáo của nhóm quảng cáo. 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:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Chiến lược khoảng không quảng cáo.
selectedInventories

object (SelectedInventories)

Khoảng không quảng cáo đã chọn.
Kết thúc các trường loại trừ lẫn nhau.

AdGroupInventoryStrategy

Chiến lược khoảng không quảng cáo cho nhóm quảng cáo.

Enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Không được chỉ định hoặc không xác định.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Nhóm quảng cáo đã chọn sử dụng tất cả khoảng không quảng cáo của Google và Mạng Hiển thị.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Nhóm quảng cáo này được chọn sử dụng tất cả khoảng không quảng cáo của Google.

SelectedInventories

Chế độ kiểm soát khoảng không quảng cáo của nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Trường
allowYoutubeStream

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trong luồng phát trên YouTube hay không.
allowYoutubeShorts

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trên YouTube Shorts hay không.
allowYoutubeFeed

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trong nguồn cấp dữ liệu trên YouTube hay không.
allowDiscover

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trên Khám phá hay không.
allowGmail

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trên Gmail hay không.
allowGoogleDisplayNetwork

boolean

Liệu nhóm quảng cáo có chọn sử dụng khoảng không quảng cáo trên Mạng Hiển thị của Google hay không.

AdSource

Nguồn cho quảng cáo trong adGroup này.

Enum
AD_SOURCE_UNSPECIFIED Không được chỉ định hoặc không xác định. Mặc định là nguồn quảng cáo thông thường.
AD_SOURCE_DV360_CREATIVE Lấy từ một mẫu quảng cáo trên DV360.

CreativeAssignment

Thông tin chi tiết về mẫu quảng cáo được chỉ định cho nhóm quảng cáo.

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

string (int64 format)

Bắt buộc. Mã của mẫu quảng cáo Display & Video 360 được chỉ định cho nhóm quảng cáo.

Phương thức

bulkEditAssignedTargetingOptions

 Chỉnh sửa hàng loạt các lựa chọn nhắm mục tiêu cho nhiều nhóm quảng cáo.

bulkListAssignedTargetingOptions

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

create

 Tạo một nhóm quảng cáo mới.

delete

 Xoá một AdGroup.

get

 Lấy một nhóm quảng cáo.

list

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

patch

 Cập nhật một nhóm quảng cáo hiện có.