REST Resource: advertisers.adGroups

ทรัพยากร: AdGroup

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

การแสดง 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)
    }
  ]
}
ช่อง
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 ระบุการควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา
adSource

enum (AdSource)

ไม่บังคับ แหล่งที่มาของโฆษณาในกลุ่มโฆษณานี้ ระบบจะใช้ฟิลด์นี้เมื่อสร้างโฆษณาโดยอัตโนมัติจากแหล่งที่มาที่ระบุเท่านั้น
creativeAssignments[]

object (CreativeAssignment)

ไม่บังคับ ครีเอทีฟโฆษณาที่ใช้สร้างโฆษณาในกลุ่มโฆษณา

คุณจะกำหนดช่องนี้ได้ก็ต่อเมื่อ adSource เป็น AD_SOURCE_DV360_CREATIVE เท่านั้น

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 
{

  // 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.
}
ช่อง
มิติข้อมูลและค่าที่จะจับคู่กับผลิตภัณฑ์ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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 
{

  // 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.
}
ช่อง
การควบคุมพื้นที่โฆษณาของกลุ่มโฆษณา ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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 หรือไม่

AdSource

แหล่งที่มาของโฆษณาใน adGroup นี้

Enum
AD_SOURCE_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ ค่าเริ่มต้นคือแหล่งที่มาของโฆษณาปกติ
AD_SOURCE_DV360_CREATIVE มาจากครีเอทีฟโฆษณา DV360

CreativeAssignment

รายละเอียดของครีเอทีฟโฆษณาที่กำหนดให้กับกลุ่มโฆษณา

การแสดง JSON 
{
  "creativeId": string
}
ช่อง
creativeId

string (int64 format)

ต้องระบุ รหัสของครีเอทีฟโฆษณา Display & Video 360 ที่กำหนดให้กับกลุ่มโฆษณา

เมธอด

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

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

delete

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

get

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

list

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

patch

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