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)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // 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

หากต้องการนำข้อมูลโฆษณาเพื่อการติดตาม DCM ออก โปรดปล่อยช่องนี้ว่างไว้
containsSyntheticMedia

boolean

ไม่บังคับ ระบุว่าโฆษณามีสื่อที่มีการดัดแปลงหรือสังเคราะห์หรือไม่

ควรตั้งค่าสำหรับโฆษณาที่สร้างโดยผู้ลงโฆษณาเกี่ยวกับการเลือกตั้งที่ได้รับการยืนยันเท่านั้น ใช้ได้กับโฆษณา YouTube เท่านั้น
parentCreativeId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของครีเอทีฟโฆษณา Display & Video 360 ที่ใช้สร้างโฆษณานี้

ระบบจะป้อนข้อมูลในช่องนี้สำหรับโฆษณาที่สร้างจากครีเอทีฟโฆษณาที่กำหนดให้กับกลุ่มโฆษณาหลักเท่านั้น
รายละเอียดของโฆษณา ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
ช่อง
displayUrl

string

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

string

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

string

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

ใน v4 และเวอร์ชันก่อนหน้า ช่องนี้แสดง URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง ซึ่งดูได้ที่ userSpecifiedTrackingUrl ใน v5
userSpecifiedTrackingUrl

string

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

string

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

ต้องตั้งค่าหากตั้งค่า actionHeadline ไว้
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,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
ช่อง
displayUrl

string

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

string

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

string

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

ใน v4 และเวอร์ชันก่อนหน้า ช่องนี้แสดง URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง ซึ่งดูได้ที่ userSpecifiedTrackingUrl ใน v5
userSpecifiedTrackingUrl

string

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

object (YoutubeVideoDetails)

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

VideoDiscoveryAd

รายละเอียดสำหรับโฆษณาวิดีโอ 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)

ภาพขนาดย่อที่ใช้ในโฆษณา

ภาพขนาดย่อ

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

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

VideoPerformanceAd

รายละเอียดของโฆษณาวิดีโอที่มีการวัดประสิทธิภาพ

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

string

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

string

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

ใน v4 และเวอร์ชันก่อนหน้า ช่องนี้แสดง URL ติดตามที่ผู้ใช้ระบุด้วยตนเอง ซึ่งดูได้ที่ userSpecifiedTrackingUrl ใน v5
userSpecifiedTrackingUrl

string

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

string

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

ต้องตั้งค่าหากตั้งค่า headlines ไว้
headlines[]

string

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

string

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

ต้องตั้งค่า เว้นแต่ว่า lineItemType ของรายการโฆษณาหลักจะเป็น LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE ซึ่งในกรณีนี้จะตั้งค่าช่องนี้ไม่ได้
descriptions[]

string

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

ต้องตั้งค่า เว้นแต่ว่า lineItemType ของรายการโฆษณาหลักจะเป็น LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE ซึ่งในกรณีนี้จะตั้งค่าช่องนี้ไม่ได้
displayUrlBreadcrumb1

string

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

string

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

ตั้งค่าได้ก็ต่อเมื่อตั้งค่า displayUrlBreadcrumb1 ไว้ด้วยเท่านั้น
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)

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

string

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

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

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

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

ตัวอย่างเช่น "TRADEMARKS", "ALCOHOL" เป็นต้น
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 สุดท้ายของโฆษณาไม่ตรงกับ Crawl URL ซึ่งถือว่าปลายทางไม่สอดคล้องกันด้วย

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 เป็นเจ้าของแทนที่จะเป็นการแจ้งเตือนเกี่ยวกับกฎระเบียบ เนื่องจากเป็นการบังคับใช้ข้อกำหนดและบริการเชิงรุก

การแสดง 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 ติดตามที่จะส่งคําสั่ง ping เมื่อมีการเรียกกิจกรรมการคลิก
AD_URL_TYPE_BEACON_SKIP URL ติดตามที่จะส่งคําสั่ง ping เมื่อมีการทริกเกอร์เหตุการณ์การข้าม

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

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