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)
  },

  // Union field ad_details can be only one of the following:
  "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 list of possible types for union field ad_details.
}
ช่อง
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 ออก โปรดปล่อยช่องนี้ว่างไว้
ฟิลด์ Union ad_details รายละเอียดของโฆษณา ad_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

เอาต์พุตเท่านั้น รายละเอียดของโฆษณาวิดีโอในสตรีมแบบ Shorts แบบข้ามไม่ได้ที่มีความยาวระหว่าง 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

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 
{

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
ช่อง
ฟิลด์ Union value หลักฐานประกอบคำตัดสินเกี่ยวกับนโยบาย value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
ช่อง
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"
ฟิลด์ Union reason ข้อผิดพลาด HTTP หรือ DNS reason ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
ช่อง
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

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

object (AdPolicyCriterionRestriction)

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

string

URL ที่ถูกจำกัดเนื่องจากการนำออกตามกฎหมาย
ฟิลด์ Union type รายละเอียดเกี่ยวกับประเภทของการนำออกตามกฎหมาย type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
ช่อง
ฟิลด์ Union constraint ข้อจำกัดการแสดงโฆษณา constraint ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 คุณอุทธรณ์การตัดสินได้โดยใช้แบบฟอร์มคำร้อง

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

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

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

string

รายการคำอธิบายที่แสดงในแบนเนอร์คำกระตุ้นให้ดำเนินการ
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 ที่แสดง

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 ติดตามที่จะใช้คำสั่ง 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

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