REST Resource: advertisers.youtubeAdGroups

ทรัพยากร: YoutubeAdGroup

กลุ่มโฆษณา YouTube กลุ่มเดียวที่เชื่อมโยงกับรายการโฆษณา YouTube และพาร์ทเนอร์

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

string

ชื่อทรัพยากรของกลุ่มโฆษณา
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

รหัสที่ไม่ซ้ำของรายการโฆษณาที่กลุ่มโฆษณาอยู่
displayName

string

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

ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 255 ไบต์
youtubeAdIds[]

string (int64 format)

รหัสของทรัพยากร [youtube_ad_group_ad][] ที่เชื่อมโยงกับกลุ่มโฆษณา
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

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

object (YoutubeAndPartnersBiddingStrategy)

กลยุทธ์การเสนอราคาที่กลุ่มโฆษณาใช้
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

การตั้งค่าการขยายการกําหนดเป้าหมายของกลุ่มโฆษณา

การกําหนดค่านี้จะใช้ได้ก็ต่อเมื่อมีการกำหนดการกำหนดเป้าหมายรายการกลุ่มเป้าหมายที่มีสิทธิ์ให้กับกลุ่มโฆษณา
productFeedData

object (ProductFeedData)

การตั้งค่าฟีดผลิตภัณฑ์ในกลุ่มโฆษณานี้

YoutubeAndPartnersAdGroupFormat

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

Enum
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED ไม่ได้ระบุค่ารูปแบบหรือไม่รู้จักค่ารูปแบบในเวอร์ชันนี้
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM โฆษณาในสตรีม
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY โฆษณาในฟีด
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER โฆษณาบัมเปอร์
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM โฆษณาในสตรีมแบบข้ามไม่ได้
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO โฆษณาเสียงในสตรีมแบบข้ามไม่ได้
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION โฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณาสําหรับแคมเปญวิดีโอเพื่อกระตุ้นการกระทํา
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH กลุ่มโฆษณาเพื่อการเข้าถึงที่มีประสิทธิภาพ ซึ่งรวมถึงโฆษณาในสตรีมและโฆษณาบัมเปอร์
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD โฆษณา Masthead ที่แสดงในช่องด้านบนสุดในหน้าแรกของ YouTube

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.
}
ช่อง
ฟิลด์สหภาพ 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.

เมธอด

bulkListAdGroupAssignedTargetingOptions

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

get

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

list

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