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 
{

  // 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 หรือไม่

เมธอด

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

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

delete

 ลบ AdGroup

get

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

list

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

patch

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