หน้านี้มีรายละเอียดเกี่ยวกับวิธีดำเนินงานทั่วไปโดยใช้ API
การสร้างผู้ใช้
UserService อนุญาตให้ ผู้ใช้ที่มีสิทธิ์ระดับผู้ดูแลระบบในการ สร้าง ผู้ใช้ในเครือข่ายของตนโดยตรง นักพัฒนาซอฟต์แวร์ทุกคนสามารถทำได้โดยไม่มี ให้ผู้ใช้รายใหม่ลงชื่อสมัครใช้ก่อน ตัวอย่างเช่น ถ้าคุณกำลังทดลองใช้ API สำหรับ เป็นครั้งแรก แทนการเรียกใช้ API ทุกครั้งในฐานะผู้ดูแลระบบ (ค่าเริ่มต้น สำหรับที่อยู่อีเมลของคุณ) คุณอาจต้องการสร้างผู้ใช้ 2-3 รายที่มีบทบาท เช่น พนักงานขาย ผู้ดูแลการแสดงโฆษณา หรือผู้ลงโฆษณาเพื่อทดสอบเวิร์กโฟลว์ที่ทำงานจริง
- สร้างที่อยู่ Gmail ใหม่ เช่น
my.name.salesperson@gmail.comหรือ ลงทะเบียนที่อยู่ปัจจุบันที่ไม่ใช่ Gmail เป็นที่อยู่ใหม่ บัญชี Google - โทรหา
createUsersด้วยที่อยู่ใหม่และRoleที่เลือก - คุณสามารถตรวจสอบสิทธิ์ในฐานะผู้ใช้ใหม่ได้โดยใช้ OAuth 2.0 เพื่อสร้างโทเค็นเพื่อการเข้าถึง
การรับหน่วยโฆษณาระดับรูท
ทั้ง AdUnit ระดับบนสุดที่คุณสามารถเพิ่มโหนดย่อยได้และความลึกที่ได้รับอนุญาตของลำดับชั้นจะขึ้นอยู่กับประเภทบัญชี (ธุรกิจขนาดเล็กหรือพรีเมียม) AdUnit ระดับบนสุดที่รองรับการแก้ไขโหนดย่อยจะเรียกว่า AdUnit รากที่มีประสิทธิภาพ
หากต้องการเรียกรูทที่มีผล ให้เรียกใช้ NetworkService.getCurrentNetwork() และตรวจสอบช่อง effectiveRootAdUnitId ในออบเจ็กต์ Network ที่แสดงผล
หมายเหตุ: บัญชีประเภทต่างๆ รองรับรูปแบบลำดับชั้นที่แตกต่างกัน
การค้นหาออบเจ็กต์
คุณค้นหาวัตถุตามเกณฑ์การค้นหาโดยใช้เมธอด getObjectsByStatement()
เปิดเผยโดยบริการจำนวนมาก โดยที่ Object เป็นประเภทออบเจ็กต์ที่เฉพาะเจาะจง ช่วงเวลานี้
จะใช้ข้อความค้นหา PQL ซึ่งคล้ายกับการค้นหา SQL ที่อนุญาตให้คุณระบุ
ช่องที่ต้องการค้นหา (ซึ่งชื่อช่องจับคู่กับคุณสมบัติในออบเจ็กต์) จัดเรียง
จำกัด และชดเชยผลการค้นหา โปรดดู PQL
คำแนะนำสำหรับข้อมูลเพิ่มเติมเกี่ยวกับ PQL รวมถึงเรียนรู้เกี่ยวกับช่องออบเจ็กต์ที่คุณ
กรองตาม
การสร้างคำสั่งซื้อ
หากต้องการสร้างคำสั่งซื้อ ก็เพียงสร้างออบเจ็กต์ Order และตั้งค่าผู้ลงโฆษณา
ของพนักงานขาย และผู้ดูแลการแสดงโฆษณา
ให้กับผู้ใช้ที่เหมาะสม กำหนดชื่อที่ไม่ซ้ำ
และโทรหา createOrders() ผลลัพธ์จะมี Order ที่สร้างขึ้นใหม่
หรือข้อผิดพลาด
ตัวอย่าง
ดูตัวอย่างโค้ด Java สำหรับสร้างคำสั่งซื้อ
การสร้างรายการโฆษณา
ขั้นตอนในการสร้างรายการโฆษณาใหม่มีดังนี้
- สร้างออบเจ็กต์
Orderใหม่หรือใช้ออบเจ็กต์ที่มีอยู่ - สร้างออบเจ็กต์
LineItemใหม่ และตั้งค่าประเภทการหมุน อาร์เรย์ขนาดโฆษณา วันที่เริ่มต้นและวันที่สิ้นสุด รวมถึงพร็อพเพอร์ตี้อื่นๆ - สร้างออบเจ็กต์
InventoryTargetingใหม่และระบุออบเจ็กต์PlacementหรือAdUnitที่จะกำหนดเป้าหมายหรือยกเว้น - รวมออบเจ็กต์
InventoryTargetingไว้ในออบเจ็กต์Targetingใหม่ และกำหนด ลงในพร็อพเพอร์ตี้การกำหนดเป้าหมายของLineItem - เรียกเมธอดบริการรายการโฆษณา
createLineItems()ด้วยออบเจ็กต์ใหม่ และตรวจสอบผลลัพธ์เพื่อดูว่ามีการสร้างออบเจ็กต์ของคุณหรือไม่
ตัวอย่าง
ดูตัวอย่างโค้ด Java สำหรับสร้างรายการโฆษณา
การสร้างครีเอทีฟโฆษณา
ครีเอทีฟโฆษณาประเภทต่างๆ รองรับคอมโพเนนต์ที่ต่างกัน เช่น รูปภาพ
โฆษณาสนับสนุนไฟล์ต้นฉบับเดียวสำหรับรูปภาพ ที่ครีเอทีฟโฆษณา Flash สนับสนุน
ไฟล์เนื้อหาที่สำคัญ 2 ไฟล์ ได้แก่ ไฟล์ Flash และไฟล์ภาพสำรองในกรณีที่ Flash
แสดงผลไม่ได้ สำหรับโฆษณาที่โฮสต์บนเว็บไซต์ของบุคคลที่สาม คุณจะอัปโหลด
เฉพาะข้อมูลโค้ด HTML ที่อ้างอิงไฟล์ในเซิร์ฟเวอร์ของบุคคลที่สามเท่านั้น ดู
คลาสย่อย Creative ที่เจาะจงเพื่อดูชิ้นงานซึ่งจะต้องอัปโหลดตามลำดับ
ในการสร้างครีเอทีฟโฆษณา
ตัวอย่าง
ดูตัวอย่างโค้ด Java สำหรับการสร้างครีเอทีฟโฆษณาแบบรูปภาพ
การแก้ไขออบเจ็กต์ที่มีอยู่
หากต้องการแก้ไขออบเจ็กต์ที่มีอยู่ ให้ค้นหาออบเจ็กต์ของคุณโดยเรียกใช้ getObjectsByStatement()
อัปเดตค่าในออบเจ็กต์ที่แสดงผล แล้วเรียกใช้ updateObjects()
หมายเหตุ: ออบเจ็กต์ที่อัปเดตจะแทนที่ออบเจ็กต์ที่มีอยู่โดยสมบูรณ์ ดังนั้นหากคุณ หากไม่ตั้งค่าพร็อพเพอร์ตี้ในออบเจ็กต์ที่คุณส่ง ออบเจ็กต์ที่บันทึกไว้ ใช้ค่าเริ่มต้นสำหรับพร็อพเพอร์ตี้นั้น ไม่ใช่ค่าก่อนหน้า
การเปลี่ยนสถานะออบเจ็กต์
สถานะออบเจ็กต์เปลี่ยนแปลงโดยการเรียกใช้เมธอด performObjectAction()
จากบริการของคุณ เมธอดนี้ใช้พารามิเตอร์ 2 ตัว ได้แก่
- อินสแตนซ์ของออบเจ็กต์การดำเนินการที่อธิบายสิ่งที่คุณต้องการทำ สำหรับ
เช่น บริการสั่งซื้อมีการดำเนินการหลายอย่าง เช่น
ApproveOrders,PauseOrdersและArchiveOrdersออบเจ็กต์การดำเนินการทั้งหมดมาจากการดำเนินการพื้นฐาน ที่เหมาะกับบริการของคุณ - การค้นหา PQL ที่อธิบายออบเจ็กต์ที่ต้องเปลี่ยนแปลง คุณสามารถเปลี่ยน สถานะของออบเจ็กต์อย่างน้อย 1 รายการต่อครั้งด้วยการระบุ PQL ที่เหมาะสม ข้อความ
การสร้างแท็กโฆษณา
คุณไม่สามารถสร้างแท็กโฆษณาโดยใช้ API คุณต้องใช้เว็บไซต์ Google Ad Manager แทน โปรดดูการติดแท็ก ศูนย์ช่วยเหลือสำหรับ ข้อมูลเพิ่มเติม
ตัวอย่างเพิ่มเติม
คุณสามารถหาตัวอย่างเพิ่มเติมได้อีกในโค้ดตัวอย่างไลบรารีไคลเอ็นต์ของเราในหลายๆ ภาษาโปรแกรมต่างๆ ดูไลบรารีไคลเอ็นต์และ โค้ดตัวอย่าง สำหรับลิงก์ไปยังตัวอย่างในภาษาโปรแกรมของคุณ