REST Resource: advertisers.adGroupAds

แหล่งข้อมูล: AdGroupAd

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

การแสดง JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
ช่อง
name

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

object (AdPolicy)

เอาต์พุตเท่านั้น สถานะการอนุมัติตามนโยบายของโฆษณา
entityStatus

enum (EntityStatus)

ต้องระบุ สถานะเอนทิตีของโฆษณา
adUrls[]

object (AdUrl)

เอาต์พุตเท่านั้น รายการ URL ที่โฆษณาใช้
dcmTrackingInfo

object (DcmTrackingInfo)

ไม่บังคับ ข้อมูลโฆษณาเพื่อการติดตาม DCM ใช้ได้กับโฆษณา Demand Gen เท่านั้น

หากต้องการนำข้อมูลโฆษณาเพื่อการติดตาม DCM ออก โปรดปล่อยช่องนี้ว่างไว้
รายละเอียดของโฆษณา ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
displayVideoSourceAd

object (DisplayVideoSourceAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาที่มาจากครีเอทีฟโฆษณา Display & Video 360
mastheadAd

object (MastheadAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาที่แสดงในฟีดบนหน้าแรกของ YouTube
inStreamAd

object (InStreamAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาในสตรีมแบบข้ามได้หลังจาก 5 วินาที ซึ่งใช้เพื่อวัตถุประสงค์ทางการตลาดด้านการรับรู้ถึงแบรนด์หรือการเข้าถึง
nonSkippableAd

object (NonSkippableAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาวิดีโอในสตรีมแบบสั้นแบบข้ามไม่ได้ที่มีความยาวระหว่าง 6-15 วินาที ซึ่งใช้เพื่อวัตถุประสงค์ทางการตลาดด้านการเข้าถึง
bumperAd

object (BumperAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาวิดีโอสั้นแบบข้ามไม่ได้ที่มีความยาวไม่เกิน 6 วินาที ซึ่งใช้เพื่อการเข้าถึง
audioAd

object (AudioAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาเสียงที่ใช้เพื่อวัตถุประสงค์ทางการตลาดด้านการเข้าถึง
videoDiscoverAd

object (VideoDiscoveryAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาที่โปรโมตวิดีโอซึ่งแสดงในที่ที่ผู้ใช้ค้นพบ
videoPerformanceAd

object (VideoPerformanceAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาที่ใช้ในแคมเปญวิดีโอเพื่อกระตุ้นการกระทำเพื่อกระตุ้นการกระทำให้กับธุรกิจ บริการ หรือผลิตภัณฑ์
demandGenVideoAd

object (DemandGenVideoAd)

รายละเอียดของโฆษณาวิดีโอ Demand Gen
demandGenImageAd

object (DemandGenImageAd)

รายละเอียดของโฆษณาแบบรูปภาพ Demand Gen
demandGenProductAd

object (DemandGenProductAd)

รายละเอียดของโฆษณาผลิตภัณฑ์ Demand Gen
สิ้นสุดฟิลด์ที่แยกกัน

DisplayVideoSourceAd

โฆษณาที่มาจากครีเอทีฟโฆษณา DV360

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

string (int64 format)

รหัสของครีเอทีฟโฆษณาแหล่งที่มา

MastheadAd

รายละเอียดสำหรับโฆษณา Masthead

การแสดง JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
ช่อง
video

object (YoutubeVideoDetails)

วิดีโอ YouTube ที่โฆษณาใช้
headline

string

บรรทัดแรกของโฆษณา
description

string

คำอธิบายของโฆษณา
videoAspectRatio

enum (VideoAspectRatio)

อัตราส่วนของวิดีโอ YouTube ที่เล่นอัตโนมัติใน Masthead
autoplayVideoStartMillisecond

string (int64 format)

ระยะเวลาในหน่วยเป็นมิลลิวินาทีหลังจากที่วิดีโอจะเริ่มเล่น
autoplayVideoDuration

string (Duration format)

ระยะเวลาที่วิดีโอจะเล่นอัตโนมัติ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
callToActionButtonLabel

string

ข้อความบนปุ่มกระตุ้นให้ดำเนินการ
callToActionFinalUrl

string

URL ปลายทางสำหรับปุ่มคำกระตุ้นการตัดสินใจ
callToActionTrackingUrl

string

URL ติดตามผลสำหรับปุ่มคำกระตุ้นการตัดสินใจ
showChannelArt

boolean

เลือกว่าจะแสดงพื้นหลังหรือแบนเนอร์ที่ปรากฏที่ด้านบนของหน้า YouTube หรือไม่
companionYoutubeVideos[]

object (YoutubeVideoDetails)

วิดีโอที่ปรากฏข้างโฆษณา Masthead บนเดสก์ท็อป มีได้ไม่เกิน 2 รายการ

YoutubeVideoDetails

รายละเอียดของวิดีโอ YouTube

การแสดง JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
ช่อง
id

string

เอาต์พุตเท่านั้น รหัสวิดีโอ YouTube ซึ่งค้นหาได้ในหน้าเว็บ YouTube
unavailableReason

enum (VideoUnavailableReason)

เหตุผลที่ข้อมูลวิดีโอไม่พร้อมใช้งาน
videoAssetId

string (int64 format)

ต้องระบุ รหัสชิ้นงานวิดีโอ YouTube นี่คือ adAssetId ของทรัพยากร AdAsset

VideoUnavailableReason

สาเหตุที่อาจทำให้วิดีโอไม่พร้อมใช้งาน

Enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED ไม่ทราบหรือไม่ระบุ
VIDEO_UNAVAILABLE_REASON_PRIVATE วิดีโอเป็นแบบส่วนตัว
VIDEO_UNAVAILABLE_REASON_DELETED ระบบจะลบวิดีโอ

VideoAspectRatio

สัดส่วนภาพที่เป็นไปได้สำหรับวิดีโอ YouTube

Enum
VIDEO_ASPECT_RATIO_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ
VIDEO_ASPECT_RATIO_WIDESCREEN วิดีโอจะยืดออกและครอบตัดส่วนบนและล่าง
VIDEO_ASPECT_RATIO_FIXED_16_9 วิดีโอใช้สัดส่วนภาพ 16:9 แบบคงที่

InStreamAd

รายละเอียดสำหรับโฆษณาในสตรีม

การแสดง JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
ช่อง
commonInStreamAttribute

object (CommonInStreamAttribute)

แอตทริบิวต์โฆษณาทั่วไป
customParameters

map (key: string, value: string)

พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

แอตทริบิวต์ทั่วไปสำหรับโฆษณาในสตรีม โฆษณาแบบข้ามไม่ได้ และโฆษณาบัมเปอร์

การแสดง JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
ช่อง
displayUrl

string

ที่อยู่หน้าเว็บที่ปรากฏพร้อมกับโฆษณา
finalUrl

string

ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
trackingUrl

string

ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
actionButtonLabel

string

ข้อความบนปุ่มกระตุ้นให้ดำเนินการ
actionHeadline

string

บรรทัดแรกของแบนเนอร์คำกระตุ้นให้ดำเนินการ
video

object (YoutubeVideoDetails)

วิดีโอ YouTube ของโฆษณา
companionBanner

object (ImageAsset)

รูปภาพที่แสดงข้างโฆษณาวิดีโอ

ImageAsset

ข้อมูลเมตาของชิ้นงานรูปภาพ

การแสดง JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
ช่อง
mimeType

string

เอาต์พุตเท่านั้น ประเภท MIME ของชิ้นงานรูปภาพ
fullSize

object (Dimensions)

เอาต์พุตเท่านั้น ข้อมูลเมตาของรูปภาพนี้ในขนาดต้นฉบับ
fileSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดไฟล์ของชิ้นงานรูปภาพในหน่วยไบต์
assetId

string (int64 format)

ต้องระบุ รหัสที่ไม่ซ้ำกันของชิ้นงาน

NonSkippableAd

รายละเอียดสำหรับโฆษณาแบบข้ามไม่ได้

การแสดง JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
ช่อง
commonInStreamAttribute

object (CommonInStreamAttribute)

แอตทริบิวต์โฆษณาทั่วไป
customParameters

map (key: string, value: string)

พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

BumperAd

รายละเอียดสำหรับโฆษณาบัมเปอร์

การแสดง JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
ช่อง
commonInStreamAttribute

object (CommonInStreamAttribute)

แอตทริบิวต์โฆษณาทั่วไป

AudioAd

รายละเอียดสำหรับโฆษณาเสียง

การแสดง JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
ช่อง
displayUrl

string

ที่อยู่หน้าเว็บที่ปรากฏพร้อมกับโฆษณา
finalUrl

string

ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
trackingUrl

string

ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
video

object (YoutubeVideoDetails)

วิดีโอ YouTube ของโฆษณา

VideoDiscoveryAd

รายละเอียดสำหรับโฆษณา Video Discovery

การแสดง JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
ช่อง
headline

string

บรรทัดแรกของโฆษณา
description1

string

ข้อความบรรทัดแรกของโฆษณา
description2

string

ข้อความบรรทัดที่ 2 สำหรับโฆษณา
video

object (YoutubeVideoDetails)

วิดีโอ YouTube ที่โฆษณาโปรโมต
thumbnail

enum (Thumbnail)

ภาพปกที่ใช้ในโฆษณา

ภาพขนาดย่อ

ตัวเลือกภาพปกที่เป็นไปได้ในโฆษณา Video Discovery

Enum
THUMBNAIL_UNSPECIFIED ไม่ทราบหรือไม่ระบุ
THUMBNAIL_DEFAULT ปกเริ่มต้นอาจสร้างขึ้นโดยอัตโนมัติหรือผู้ใช้อัปโหลด
THUMBNAIL_1 ภาพปก 1 ที่สร้างจากวิดีโอ
THUMBNAIL_2 ภาพปก 2 ที่สร้างจากวิดีโอ
THUMBNAIL_3 ภาพปก 3 ที่สร้างจากวิดีโอ

VideoPerformanceAd

รายละเอียดสำหรับโฆษณาวิดีโอเพื่อประสิทธิภาพ

การแสดง JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
ช่อง
finalUrl

string

ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
trackingUrl

string

ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
actionButtonLabels[]

string

รายการชิ้นงานข้อความที่แสดงบนปุ่มกระตุ้นให้ดำเนินการ
headlines[]

string

รายการบรรทัดแรกที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ
longHeadlines[]

string

รายการบรรทัดแรกแบบยาวที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action)
descriptions[]

string

รายการคำอธิบายที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ (Call-To-Action)
displayUrlBreadcrumb1

string

ส่วนแรกหลังจากโดเมนใน URL ที่แสดง
displayUrlBreadcrumb2

string

ส่วนที่ 2 หลังจากโดเมนใน URL ที่แสดง
domain

string

โดเมนของ URL ที่แสดง
videos[]

object (YoutubeVideoDetails)

รายการชิ้นงานวิดีโอ YouTube ที่โฆษณานี้ใช้
customParameters

map (key: string, value: string)

พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]

object (ImageAsset)

รายการแบนเนอร์ที่แสดงร่วมกันซึ่งโฆษณานี้ใช้

DemandGenVideoAd

รายละเอียดสำหรับโฆษณาวิดีโอ Demand Gen

การแสดง JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
ช่อง
finalUrl

string

ต้องระบุ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
trackingUrl

string

เอาต์พุตเท่านั้น ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
userSpecifiedTrackingUrl

string

ไม่บังคับ URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง
callToAction

enum (CallToAction)

ต้องระบุ ปุ่มกระตุ้นให้ดำเนินการที่แสดงในโฆษณา

ค่าที่รองรับมีดังนี้

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

ต้องระบุ รายการบรรทัดแรกที่แสดงในโฆษณา
longHeadlines[]

string

ต้องระบุ รายการบรรทัดแรกแบบยาวที่แสดงในโฆษณา
descriptions[]

string

ต้องระบุ รายการคำอธิบายที่แสดงในโฆษณา
displayUrlBreadcrumb1

string

ไม่บังคับ ส่วนแรกหลังจากโดเมนใน URL ที่แสดง
displayUrlBreadcrumb2

string

ไม่บังคับ ส่วนที่ 2 หลังจากโดเมนใน URL ที่แสดง
videos[]

object (YoutubeVideoDetails)

ต้องระบุ รายการชิ้นงานวิดีโอ YouTube ที่โฆษณานี้ใช้
customParameters

map (key: string, value: string)

ไม่บังคับ พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanner

object (ImageAsset)

ไม่บังคับ แบนเนอร์ที่แสดงร่วมกันซึ่งโฆษณานี้ใช้
finalMobileUrl

string

ไม่บังคับ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณาในอุปกรณ์เคลื่อนที่
finalUrlSuffix

string

ไม่บังคับ คำต่อท้ายที่จะต่อท้าย URL ของหน้า Landing Page
businessName

string

ไม่บังคับ ชื่อธุรกิจที่แสดงในโฆษณา

ต้องมีการตั้งค่านี้ เว้นแต่จะมีการตั้งค่าเริ่มต้นที่ระดับผู้ลงโฆษณา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น

CallToAction

ค่าคำกระตุ้นให้ดำเนินการที่เป็นไปได้สำหรับโฆษณาผลิตภัณฑ์/วิดีโอ Demand Gen

Enum
CALL_TO_ACTION_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบ
AUTOMATED อัตโนมัติ
LEARN_MORE ดูข้อมูลเพิ่มเติม
GET_QUOTE รับใบเสนอราคา
APPLY_NOW สมัครเลย
SIGN_UP ลงชื่อสมัครใช้
CONTACT_US ติดต่อเรา
SUBSCRIBE ติดตาม
DOWNLOAD ดาวน์โหลด
BOOK_NOW จองเลย
SHOP_NOW ซื้อเลย
BUY_NOW ซื้อเลย
DONATE_NOW บริจาคเลย
ORDER_NOW สั่งซื้อเลย
PLAY_NOW เล่นเลย
SEE_MORE ดูเพิ่มเติม
START_NOW เริ่มใช้เลย
VISIT_SITE เข้าชมเว็บไซต์
WATCH_NOW ดูเดี๋ยวนี้

DemandGenImageAd

รายละเอียดสำหรับโฆษณาแบบรูปภาพ Demand Gen

การแสดง JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
ช่อง
finalUrl

string

ต้องระบุ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
trackingUrl

string

เอาต์พุตเท่านั้น ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
userSpecifiedTrackingUrl

string

ไม่บังคับ URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง
callToAction

string

ต้องระบุ ปุ่มกระตุ้นให้ดำเนินการที่แสดงในโฆษณา
headlines[]

string

ต้องระบุ รายการบรรทัดแรกที่แสดงในโฆษณา
descriptions[]

string

ต้องระบุ รายการคำอธิบายที่แสดงในโฆษณา
customParameters

map (key: string, value: string)

ไม่บังคับ พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
finalMobileUrl

string

ไม่บังคับ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณาในอุปกรณ์เคลื่อนที่
finalUrlSuffix

string

ไม่บังคับ คำต่อท้ายที่จะต่อท้าย URL ของหน้า Landing Page
businessName

string

ไม่บังคับ ชื่อธุรกิจที่แสดงในโฆษณา

ต้องมีการตั้งค่านี้ เว้นแต่จะมีการตั้งค่าเริ่มต้นที่ระดับผู้ลงโฆษณา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น
marketingImages[]

object (ImageAsset)

รายการรูปภาพทางการตลาดที่แสดงในโฆษณา
squareMarketingImages[]

object (ImageAsset)

รายการรูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่แสดงในโฆษณา
portraitMarketingImages[]

object (ImageAsset)

รายการรูปภาพการตลาดแนวตั้งที่แสดงในโฆษณา
logoImages[]

object (ImageAsset)

รายการรูปภาพโลโก้ที่แสดงในโฆษณา

ต้องมีการตั้งค่านี้ เว้นแต่จะมีการตั้งค่าเริ่มต้นที่ระดับผู้ลงโฆษณา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น

DemandGenCarouselAd

รายละเอียดสำหรับโฆษณา Carousel Demand Gen

การแสดง JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
ช่อง
finalUrl

string

ต้องระบุ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
headline

string

ต้องระบุ บรรทัดแรกของโฆษณา
description

string

ต้องระบุ คำอธิบายของโฆษณา
cards[]

object (CarouselCard)

ต้องระบุ รายการการ์ดที่แสดงในโฆษณา
finalUrlSuffix

string

ไม่บังคับ คำต่อท้ายที่จะต่อท้าย URL ของหน้า Landing Page
trackingUrl

string

เอาต์พุตเท่านั้น ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
userSpecifiedTrackingUrl

string

ไม่บังคับ URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง
businessName

string

ไม่บังคับ ชื่อธุรกิจที่แสดงในโฆษณา

ต้องมีการตั้งค่านี้ เว้นแต่จะมีการตั้งค่าเริ่มต้นที่ระดับผู้ลงโฆษณา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น
customParameters

map (key: string, value: string)

ไม่บังคับ พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

CarouselCard

รายละเอียดสำหรับการ์ดภาพสไลด์ Demand Gen

การแสดง JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
ช่อง
finalUrl

string

ต้องระบุ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะไปถึงหลังจากคลิกการ์ด
finalMobileUrl

string

ไม่บังคับ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกการ์ดบนอุปกรณ์เคลื่อนที่
headline

string

ต้องระบุ บรรทัดแรกของการ์ด
callToAction

string

ต้องระบุ ข้อความบนปุ่มกระตุ้นให้ดำเนินการที่แสดงในการ์ด

ต้องใช้อักขระไม่เกิน 10 ตัว
marketingImage

object (ImageAsset)

ไม่บังคับ รูปภาพการตลาดที่แสดงในการ์ด
squareMarketingImage

object (ImageAsset)

ไม่บังคับ รูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่แสดงในการ์ด
portraitMarketingImage

object (ImageAsset)

ไม่บังคับ รูปภาพการตลาดแนวตั้งที่แสดงในการ์ด

DemandGenProductAd

รายละเอียดสำหรับโฆษณาผลิตภัณฑ์ Demand Gen

การแสดง JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
ช่อง
finalUrl

string

ต้องระบุ ที่อยู่ URL ของหน้าเว็บที่ผู้ใช้จะเข้าถึงหลังจากคลิกโฆษณา
headline

string

ต้องระบุ บรรทัดแรกของโฆษณา
description

string

ต้องระบุ คำอธิบายของโฆษณา
finalUrlSuffix

string

ไม่บังคับ คำต่อท้ายที่จะต่อท้าย URL ของหน้า Landing Page
callToAction

enum (CallToAction)

ต้องระบุ ปุ่มกระตุ้นให้ดำเนินการที่แสดงในโฆษณา

ค่าที่รองรับมีดังนี้

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

เอาต์พุตเท่านั้น ที่อยู่ URL ที่โหลดในเบื้องหลังเพื่อวัตถุประสงค์ในการติดตาม
userSpecifiedTrackingUrl

string

ไม่บังคับ URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง
businessName

string

ไม่บังคับ ชื่อธุรกิจที่แสดงในโฆษณา

ต้องมีการตั้งค่านี้ เว้นแต่จะมีการตั้งค่าเริ่มต้นที่ระดับผู้ลงโฆษณา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น
customParameters

map (key: string, value: string)

ไม่บังคับ พารามิเตอร์ที่กำหนดเองและค่าที่เกี่ยวข้องที่จะเพิ่มลงใน URL ติดตาม

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
displayUrlBreadcrumb1

string

ไม่บังคับ ส่วนแรกหลังจากโดเมนใน URL ที่แสดง
displayUrlBreadcrumb2

string

ไม่บังคับ ส่วนที่ 2 หลังจากโดเมนใน URL ที่แสดง

AdPolicy

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

การแสดง JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
ช่อง
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

สถานะการอนุมัติตามนโยบายของโฆษณา ซึ่งบ่งบอกถึงการตัดสินใจอนุมัติ
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

สถานะการตรวจสอบนโยบายของโฆษณา ซึ่งระบุว่าโฆษณาอยู่ตรงจุดใดในกระบวนการตรวจสอบ
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

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

AdPolicyApprovalStatus

สถานะที่เป็นไปได้ของการอนุมัติตามนโยบายโฆษณา

Enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN ไม่ทราบหรือไม่ระบุ
DISAPPROVED จะไม่แสดง
APPROVED_LIMITED จะแสดงโดยมีข้อจำกัด
APPROVED จะแสดงโดยไม่มีข้อจำกัด
AREA_OF_INTEREST_ONLY จะไม่แสดงในประเทศเป้าหมาย แต่อาจแสดงต่อผู้ใช้ที่ค้นหาข้อมูลเกี่ยวกับประเทศเป้าหมาย

AdPolicyReviewStatus

สถานะที่เป็นไปได้ของการตรวจสอบนโยบายโฆษณา

Enum
AD_POLICY_REVIEW_STATUS_UNKNOWN ไม่ทราบหรือไม่ระบุ
REVIEW_IN_PROGRESS อยู่ระหว่างตรวจสอบ
REVIEWED การตรวจสอบหลักเสร็จสมบูรณ์แล้ว รีวิวอื่นๆ อาจยังอยู่ระหว่างดำเนินการ
UNDER_APPEAL ส่งกลับมาเพื่อขออนุมัติหรือมีการอุทธรณ์คำตัดสินเกี่ยวกับนโยบาย
ELIGIBLE_MAY_SERVE ถือว่ามีสิทธิ์และอาจแสดง และอาจมีการตรวจสอบเพิ่มเติมในภายหลัง

AdPolicyTopicEntry

รายการที่อธิบายว่าระบบระบุว่าโฆษณามีความเกี่ยวข้องกับนโยบายโฆษณาอย่างไร

การแสดง JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
ช่อง
policyTopic

string

หัวข้อนโยบาย

เช่น "เครื่องหมายการค้า" "เครื่องดื่มแอลกอฮอล์" เป็นต้น
policyLabel

string

ข้อความป้ายกำกับที่แปลแล้วสำหรับนโยบาย

เช่น "เครื่องหมายการค้าในข้อความ" "มีแอลกอฮอล์" เป็นต้น
policyTopicDescription

string

คำอธิบายสรุปสั้นๆ ของหัวข้อนโยบาย
policyTopicType

enum (AdPolicyTopicEntryType)

การแสดงโฆษณาจะได้รับผลกระทบอย่างไรเนื่องจากมีความเกี่ยวข้องกับหัวข้อนโยบายโฆษณา
policyDecisionType

enum (AdPolicyDecisionType)

แหล่งที่มาของคำตัดสินเกี่ยวกับนโยบาย
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

วิธีการบังคับใช้นโยบายที่ใช้ในการตรวจสอบนโยบาย
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

หลักฐานที่ใช้ในคำตัดสินเกี่ยวกับนโยบาย
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

ข้อจำกัดในการแสดงโฆษณาที่เกี่ยวข้องกับคำตัดสินเกี่ยวกับนโยบาย
appealInfo

object (AdPolicyTopicAppealInfo)

ข้อมูลเกี่ยวกับวิธียื่นอุทธรณ์คำตัดสินเกี่ยวกับนโยบาย

AdPolicyTopicEntryType

ผลกระทบที่อาจเกิดขึ้นต่อการแสดงโฆษณาจากหัวข้อนโยบายโฆษณา

Enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN ไม่ทราบหรือไม่ระบุ
PROHIBITED แหล่งข้อมูลจะไม่แสดง
FULLY_LIMITED แหล่งข้อมูลจะไม่แสดงในประเทศเป้าหมายทั้งหมด
LIMITED แหล่งข้อมูลไม่สามารถแสดงในบางประเทศ
DESCRIPTIVE ทรัพยากรแสดงได้
BROADENING แหล่งข้อมูลสามารถให้บริการและอาจให้บริการนอกเหนือจากความครอบคลุมปกติ
AREA_OF_INTEREST_ONLY ทรัพยากรถูกจำกัดสำหรับประเทศเป้าหมายทั้งหมด แต่อาจแสดงต่อผู้ใช้ที่ค้นหาข้อมูลเกี่ยวกับประเทศเป้าหมาย

AdPolicyDecisionType

แหล่งที่มาที่เป็นไปได้ของคำตัดสินเกี่ยวกับนโยบาย

Enum
AD_POLICY_DECISION_TYPE_UNKNOWN ไม่ทราบหรือไม่ระบุ
PURSUANT_TO_NOTICE การตัดสินใจดังกล่าวมาจากหนังสือแจ้งทางกฎหมาย คำสั่งศาล หรือการร้องเรียนจากเจ้าของเนื้อหาเครื่องหมายการค้า เป็นต้น
GOOGLE_INVESTIGATION การตัดสินมาจากการตรวจสอบของ Google

AdPolicyEnforcementMeans

วิธีการบังคับใช้นโยบายที่เป็นไปได้ซึ่งใช้ในการตรวจสอบนโยบาย

Enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN ไม่ทราบหรือไม่ระบุ
AUTOMATED กระบวนการบังคับใช้เป็นแบบอัตโนมัติทั้งหมด
HUMAN_REVIEW มีมนุษย์เข้ามาเกี่ยวข้องในกระบวนการบังคับใช้การตัดสินใจบางส่วนหรือทั้งหมด

AdPolicyTopicEvidence

ข้อมูลหลักฐานที่ใช้ในคำตัดสินเกี่ยวกับนโยบาย

การแสดง JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
ช่อง
หลักฐานสำหรับคำตัดสินเกี่ยวกับนโยบาย ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
textList

object (TextList)

รายการหลักฐานที่พบในข้อความของโฆษณา
websiteList

object (WebsiteList)

รายการเว็บไซต์ที่ลิงก์กับโฆษณา
httpCode

integer

รหัส HTTP ที่แสดงเมื่อมีการ Crawl URL สุดท้าย
languageCode

string

ภาษาที่ตรวจพบว่าใช้เขียนโฆษณา

ฟิลด์นี้ใช้แท็กภาษา IETF เช่น "en-US"
destinationTextList

object (DestinationTextList)

ข้อความในปลายทางของโฆษณาที่ทําให้เกิดการละเมิดนโยบาย
destinationMismatch

object (DestinationMismatch)

URL ปลายทางของโฆษณาไม่ตรงกัน
destinationNotWorking

object (DestinationNotWorking)

ข้อมูลเกี่ยวกับข้อผิดพลาดของ HTTP หรือ DNS ที่เกี่ยวข้องกับปลายทางของโฆษณา
trademark

object (Trademark)

คำที่เป็นเครื่องหมายการค้าซึ่งทำให้เกิดการละเมิดนโยบาย
legalRemoval

object (LegalRemoval)

การบังคับใช้กฎระเบียบที่เกี่ยวข้องกับกฎหมายซึ่งทำให้เกิดการละเมิดนโยบาย
counterfeit

object (Counterfeit)

การบังคับใช้การลอกเลียนแบบที่ทำให้เกิดการละเมิดนโยบาย
regionalRequirements

object (RegionalRequirements)

การบังคับใช้เชิงรุกของ T&S ที่ทําให้เกิดการละเมิดนโยบาย
สิ้นสุดฟิลด์ที่แยกกัน

TextList

รายการข้อความบางส่วนที่ละเมิดนโยบาย

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

string

ข้อความบางส่วนจากแหล่งข้อมูลที่ทำให้พบการละเมิดนโยบาย

WebsiteList

รายการเว็บไซต์ที่ละเมิดนโยบาย

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

string

เว็บไซต์ที่ทำให้พบการละเมิดนโยบาย

DestinationTextList

รายการข้อความปลายทางที่ละเมิดนโยบาย

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

string

ข้อความปลายทางที่ทําให้พบการละเมิดนโยบาย

DestinationMismatch

รายละเอียดเกี่ยวกับความไม่ตรงกันระหว่างประเภท URL ปลายทาง

การแสดง JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
ช่อง
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

ชุด URL ที่ไม่ตรงกัน รายการนี้มีประเภท URI เดียวหรือหลายประเภทก็ได้

ตัวอย่างที่ 1: [DISPLAY_URL, FINAL_URL] หมายความว่า URL ที่แสดงของโฆษณาไม่ตรงกับ URL สุดท้ายของโฆษณา

ตัวอย่างที่ 2: [FINAL_URL] หมายความว่า URL สุดท้ายของโฆษณาไม่ตรงกับ URL ที่ทำการ Crawl ซึ่งถือว่าปลายทางไม่สอดคล้องกันด้วย

AdPolicyTopicEvidenceDestinationMismatchUrlType

ประเภท URL ที่เป็นไปได้

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN ไม่ได้ระบุหรือไม่ทราบ
DISPLAY_URL URL ที่แสดง
FINAL_URL URL สุดท้าย
FINAL_MOBILE_URL URL สุดท้ายบนมือถือ
TRACKING_URL URL ติดตาม
MOBILE_TRACKING_URL URL ติดตามผลบนอุปกรณ์เคลื่อนที่

DestinationNotWorking

รายละเอียดข้อผิดพลาด HTTP หรือ DNS ที่เกี่ยวข้องกับปลายทางของโฆษณา

การแสดง JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
ช่อง
expandedUri

string

URL แบบเต็มที่ใช้งานไม่ได้
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

อุปกรณ์ที่การเข้าชม URL ทำให้เกิดข้อผิดพลาด
lastCheckedTime

string (Timestamp format)

ครั้งล่าสุดที่พบข้อผิดพลาดเมื่อไปยัง URL

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
ข้อผิดพลาด HTTP หรือ DNS ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

ประเภทข้อผิดพลาด DNS
httpErrorCode

string (int64 format)

รหัสข้อผิดพลาด HTTP
สิ้นสุดฟิลด์ที่แยกกัน

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

ประเภทข้อผิดพลาด DNS ที่เป็นไปได้

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN ไม่ได้ระบุหรือไม่ทราบ
HOSTNAME_NOT_FOUND ไม่พบชื่อโฮสต์ใน DNS เมื่อดึงข้อมูลหน้า Landing Page
GOOGLE_CRAWLER_DNS_ISSUE Google ทำการ Crawl หน้า Landing Page ไม่ได้เมื่อสื่อสารกับ DNS

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

อุปกรณ์ที่อาจพบข้อผิดพลาดเมื่อเข้าชม URL

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN ไม่ได้ระบุหรือไม่ทราบ
DESKTOP อุปกรณ์เดสก์ท็อป
ANDROID อุปกรณ์ Android
IOS อุปกรณ์ iOS

เครื่องหมายการค้า

คำที่เป็นเครื่องหมายการค้าซึ่งทำให้เกิดการละเมิดนโยบาย

การแสดง JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
ช่อง
owner

string

เจ้าของเนื้อหาเครื่องหมายการค้า
term

string

คำที่ใช้ในเครื่องหมายการค้า
countryRestrictions[]

object (AdPolicyCriterionRestriction)

ประเทศที่การละเมิดนโยบายเกี่ยวข้อง

AdPolicyCriterionRestriction

แสดงถึงการจำกัดประเทศ

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

string (int64 format)

รหัสเกณฑ์ประเทศ
countryLabel

string

ชื่อที่แปลแล้วสำหรับประเทศ อาจว่างเปล่า

LegalRemoval

การบังคับใช้กฎระเบียบที่เกี่ยวข้องกับกฎหมาย ไม่ว่าจะเป็นจาก DMCA หรือกฎระเบียบทางกฎหมายในท้องถิ่น

การแสดง JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
ช่อง
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

ประเภทการร้องเรียนที่ทำให้มีการนำออกตามกฎหมาย
countryRestrictions[]

object (AdPolicyCriterionRestriction)

ประเทศที่ถูกจำกัดเนื่องจากการนำออกตามกฎหมาย
restrictedUris[]

string

URL ที่ถูกจำกัดเนื่องจากการนำออกตามกฎหมาย
รายละเอียดเกี่ยวกับประเภทของการนำออกตามกฎหมาย ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
dmca

object (Dmca)

รายละเอียดเกี่ยวกับการนำออกตามกฎหมายตามกฎระเบียบของ DMCA
สิ้นสุดฟิลด์ที่แยกกัน

Dmca

รายละเอียดการร้องเรียน DMCA

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

string

นิติบุคคลที่ยื่นเรื่องร้องเรียนทางกฎหมาย

LocalLegal

รายละเอียดกฎระเบียบทางกฎหมายในท้องถิ่น

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

string

ประเภทกฎหมายสำหรับหนังสือแจ้ง

AdPolicyTopicEvidenceLegalRemovalComplaintType

ประเภทการร้องเรียนที่อาจเกิดขึ้นสำหรับการนำออกตามกฎหมาย

Enum
COPYRIGHT

ลิขสิทธิ์

มีผลกับ DMCA เท่านั้น
COURT_ORDER

คำสั่งศาล

มีผลกับกฎหมายท้องถิ่นเท่านั้น

การลอกเลียนแบบ

รายละเอียดเกี่ยวกับการบังคับใช้การลอกเลียนแบบที่ทําให้เกิดการละเมิดนโยบาย

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

string

เจ้าของเนื้อหาหรือผลิตภัณฑ์ที่ยื่นเรื่องร้องเรียน

RegionalRequirements

การบังคับใช้เชิงรุกด้านความน่าเชื่อถือและความปลอดภัย (T&S) สำหรับนโยบายที่มุ่งตอบสนองข้อกำหนดในภูมิภาค การดำเนินการนี้ถือเป็นการตรวจสอบที่ Google เป็นเจ้าของแทนที่จะเป็นประกาศเรื่องกฎระเบียบ เนื่องจากเป็นการบังคับใช้ T&S เชิงรุก

การแสดง JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
ช่อง
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

รายการข้อกำหนดระดับภูมิภาค

RegionalRequirementsEntry

รายละเอียดการละเมิดกฎหมายระดับภูมิภาคในระดับนโยบาย

การแสดง JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
ช่อง
legalPolicy

string

นโยบายทางกฎหมายที่ถูกละเมิด
countryRestrictions[]

object (AdPolicyCriterionRestriction)

ประเทศที่ถูกจำกัดเนื่องจากนโยบายทางกฎหมาย

AdPolicyTopicConstraint

รายละเอียดเกี่ยวกับข้อจำกัดในการแสดงโฆษณา

การแสดง JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
ช่อง
ข้อจำกัดการแสดงโฆษณา ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
countryConstraint

object (AdPolicyCountryConstraintList)

ประเทศที่โฆษณาแสดงไม่ได้
resellerConstraint

object (AdPolicyResellerConstraint)

ข้อจำกัดของตัวแทนจำหน่าย
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

ประเทศที่ต้องมีใบรับรองจึงจะแสดงโฆษณาได้
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

ประเทศที่โดเมนของทรัพยากรไม่ได้อยู่ภายใต้ใบรับรองที่เชื่อมโยงกับทรัพยากรนั้น
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

ต้องมีใบรับรองเพื่อแสดงในทุกประเทศ
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

ต้องมีใบรับรองเพื่อแสดงโฆษณาในทุกประเทศ และใบรับรองที่มีอยู่ไม่ครอบคลุมโดเมนของโฆษณา
สิ้นสุดฟิลด์ที่แยกกัน

AdPolicyCountryConstraintList

รายชื่อประเทศที่โฆษณาแสดงไม่ได้เนื่องจากข้อจำกัดด้านนโยบาย

การแสดง JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
ช่อง
countries[]

object (AdPolicyCriterionRestriction)

ประเทศที่โฆษณาแสดงไม่ได้

AdPolicyResellerConstraint

ประเภทนี้ไม่มีฟิลด์

หัวข้อนโยบายถูกจำกัดเนื่องจากเว็บไซต์ไม่ได้รับอนุมัติเพื่อวัตถุประสงค์ในการเป็นตัวแทนจำหน่าย

AdPolicyGlobalCertificateMissingConstraint

ประเภทนี้ไม่มีฟิลด์

ต้องมีใบรับรองเพื่อแสดงในทุกประเทศ

AdPolicyGlobalCertificateDomainMismatchConstraint

ประเภทนี้ไม่มีฟิลด์

ต้องมีใบรับรองเพื่อแสดงโฆษณาในทุกประเทศ และใบรับรองที่มีอยู่ไม่ครอบคลุมโดเมนของโฆษณา

AdPolicyTopicAppealInfo

ข้อมูลเกี่ยวกับวิธีอุทธรณ์คำตัดสินเกี่ยวกับนโยบาย

การแสดง JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
ช่อง
appealType

enum (AdPolicyAppealType)

ไม่ว่าคุณจะอุทธรณ์คำตัดสินผ่านการอุทธรณ์แบบบริการตนเองหรือแบบฟอร์มอุทธรณ์ได้หรือไม่

AdPolicyAppealType

ประเภทการอุทธรณ์ที่เป็นไปได้

Enum
AD_POLICY_APPEAL_TYPE_UNKNOWN ไม่ทราบหรือไม่ระบุ
SELF_SERVICE_APPEAL คุณสามารถอุทธรณ์คำตัดสินผ่านการอุทธรณ์ด้วยตนเอง
APPEAL_FORM คุณอุทธรณ์คำตัดสินได้โดยใช้แบบฟอร์มอุทธรณ์

AdUrl

URL เพิ่มเติมที่เกี่ยวข้องกับโฆษณา รวมถึงบีคอน

การแสดง JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
ช่อง
type

enum (AdUrlType)

ประเภทของ URL โฆษณา
url

string

ค่าสตริง URL

AdUrlType

ประเภท URL ของโฆษณาที่เป็นไปได้

Enum
AD_URL_TYPE_UNSPECIFIED ไม่ทราบหรือไม่ระบุ
AD_URL_TYPE_BEACON_IMPRESSION พิกเซลการติดตามขนาด 1x1 เพื่อส่ง Ping เมื่อมีการแสดงผลครีเอทีฟโฆษณา
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION บีคอนการแสดงผล DCM ที่ขยายได้ เมื่อถึงเวลาแสดงโฆษณา ระบบจะขยายโฆษณาไปยังบีคอนหลายตัว
AD_URL_TYPE_BEACON_CLICK URL ติดตามที่จะปิงเมื่อทริกเกอร์กิจกรรมการคลิก
AD_URL_TYPE_BEACON_SKIP URL ติดตามที่จะปิงเมื่อมีการทริกเกอร์เหตุการณ์ข้าม

DcmTrackingInfo

รายละเอียดเกี่ยวกับการติดตาม DCM

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

string (int64 format)

ต้องระบุ รหัสตำแหน่งโฆษณา DCM
trackingAdId

string (int64 format)

ต้องระบุ รหัสโฆษณาเพื่อการติดตามของ DCM
creativeId

string (int64 format)

ต้องระบุ รหัสครีเอทีฟโฆษณา DCM

เมธอด

create

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

delete

 ลบโฆษณาของกลุ่มโฆษณา

get

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

list

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

patch

 อัปเดตโฆษณาของกลุ่มโฆษณา