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

  // 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)
  }
  // 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 ที่โฆษณาใช้

ฟิลด์ 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)

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

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)
}
ช่อง
id

string

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

enum (VideoUnavailableReason)

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

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
}
ช่อง
mimeType

string

ประเภท MIME ของชิ้นงานรูปภาพ
fullSize

object (Dimensions)

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

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

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

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

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 เมื่อมีการทริกเกอร์เหตุการณ์ข้าม

เมธอด

get

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

list

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