โฆษณา

วัตถุพื้นฐานที่โฆษณา เช่น โฆษณาข้อความขยาย ได้มาจาก

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

• getDestinationUrl()
• getDisplayUrl()
• getHeadline()
• isMobilePreferred()

หมายเหตุ

• อัปเกรดโฆษณาข้อความที่ขยายเป็นโฆษณาการค้นหาที่ตอบสนองภายในวันที่ 1 กุมภาพันธ์ 2023 หลังจากวันที่นี้ คุณจะไม่สามารถสร้างโฆษณาแบบข้อความที่ขยายใหม่หรือแก้ไขโฆษณาแบบข้อความที่ขยายที่มีอยู่ได้อีกต่อไป หากต้องการข้อมูลเพิ่มเติม โปรดดูเกี่ยวกับโฆษณาการค้นหาที่ตอบสนอง
• โฆษณาแบบข้อความที่ขยายที่มีอยู่จะยังคงให้บริการต่อไป และคุณจะสามารถดูรายงานประสิทธิภาพการทํางานของโฆษณาได้
• คุณจะยังคงสามารถหยุดชั่วคราว เปิดใช้งาน หรือลบโฆษณาแบบข้อความที่ขยายออกได้ มิฉะนั้น ความพยายามที่จะเพิ่มหรืออัปเดตโฆษณาแบบข้อความที่ขยายจะส่งผลให้เกิด CampaignServiceAdTypeInvalid ข้อผิดพลาด
• เรียนรู้เพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้

วิธีการ

ชื่อวิธี	ชนิดการส่งคืน	คำอธิบาย
applyLabel(string name)	เป็นโมฆะ	ใช้ป้ายกํากับกับโฆษณานี้
ประเภทตาม	AdViewSpace	ประกอบด้วยวิธีการที่ใช้ในการแคสต์โฆษณานี้ไปยังประเภทโฆษณาที่เฉพาะเจาะจง
เปิดใช้งาน	เป็นโมฆะ	เปิดใช้งานโฆษณานี้
getAdGroup	กลุ่มโฆษณา	รับกลุ่มโฆษณาที่โฆษณานี้เป็นสมาชิก
getCampaign	แคมเปญ	รับแคมเปญของโฆษณานี้
getDescription	สตริง	รับข้อความคัดลอกของโฆษณานี้
getDestinationUrl	สตริง	รับ URL ของเว็บเพจที่ผู้ใช้ถูกนําไปเมื่อพวกเขาคลิกโฆษณา
getDisplayUrl	สตริง	รับ URL ที่แสดงในโฆษณา
getEntityType	สตริง	รับชนิดของเอนทิตีนี้
getHeadline	สตริง	ได้ชื่อของโฆษณานี้
getId	สตริง	รับ ID ที่ระบุโฆษณานี้โดยเฉพาะ
getPolicyApprovalStatus	สตริง	ได้รับสถานะการอนุมัติจากบรรณาธิการของโฆษณานี้
getStats	สถิติ	รับข้อมูลประสิทธิภาพของโฆษณานี้
getType	สตริง	รับประเภทที่ได้รับมาจากโฆษณานี้
isEnabled	บูลีน	รับค่าบูลีนที่ระบุว่าโฆษณานี้เปิดใช้งานหรือไม่
isMobilePreferred	บูลีน	รับค่าบูลีนที่ระบุว่าการกําหนดลักษณะให้โฆษณานี้แสดงบนอุปกรณ์เคลื่อนที่หรือบนอุปกรณ์ทั้งหมด
isPaused	บูลีน	รับค่าบูลีนที่ระบุว่าโฆษณานี้หยุดชั่วคราวหรือไม่
isType	AdTypeSpace	ประกอบด้วยวิธีการที่ใช้ทดสอบว่าโฆษณาเป็นประเภทที่ระบุหรือไม่
ป้ายชื่อ	LabelSelector	ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับที่เกี่ยวข้องกับโฆษณานี้
หยุดชั่วคราว	เป็นโมฆะ	หยุดโฆษณานี้ชั่วคราว
เอาออก	เป็นโมฆะ	ลบโฆษณานี้ออก
removeLabel(string name)	เป็นโมฆะ	ลบป้ายกํากับออกจากโฆษณานี้
URL	AdUrls	ประกอบด้วยวิธีการที่ใช้เพื่อรับ URL สุดท้ายของโฆษณานี้ เทมเพลตการติดตาม และพารามิเตอร์ที่กําหนดเอง

applyLabel(string name)

นําป้ายกํากับไปใช้กับโฆษณา

คุณสามารถใช้ป้ายกํากับได้สูงสุด 50 ป้ายกับโฆษณา สําหรับตัวอย่างที่เพิ่มป้ายชื่อให้กับเอนทิตี ให้ดู การใช้ป้ายชื่อ

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
ชื่อ	สตริง	ชื่อตรงตามตัวพิมพ์ใหญ่-เล็กของป้ายชื่อ หากต้องการดูรายการป้ายกํากับในบัญชีนี้ที่คุณนําไปใช้ได้ ให้ดู AdsApp.labels

ส่งกลับ

พิมพ์	คำอธิบาย
เป็นโมฆะ	ไม่ส่งกลับค่าใดๆ

ประเภทตาม

ประกอบด้วยวิธีการที่ใช้ในการแคสต์โฆษณานี้ไปยังประเภทโฆษณาที่เฉพาะเจาะจง

ส่งกลับ

พิมพ์	คำอธิบาย
AdViewSpace	ประกอบด้วยวิธีการที่ใช้ในการแคสต์โฆษณานี้ไปยังประเภทโฆษณาที่เฉพาะเจาะจง

เปิดใช้งาน

เปิดใช้งานโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
เป็นโมฆะ	ไม่ส่งกลับค่าใดๆ

getAdGroup

รับกลุ่มโฆษณาที่โฆษณานี้เป็นสมาชิก

ส่งกลับ

พิมพ์	คำอธิบาย
กลุ่มโฆษณา	กลุ่มโฆษณาที่โฆษณานี้เป็นสมาชิก

getCampaign

รับแคมเปญของโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
แคมเปญ	แคมเปญที่โฆษณานี้เป็นของแคมเปญ

getDescription

รับข้อความคัดลอกของโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	ข้อความคัดลอกของโฆษณา

getDestinationUrl

รับ URL ของเว็บเพจที่ผู้ใช้ถูกนําไปเมื่อพวกเขาคลิกโฆษณา

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	URL ของเว็บเพจที่ผู้ใช้ถูกนําไปเมื่อพวกเขาคลิกโฆษณา ส่งกลับค่า Null ถ้าเรียกจากวัตถุที่ได้รับ

getDisplayUrl

รับ URL ที่แสดงในโฆษณา

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	URL ที่แสดงในโฆษณา ส่งกลับค่า Null ถ้าเรียกจากวัตถุที่ได้รับ

getEntityType

รับชนิดของเอนทิตีนี้

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	ชนิดของเอนทิตีนี้ ซึ่งก็คือ AD

getHeadline

ได้ชื่อของโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	ชื่อของโฆษณา ส่งกลับค่า Null ถ้าเรียกจากวัตถุที่ได้รับ

getId

รับ ID ที่ระบุโฆษณานี้โดยเฉพาะ

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	ID ที่ระบุโฆษณานี้โดยเฉพาะ

getPolicyApprovalStatus

ได้รับสถานะการอนุมัติจากบรรณาธิการของโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	สถานะการอนุมัติบรรณาธิการของโฆษณา ต่อไปนี้เป็นค่าที่เป็นไปได้ อนุมัติแล้ว APPROVED_LIMITED UNDER_REVIEW ไม่อนุมัติ

getStats

รับข้อมูลประสิทธิภาพของโฆษณานี้

หากต้องการเรียกใช้วิธีนี้ คุณต้องรวมเมธอดใดวิธีการหนึ่งในforDateRangeสายของตัวเลือกโฆษณา

ส่งกลับ

พิมพ์	คำอธิบาย
สถิติ	ข้อมูลประสิทธิภาพการทํางานของโฆษณา

getType

รับประเภทที่ได้รับมาจากโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
สตริง	ประเภทที่ได้รับมาจากโฆษณานี้ ชนิดที่เป็นไปได้มีดังต่อไปนี้ EXPANDED_TEXT_AD .

isEnabled

รับค่าบูลีนที่ระบุว่าโฆษณานี้เปิดใช้งานหรือไม่

ส่งกลับ

พิมพ์	คำอธิบาย
บูลีน	เป็นจริงหากเปิดใช้งานโฆษณานี้ มิฉะนั้น เป็นเท็จ

isMobilePreferred

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

ส่งกลับ

พิมพ์	คำอธิบาย
บูลีน	เป็น จริง หากการกําหนดลักษณะให้โฆษณานี้แสดงบนอุปกรณ์เคลื่อนที่ หากเป็น FALSE การกําหนดลักษณะคือให้โฆษณานี้แสดงบนอุปกรณ์ทั้งหมด

isPaused

รับค่าบูลีนที่ระบุว่าโฆษณานี้หยุดชั่วคราวหรือไม่

ส่งกลับ

พิมพ์	คำอธิบาย
บูลีน	เป็นจริงหากโฆษณานี้หยุดชั่วคราว มิฉะนั้น เป็นเท็จ

isType

ประกอบด้วยวิธีการที่ใช้ทดสอบว่าโฆษณาเป็นประเภทที่ระบุหรือไม่

ส่งกลับ

พิมพ์	คำอธิบาย
AdTypeSpace	ประกอบด้วยวิธีการที่ใช้ทดสอบว่าโฆษณาเป็นประเภทที่ระบุหรือไม่

ป้ายชื่อ

ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับที่เกี่ยวข้องกับโฆษณานี้

ส่งกลับ

พิมพ์	คำอธิบาย
LabelSelector	ตัวเลือกที่ใช้ในการกรองรายการป้ายกํากับที่เกี่ยวข้องกับโฆษณานี้

หยุดชั่วคราว

หยุดโฆษณานี้ชั่วคราว

ส่งกลับ

พิมพ์	คำอธิบาย
เป็นโมฆะ	ไม่ส่งกลับค่าใดๆ

เอาออก

ลบโฆษณานี้ออก

ส่งกลับ

พิมพ์	คำอธิบาย
เป็นโมฆะ	ไม่ส่งกลับค่าใดๆ

removeLabel(string name)

ลบป้ายกํากับออกจากโฆษณา

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
ชื่อ	สตริง	ชื่อตรงตามตัวพิมพ์ใหญ่-เล็กของป้ายชื่อ หากต้องการรับรายการป้ายกํากับที่เกี่ยวข้องกับโฆษณานี้ ให้ดูป้ายกํากับ

ส่งกลับ

พิมพ์	คำอธิบาย
เป็นโมฆะ	ไม่ส่งกลับค่าใดๆ

URL

ประกอบด้วยวิธีการที่ใช้เพื่อรับ URL สุดท้ายของโฆษณานี้ เทมเพลตการติดตาม และพารามิเตอร์ที่กําหนดเอง

ส่งกลับ

พิมพ์	คำอธิบาย
AdUrls	วัตถุที่ใช้รับ URL สุดท้ายของโฆษณานี้ เทมเพลตการติดตาม และพารามิเตอร์ที่กําหนดเอง

ดูเพิ่มเติม

• AdIterator.next()
• AdOperation.getResult()
• ExpandedTextAd