คำแนะนำวิธีใช้

หน้านี้มีรายละเอียดเกี่ยวกับวิธีทำงานทั่วไปโดยใช้ API

การสร้างผู้ใช้

UserService ช่วยให้ผู้ใช้ที่มีสิทธิ์ระดับผู้ดูแลระบบสร้างผู้ใช้ได้โดยตรงในเครือข่ายของตน นักพัฒนาแอปทุกรายจะทำได้โดยไม่ต้องให้ผู้ใช้ใหม่ลงชื่อสมัครใช้ก่อน เช่น หากลองใช้ API เป็นครั้งแรก แทนที่จะเรียกใช้ API ทุกครั้งในฐานะผู้ดูแลระบบ (ค่าเริ่มต้นสำหรับอีเมลของคุณ) คุณอาจต้องการสร้างผู้ใช้ 2-3 รายที่มีบทบาท เช่น พนักงานขาย ผู้ดูแลการแสดงโฆษณา หรือผู้ลงโฆษณา เพื่อทดสอบเวิร์กโฟลว์ในชีวิตจริง

1. สร้างที่อยู่ Gmail ใหม่ เช่น [e-mail] หรือจะลงทะเบียนอีเมลที่มีอยู่ซึ่งไม่ใช่ Gmail เป็นบัญชี Google ใหม่ก็ได้
2. โทรหา createUsers ด้วยอีเมลใหม่และ Role ที่เลือกไว้
3. คุณสามารถตรวจสอบสิทธิ์ในฐานะผู้ใช้ใหม่ได้โดยใช้ OAuth 2.0 เพื่อสร้างโทเค็นเพื่อการเข้าถึง

การรับหน่วยโฆษณาระดับรูท

ทั้ง AdUnit ระดับบนสุดที่คุณสามารถเพิ่มโหนดย่อยและระดับความลึกของลำดับชั้นที่ได้รับอนุญาตได้จะขึ้นอยู่กับประเภทบัญชี (ธุรกิจขนาดเล็กหรือพรีเมียม) AdUnit ระดับบนสุดที่รองรับการแก้ไขโหนดย่อยจะเรียกว่า AdUnit รูทที่มีประสิทธิภาพ

หากต้องการเรียกรากที่มีประสิทธิภาพ ให้เรียก NetworkService.getCurrentNetwork() และตรวจสอบช่อง effectiveRootAdUnitId ในออบเจ็กต์ Network ที่แสดงผล

หมายเหตุ: บัญชีประเภทต่างๆ จะรองรับรูปแบบลำดับชั้นที่ต่างกัน

การค้นหาออบเจ็กต์

คุณค้นหาออบเจ็กต์ตามเกณฑ์การค้นหาโดยใช้เมธอด getObjectsByStatement() ที่บริการจำนวนมากแสดง โดยที่ Object เป็นออบเจ็กต์ประเภทที่เฉพาะเจาะจง เมธอดนี้ใช้การค้นหา PQL ซึ่งคล้ายกับการค้นหา SQL ตรงที่ให้คุณระบุช่องที่จะค้นหา (โดยที่ชื่อช่องจะแมปกับพร็อพเพอร์ตี้บนออบเจ็กต์) จัดเรียง จำกัด และออฟเซ็ตผลการค้นหา ดูคู่มือ PQL เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับ PQL และศึกษาช่องออบเจ็กต์ที่ใช้กรองได้

การสร้างคำสั่งซื้อ

หากต้องการสร้างคำสั่งซื้อ เพียงสร้างออบเจ็กต์ Order และตั้งค่ารหัสผู้ลงโฆษณา พนักงานขาย และผู้ดูแลการแสดงโฆษณาแก่ผู้ใช้ที่เหมาะสม ตั้งชื่อที่ไม่ซ้ำกัน และเรียก createOrders() ผลลัพธ์จะรวม Order ที่สร้างขึ้นใหม่ หรือข้อผิดพลาด

ตัวอย่าง

ดูตัวอย่างโค้ด Java สำหรับสร้างคำสั่งซื้อ

การสร้างรายการโฆษณา

ต่อไปนี้เป็นขั้นตอนในการสร้างรายการโฆษณาใหม่

1. สร้างออบเจ็กต์ Order ใหม่หรือใช้ออบเจ็กต์ที่มีอยู่
2. สร้างออบเจ็กต์ LineItem ใหม่ และตั้งค่าประเภทการหมุนเวียน อาร์เรย์ขนาดโฆษณา วันที่เริ่มต้นและสิ้นสุด และพร็อพเพอร์ตี้อื่นๆ
3. สร้างออบเจ็กต์ InventoryTargeting ใหม่และระบุออบเจ็กต์ Placement หรือ AdUnit ที่จะกำหนดเป้าหมายหรือยกเว้น
4. รวมออบเจ็กต์ InventoryTargeting ไว้ในออบเจ็กต์ Targeting ใหม่ แล้วมอบหมายให้กับพร็อพเพอร์ตี้การกำหนดเป้าหมายของ LineItem
5. เรียกใช้เมธอดบริการรายการโฆษณา createLineItems() ด้วยออบเจ็กต์ใหม่ และตรวจสอบผลลัพธ์เพื่อดูว่ามีการสร้างออบเจ็กต์ขึ้นหรือไม่

ตัวอย่าง

ดูตัวอย่างโค้ด Java สำหรับสร้างรายการโฆษณา

การสร้างครีเอทีฟโฆษณา

ครีเอทีฟโฆษณาประเภทต่างๆ จะรองรับคอมโพเนนต์ที่ต่างกันด้วย เช่น ครีเอทีฟโฆษณาแบบรูปภาพรองรับไฟล์ต้นฉบับรายการเดียวสำหรับรูปภาพ ครีเอทีฟโฆษณาแบบ Flash รองรับไฟล์ชิ้นงานสำคัญ 2 ไฟล์ ได้แก่ ไฟล์ Flash และไฟล์ภาพสำรอง ในกรณีที่แสดงไฟล์ Flash ไม่ได้ สำหรับโฆษณาที่โฮสต์บนเว็บไซต์ของบุคคลที่สาม คุณจะอัปโหลดเฉพาะข้อมูลโค้ด HTML ที่อ้างอิงไฟล์บนเซิร์ฟเวอร์ของบุคคลที่สามเท่านั้น โปรดดูคลาสย่อย Creative ที่เจาะจงสำหรับดูว่าชิ้นงานใดบ้างที่จะต้องอัปโหลดเพื่อสร้างครีเอทีฟโฆษณา

ตัวอย่าง

ดูตัวอย่างโค้ด Java สำหรับการสร้างครีเอทีฟโฆษณาแบบรูปภาพ

การแก้ไขออบเจ็กต์ที่มีอยู่

หากต้องการแก้ไขออบเจ็กต์ที่มีอยู่ ให้ค้นหาออบเจ็กต์โดยการเรียกใช้ getObjectsByStatement() อัปเดตค่าในออบเจ็กต์ที่แสดงผล แล้วเรียกใช้ updateObjects()

หมายเหตุ: ออบเจ็กต์ที่อัปเดตจะแทนที่ออบเจ็กต์ที่มีอยู่โดยสมบูรณ์ ดังนั้นหากคุณไม่กำหนดค่าพร็อพเพอร์ตี้ในออบเจ็กต์ที่คุณส่ง ออบเจ็กต์ที่บันทึกไว้จะได้รับค่าเริ่มต้นของพร็อพเพอร์ตี้นั้น ไม่ใช่ค่าก่อนหน้า

การเปลี่ยนสถานะออบเจ็กต์

สถานะของออบเจ็กต์เปลี่ยนแปลงโดยการเรียกใช้เมธอด performObjectAction() ที่บริการของคุณแสดง เมธอดนี้ใช้พารามิเตอร์ 2 ตัว ได้แก่

• อินสแตนซ์ของออบเจ็กต์การดำเนินการที่อธิบายสิ่งที่คุณต้องการทำ ตัวอย่างเช่น บริการสั่งซื้อแสดงการดำเนินการหลายอย่าง เช่น ApproveOrders, PauseOrders และ ArchiveOrders ออบเจ็กต์การดำเนินการทั้งหมดมาจากคลาสการดำเนินการพื้นฐานที่เหมาะกับบริการของคุณ
• การค้นหา PQL ที่อธิบายออบเจ็กต์ที่ต้องเปลี่ยนแปลง คุณเปลี่ยนสถานะของออบเจ็กต์ได้ครั้งละอย่างน้อย 1 รายการโดยการระบุคำสั่ง PQL ที่เหมาะสม

การสร้างแท็กโฆษณา

คุณไม่สามารถสร้างแท็กโฆษณาโดยใช้ API ได้ แต่ต้องใช้เว็บไซต์ Google Ad Manager แทน ดูข้อมูลเพิ่มเติมได้ที่ส่วนการติดแท็ก ในศูนย์ช่วยเหลือ

ตัวอย่างเพิ่มเติม

ดูตัวอย่างอีกมากมายได้ในโค้ดตัวอย่างของไลบรารีไคลเอ็นต์ในภาษาโปรแกรมต่างๆ ดูหน้าไลบรารีไคลเอ็นต์และโค้ดตัวอย่าง สำหรับลิงก์ไปยังตัวอย่างในภาษาโปรแกรมของคุณ