โฆษณา

ออบเจ็กต์พื้นฐานที่โฆษณา เช่น โฆษณาแบบข้อความที่ขยายแล้วจะมาจาก

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

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

หมายเหตุ

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

วิธี

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

applyLabel(ชื่อสตริง)

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

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

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

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

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

asType

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

กลับ

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

เปิด

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

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

getAdGroup

รับกลุ่มโฆษณาที่มีโฆษณานี้อยู่

กลับ

ชนิด	คำอธิบาย
AdGroup	กลุ่มโฆษณาที่มีโฆษณานี้อยู่

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 .

เปิดใช้งาน

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

กลับ

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

isMobilePreferred

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

กลับ

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

isPaused

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

กลับ

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

isType

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

กลับ

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

ป้าย ชื่อ

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

กลับ

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

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

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

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

เอา

นําโฆษณานี้ออก

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

removeLabel(ชื่อสตริง)

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

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

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

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

Url

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

กลับ

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

ดูเพิ่มเติม

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