REST Resource: advertisers.adGroups

ทรัพยากร: กลุ่มโฆษณา

กลุ่มโฆษณาเดียวที่เชื่อมโยงกับรายการโฆษณา

การแสดง 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)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรของกลุ่มโฆษณา
advertiserId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่กลุ่มโฆษณาเป็นของ
adGroupId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของกลุ่มโฆษณา ระบบกำหนด
lineItemId

string (int64 format)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของรายการโฆษณาที่กลุ่มโฆษณาเป็นของ
displayName

string

ต้องระบุ ชื่อที่แสดงของกลุ่มโฆษณา

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 255 ไบต์
adGroupFormat

enum (AdGroupFormat)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รูปแบบของโฆษณาในกลุ่มโฆษณา
bidStrategy

object (BiddingStrategy)

ไม่บังคับ กลยุทธ์การเสนอราคาที่กลุ่มโฆษณาใช้ ใช้ได้เฉพาะฟิลด์ youtubeAndPartnersBid และ demandGenBid ในกลยุทธ์การเสนอราคา
entityStatus

enum (EntityStatus)

ต้องระบุ ควบคุมว่ากลุ่มโฆษณาจะใช้งบประมาณและเสนอราคาในพื้นที่โฆษณาได้หรือไม่

หากรายการโฆษณาหลักของกลุ่มโฆษณาไม่ทำงาน กลุ่มโฆษณาจะใช้งบประมาณไม่ได้แม้ว่าสถานะของกลุ่มโฆษณาเองจะเป็น ENTITY_STATUS_ACTIVE ก็ตาม
targetingExpansion

object (TargetingExpansionConfig)

ไม่บังคับ การตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพของกลุ่มโฆษณา
productFeedData

object (ProductFeedData)

ไม่บังคับ การตั้งค่าฟีดสินค้าในกลุ่มโฆษณานี้
adGroupInventoryControl

object (AdGroupInventoryControl)

ไม่บังคับ ต้องระบุสำหรับกลุ่มโฆษณา Demand Gen ระบุการควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา

AdGroupFormat

รูปแบบของกลุ่มโฆษณา

Enum
AD_GROUP_FORMAT_UNSPECIFIED ไม่ได้ระบุค่ารูปแบบหรือไม่รู้จักในเวอร์ชันนี้
AD_GROUP_FORMAT_IN_STREAM โฆษณาในสตรีม
AD_GROUP_FORMAT_VIDEO_DISCOVERY โฆษณาในฟีด
AD_GROUP_FORMAT_BUMPER โฆษณาบัมเปอร์
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM โฆษณาในสตรีมแบบข้ามไม่ได้
AD_GROUP_FORMAT_AUDIO โฆษณาเสียงในสตรีมแบบข้ามไม่ได้
AD_GROUP_FORMAT_RESPONSIVE โฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณา
AD_GROUP_FORMAT_REACH กลุ่มโฆษณาเพื่อการเข้าถึงที่มีประสิทธิภาพ รวมถึงโฆษณาในสตรีมและโฆษณาบัมเปอร์
AD_GROUP_FORMAT_MASTHEAD โฆษณา Masthead ที่แสดงในช่องด้านบนสุดในหน้าแรกของ YouTube
AD_GROUP_FORMAT_DEMAND_GEN

โฆษณา Demand Gen

ProductFeedData

รายละเอียดของฟีดสินค้า

การแสดง JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
ช่อง
productMatchType

enum (ProductMatchType)

วิธีที่ฟีดสินค้าเลือกผลิตภัณฑ์
productMatchDimensions[]

object (ProductMatchDimension)

รายการมิติข้อมูลที่ใช้เพื่อจับคู่ผลิตภัณฑ์
isFeedDisabled

boolean

ฟีดสินค้าเลือกไม่ให้แสดงผลิตภัณฑ์หรือไม่

ProductMatchType

ประเภทของวิธีจับคู่ผลิตภัณฑ์

Enum
PRODUCT_MATCH_TYPE_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ
PRODUCT_MATCH_TYPE_ALL_PRODUCTS ผลิตภัณฑ์ทั้งหมดตรงกัน
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS เลือกผลิตภัณฑ์ที่เฉพาะเจาะจง
PRODUCT_MATCH_TYPE_CUSTOM_LABEL จับคู่ผลิตภัณฑ์ตามป้ายกำกับที่กำหนดเอง

ProductMatchDimension

มิติข้อมูลที่ใช้ในการจับคู่ผลิตภัณฑ์

การแสดง 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.
}
ช่อง
ฟิลด์ Union dimension มิติข้อมูลและค่าที่จะใช้จับคู่ผลิตภัณฑ์ dimension ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
productOfferId

string

รหัสข้อเสนอผลิตภัณฑ์ที่จะจับคู่กับผลิตภัณฑ์ที่มีรหัสข้อเสนอเดียวกัน
customLabel

object (CustomLabel)

ป้ายกำกับที่กำหนดเองที่ตรงกับผลิตภัณฑ์ทั้งหมดที่มีป้ายกำกับ

CustomLabel

คีย์และค่าของป้ายกำกับที่กำหนดเอง

การแสดง JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
ช่อง
key

enum (CustomLabelKey)

คีย์ของป้ายกำกับ
value

string

ค่าของป้ายกำกับ

CustomLabelKey

คีย์ของป้ายกำกับที่กำหนดเอง

Enum
CUSTOM_LABEL_KEY_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ
CUSTOM_LABEL_KEY_0 ดัชนีหลัก 0
CUSTOM_LABEL_KEY_1 ดัชนีหลัก 1
CUSTOM_LABEL_KEY_2 ดัชนีคีย์ 2
CUSTOM_LABEL_KEY_3 ดัชนีสำคัญ 3
CUSTOM_LABEL_KEY_4 ดัชนีสำคัญ 4

AdGroupInventoryControl

การควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา

การแสดง JSON 
{

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
ช่อง
ฟิลด์ Union inventory_controls การควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา inventory_controls ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

กลยุทธ์พื้นที่โฆษณา
selectedInventories

object (SelectedInventories)

พื้นที่โฆษณาที่เลือก

AdGroupInventoryStrategy

กลยุทธ์พื้นที่โฆษณาสําหรับกลุ่มโฆษณา

Enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY กลุ่มโฆษณาเลือกใช้พื้นที่โฆษณาทั้งหมดของ Google และเครือข่าย Display
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY กลุ่มโฆษณาเลือกใช้พื้นที่โฆษณาทั้งหมดของ Google

SelectedInventories

การควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา

การแสดง JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
ช่อง
allowYoutubeStream

boolean

กลุ่มโฆษณาเลือกใช้พื้นที่โฆษณาในสตรีมบน YouTube หรือไม่
allowYoutubeShorts

boolean

กลุ่มโฆษณาเลือกใช้พื้นที่โฆษณา YouTube Shorts หรือไม่
allowYoutubeFeed

boolean

ไม่ว่ากลุ่มโฆษณาจะเลือกใช้พื้นที่โฆษณาในฟีดของ YouTube หรือไม่
allowDiscover

boolean

ไม่ว่ากลุ่มโฆษณาจะเลือกใช้พื้นที่โฆษณาของ Discover หรือไม่
allowGmail

boolean

กลุ่มโฆษณาเลือกใช้พื้นที่โฆษณา Gmail หรือไม่
allowGoogleDisplayNetwork

boolean

ไม่ว่ากลุ่มโฆษณาจะเลือกใช้พื้นที่โฆษณาของเครือข่าย Display ของ Google หรือไม่

เมธอด

bulkEditAssignedTargetingOptions

 แก้ไขตัวเลือกการกำหนดเป้าหมายเป็นกลุ่มสําหรับกลุ่มโฆษณาหลายกลุ่ม

bulkListAssignedTargetingOptions

 แสดงตัวเลือกการกำหนดเป้าหมายที่กำหนดให้กับกลุ่มโฆษณาหลายกลุ่มในประเภทการกำหนดเป้าหมายต่างๆ

create

 สร้างกลุ่มโฆษณาใหม่

delete

 ลบ AdGroup

get

 รับกลุ่มโฆษณา

list

 แสดงกลุ่มโฆษณา

patch

 อัปเดตกลุ่มโฆษณาที่มีอยู่